Skip to main content
CORE:G:0001 mechanical high governance core

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 add it. The file works locally but is invisible to other contributors.
  • Adding instruction file paths to .gitignore (e.g., ignoring all .md files 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.