Documentation Drift Report — 2026-05-08

Project: /Users/paulirving/projects/bigbrainRules: /Users/paulirving/projects/bigbrain/scripts/doc-keeper/rules.json

Summary

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

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)

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)

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] cdr is 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)

medium [ambiguous-cdr] cdr is 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] cdr is 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] cdr is 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] cdr is 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)

medium [ambiguous-cdr] cdr is 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)

medium [component-count-hooks] hooks/ count drift: prose says 5, live count is 27 (line 105)