Documentation Drift Report — 2026-05-08
Project: /Users/paulirving/projects/bigbrain
Rules: /Users/paulirving/projects/bigbrain/scripts/doc-keeper/rules.json
Summary
Section titled “Summary”- Aligned: 18
- Needs-update: 6
- Archive: 0
- High-severity findings: 0
| File | Verdict | Findings |
|---|---|---|
CLAUDE.md |
needs-update | medium:component-count-skills, medium:component-count-agents, medium:component-count-hooks |
README.md |
aligned | — |
docs/natural-language-guide.md |
aligned | — |
docs/pm-cheatsheet.md |
aligned | — |
docs/pm-workflows.md |
aligned | — |
docs/project-management-reference.md |
needs-update | medium:component-count-hooks, medium:command-removed-auto-loop |
docs/project-orchestration-handbook.md |
needs-update | medium:component-count-skills, medium:component-count-agents, medium:component-count-hooks, medium:registry-count-skills, medium:registry-count-agents, medium:ambiguous-cdr |
docs/automation-behavior.md |
aligned | — |
docs/backup-recovery.md |
needs-update | medium:ambiguous-cdr, medium:ambiguous-cdr, medium:ambiguous-cdr, medium:ambiguous-cdr |
docs/branch-config.md |
aligned | — |
docs/cdfork-guide.md |
aligned | — |
docs/deploy-skill-prompt.md |
aligned | — |
docs/dev-lifecycle.md |
aligned | — |
docs/how-to-auto-loop.md |
aligned | — |
docs/new-machine-setup.md |
needs-update | medium:ambiguous-cdr |
docs/orchestrator-guide.md |
aligned | — |
docs/pm-conventions.md |
aligned | — |
docs/prime-directive.md |
aligned | — |
docs/project-setup-guide.md |
aligned | — |
docs/research/parallel-agent-orchestration.md |
aligned | — |
docs/token-monitoring.md |
aligned | — |
docs/verification-system.md |
aligned | — |
docs/vision.md |
aligned | — |
docs/warp-drive-guide.md |
needs-update | medium:component-count-hooks |
Findings (per file)
Section titled “Findings (per file)”CLAUDE.md (needs-update)
Section titled “CLAUDE.md (needs-update)”- medium [component-count-skills] skills/ count drift: prose says 13, live count is 16 (line 14)
- medium [component-count-agents] agents/ count drift: prose says 4, live count is 5 (line 16)
- medium [component-count-hooks] hooks/ count drift: prose says 26, live count is 27 (line 18)
docs/project-management-reference.md (needs-update)
Section titled “docs/project-management-reference.md (needs-update)”- medium [component-count-hooks] hooks/ count drift: prose says 14, live count is 27 (line 10)
- medium [command-removed-auto-loop] /auto-loop is deprecated in favor of /warp-drive. Flag references for review. (matched: “/auto-loop”) (line 9)
docs/project-orchestration-handbook.md (needs-update)
Section titled “docs/project-orchestration-handbook.md (needs-update)”- medium [component-count-skills] skills/ count drift: prose says 1, live count is 16 (line 675)
- medium [component-count-agents] agents/ count drift: prose says 1, live count is 5 (line 745)
- medium [component-count-hooks] hooks/ count drift: prose says 1, live count is 27 (line 963)
- medium [registry-count-skills] registry/skills/ count drift: prose says 2, live count is 31 (line 696)
- medium [registry-count-agents] registry/agents/ count drift: prose says 2, live count is 17 (line 754)
- medium [ambiguous-cdr]
cdris ambiguous — both ‘claude disaster recovery’ (current) and a legacy ‘sync requirements index’ alias. Surface every usage so a human can clarify. (matched: “cdr”) (line 162)
docs/backup-recovery.md (needs-update)
Section titled “docs/backup-recovery.md (needs-update)”- medium [ambiguous-cdr]
cdris ambiguous — both ‘claude disaster recovery’ (current) and a legacy ‘sync requirements index’ alias. Surface every usage so a human can clarify. (matched: “cdr”) (line 58) - medium [ambiguous-cdr]
cdris ambiguous — both ‘claude disaster recovery’ (current) and a legacy ‘sync requirements index’ alias. Surface every usage so a human can clarify. (matched: “cdr”) (line 69) - medium [ambiguous-cdr]
cdris ambiguous — both ‘claude disaster recovery’ (current) and a legacy ‘sync requirements index’ alias. Surface every usage so a human can clarify. (matched: “cdr”) (line 69) - medium [ambiguous-cdr]
cdris ambiguous — both ‘claude disaster recovery’ (current) and a legacy ‘sync requirements index’ alias. Surface every usage so a human can clarify. (matched: “cdr”) (line 103)
docs/new-machine-setup.md (needs-update)
Section titled “docs/new-machine-setup.md (needs-update)”- medium [ambiguous-cdr]
cdris ambiguous — both ‘claude disaster recovery’ (current) and a legacy ‘sync requirements index’ alias. Surface every usage so a human can clarify. (matched: “cdr”) (line 59)
docs/warp-drive-guide.md (needs-update)
Section titled “docs/warp-drive-guide.md (needs-update)”- medium [component-count-hooks] hooks/ count drift: prose says 5, live count is 27 (line 105)