Record why we use chezmoi (ADR-0002) - #2
Merged
Conversation
ADR-0002: capture the reasoning for keeping chezmoi despite using only a small slice of it. The deciding factor is managed single-source fan-out — bare-git and symlinks can't fan out, and a build script can but leaves the output untracked. chezmoi is the lightest option that does fan-out and keeps it auditable. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Adds ADR-0002 documenting why this dotfiles repo continues to use chezmoi (rather than a bare git repo, symlinks/Stow, or a custom build script), focusing on the requirement for managed single-source fan-out of shared AI instructions across multiple tool-specific target paths.
Changes:
- Add ADR-0002 describing the “single-source fan-out” requirement and why alternatives were rejected.
- Document operational/auditability reasons (diff/dry-run/preview/cleanup) that favor chezmoi over a build script.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents the decision to keep chezmoi rather than switch to a bare git repo, symlinks/Stow, or a build script.
Came out of a "isn't chezmoi heavy?" question. The audit: the repo uses only the
dot_rename +includeTemplatefan-out — a small, stable slice. But that fan-out is the deciding requirement, and it's the one thing the lighter alternatives can't do well:ADR notes to revisit only if the fan-out requirement disappears (e.g. all tools converge on one shared
AGENTS.md).🤖 Generated with Claude Code