latest

Documentation Drift Report — 2026-05-08

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

Summary

• Aligned: 19
• Needs-update: 6
• Archive: 0
• High-severity findings: 0

Files

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/automation-workflow.txt	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)

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)

• 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)

• 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)

docs/backup-recovery.md (needs-update)

• 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)

docs/new-machine-setup.md (needs-update)

• 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)

docs/warp-drive-guide.md (needs-update)

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