Vcs Tracked
All instruction files must be tracked in git. Untracked instruction files create divergence between collaborators -- each developer's agent sees different instructions.
Antipatterns
- Adding an instruction file but forgetting to
git addit. The file works locally but is invisible to other contributors. - Adding instruction file paths to
.gitignore(e.g., ignoring all.mdfiles in.claude/). Instruction files must be committed, not ignored. - Creating instruction files in directories outside the repository root. Files outside the repo boundary cannot be git-tracked.
Pass / Fail
Pass
$ git ls-files .claude/rules/testing.md
.claude/rules/testing.md
(file is tracked)
Fail
$ git ls-files .claude/rules/testing.md
(no output -- file is not tracked)
Limitations
Verifies a .git directory exists. Does not check that individual instruction files are tracked, committed, or pushed to a remote.
