// Audit every CLAUDE.md in this project for drift against the last week of git history. Flags sections that reference deleted files, renamed paths, or removed dependencies. Read-only — returns a punch list, never edits.
Re-detect this project's tech stack from package.json / requirements.txt / pyproject.toml / go.mod / Cargo.toml and diff it against the Tech Stack section of every CLAUDE.md. Read-only — returns added / removed / renamed dependencies, never edits.
Verify every @path chain import and every markdown link inside every CLAUDE.md in this project resolves to an existing file. Read-only — returns broken links with file:line refs, never edits.
Behavioral guardrails for LLM-assisted coding. Use when writing, reviewing, or refactoring code in any project to avoid overcomplication, keep changes surgical, surface assumptions early, and execute against verifiable success criteria.
Analyzes, generates, and enhances CLAUDE.md files for any project type using best practices, modular architecture support, and tech stack customization. Use when setting up new projects, improving existing CLAUDE.md files, or establishing AI-assisted development standards.
| name | claude-md-drift-audit |
| description | Audit every CLAUDE.md in this project for drift against the last week of git history. Flags sections that reference deleted files, renamed paths, or removed dependencies. Read-only — returns a punch list, never edits. |
| when_to_use | Use when the user asks "is my CLAUDE.md still accurate?", "audit my docs for staleness", "what changed in the last week?", or as part of /sync-claude-md --weekly. |
| argument-hint | [days=7] |
| context | fork |
| agent | Explore |
| allowed-tools | ["Read","Glob","Grep","Bash(git log:*)","Bash(git diff:*)","Bash(git status:*)","Bash(find:*)"] |
| disable-model-invocation | false |
Days window: $ARGUMENTS (default 7 if empty).
Perform these steps in order, then return a single punch-list summary. Do not modify any file.
CLAUDE.md and *.claude/rules/*.md in the tree using find . -name "CLAUDE.md" -type f -not -path "*/.git/*" -not -path "*/node_modules/*". List paths and line counts.git log --since="$ARGUMENTS days ago" --name-status --no-merges --diff-filter=DR → deleted and renamed paths.git diff "@{$ARGUMENTS days ago}" --name-status -- package.json requirements.txt pyproject.toml go.mod Cargo.toml 2>/dev/null → manifest deltas (removed/added deps).grep / Read:
@path/... chain import or markdown link whose target was deleted.## Drift Audit (window: <N> days)
Total CLAUDE.md inspected: <count>
Signals examined: <deleted_paths>, <renamed_paths>, <removed_deps>
### Findings
- <path>:<line> — <one-sentence reason> — suggested action
- ... (one bullet per drift; omit section if empty)
### Clean
- <path> (lines unchanged, references valid)
## Drift Audit\n\nNo drift in <N>-day window. <count> files inspected.. Do not pad the output.