doc-audit

# /doc-audit — Architecture Doc Freshness Audit ## Usage `/doc-audit [group]` — Audit one group thoroughly `/doc-audit` — Audits the group that hasn't been audited longest (check the tracker below) ## Groups 7 groups, 5-12 docs each. Small enough to audit thoroughly. ### boot — Load every session. Staleness here = broken boot. | Doc | What to verify | |-----|---------------| | `SESSION_CONTEXT.md` | **On-demand post-ADR-0009 (S248)** — NOT read at boot. Live span reasonable size (hard close snapshots to `docs/session-context/S<##>.md` + resets to thin header)? STATUS line current? No duplicated content from ROLLOUT? (The old "under 300 lines / last 5 sessions" criterion predates ADR-0009 — it's a span model now, not a rolling-5 file.) | | `CLAUDE.md` | Quick commands still work? Session lifecycle refs current? Rules index matches actual rules files? Wiki-layer reference present and pointing to existing files? Canon files referenced if relevant? | | `docs/mags-corliss/CHARACTER.md` | Identity-only (governance.5 partial close S228): The Principle / Who I Am / My Family / Off the Clock. NO session counter (lives in SESSION_CONTEXT.md line 5). NO infrastructure refs (live in STACK.md / SUPERMEMORY.md). NO Compact Recovery (lives in `.claude/skills/boot/SKILL.md`). Audit: family POPIDs match ledger? No drift back to operational content? | | `.claude/rules/identity.md` | Rules still match actual behavior? No contradictions with CLAUDE.md? | | `.claude/rules/newsroom.md` | Cycle-rule reversal still documented (S146)? Citizen-creation rules current? 2041 birth-year anchor present? | | `.claude/rules/engine.md` | Engine code rules current? Determinism guidance reflects safeRand_ pattern post-S156? | | `.claude/rules/dashboard.md` | Dashboard rules current? Endpoint conventions match server code? | | `MEMORY.md` (auto-memory) | **Under 24.4KB** (S147 limit per CLAUDE.md, NOT 200 lines). Dead memory file references? Stale session memories? Population numbers current? Index entries one-line under ~150 chars? | | `docs/SCHEMA.md` | Folder map matches actual `docs/` layout (now includes `docs/canon/` per S174)? Tag taxonomy reflects what's actually in use? Page types still match what we're creating? Frontmatter example valid YAML? | | `docs/index.md` | Every active `docs/**.md` (excluding `archive/`, `drive-files/`, papers PDFs) appears exactly once? No broken `[[wikilinks]]`? Renamed/deleted files reflected? Folder section headers match SCHEMA folder map? `docs/canon/` and `docs/research/` sections present? | | `docs/canon/CANON_RULES.md` | Three-tier framework intact? Per-agent template still matches what generators use? Reviewer-variant template still matches Rhea/city-clerk/final-arbiter usage? Sports-history carveout (S175) referenced correctly? | | `docs/canon/INSTITUTIONS.md` | Tier-organized; row-statuses (canon/proposed/TBD) tracked? New tier-2 entities surfaced in editions added? Construction/architecture firm rows still TBD or progressed? | | `docs/BOOT_ARCHITECTURE.md` | S165 boot architecture intact? Skill split (boot/session-startup) accurate? Per-terminal persona levels match TERMINAL.md files? | | `docs/POST_MORTEM_C92_CONTAMINATION.md` | Historical record intact? S173 reframe note present (this is the failure that motivated canon/CANON_RULES)? | ### engine — Drift when code changes. | Doc | What to verify | |-----|---------------| | `docs/engine/ROLLOUT_PLAN.md` | Open items — any completed but not marked? Stale priorities? Line count reasonable? Halt banner accuracy (S172)? Off-spine items reflect plan-file status? | | `docs/engine/ENGINE_MAP.md` | Function list matches actual `godWorldEngine2.js` call order? | | `docs/engine/ENGINE_STUB_MAP.md` | Field dependencies — run `node scripts/ctxMap.js` and compare. Auto-regenerated by `/stub-engine`. | | `docs/engine/archive/ENGINE_CONNECTIVITY_ROLLOUT.md` | Phase 34 — 7 of 10 done per S136 audit; verify count current. | | `docs/engine/SHEETS_MANIFEST.md` | Sheet names match actual spreadsheet tabs? | | `docs/engine/PHASE_DATA_AUDIT.md` | ctx.summary fields match current code? | | `docs/engine/archive/REVIEWER_LANE_SCHEMA.md` | Four-field contract (process/outcome/controllable/uncontrollable) still matches what Rhea/cycle-review/Mara/capability emit? Four-quadrant interpretation cross-references PHASE_39_PLAN §17.3? | | `docs/engine/archive/INSTITUTIONAL_VOICE_AGENTS.md` | Voice-agent count + IDENTITY+RULES+SKILL pattern still accurate post-S174 (now IDENTITY+LENS+RULES+SKILL for civic voices)? | | `docs/engine/archive/CYCLE_SEPARATION.md` | S113 architecture notes still relevant given subsequent phases? | | `docs/engine/archive/phase19_agent_personas.md` | Three administrative-agent personas (City Clerk + others) — match current `.claude/agents/` directories? | | `docs/engine/archive/PHASE_24_PLAN.md` | Citizen life engine plan — status updated? Sub-items reflect current progress? | | `docs/engine/archive/PHASE_33_PLAN.md` | RETIRED S299 — frozen for trail; no staleness check. Live remainder is ROLLOUT engine.50. | | `docs/engine/archive/PHASE_38_PLAN.md` | Engine auditor — sub-phases 38.1-38.8 status accurate? Measurement loop (38.5) DONE S156? | | `docs/engine/archive/PHASE_39_PLAN.md` | Reviewer chain — 39.1-39.10 all DONE S148? | | `docs/engine/archive/PHASE_40_PLAN.md` | 5 of 6 done (40.1, 40.3, 40.4, 40.5, 40.6); only 40.2 remains? | | `docs/engine/DOCUMENTATION_LEDGER.md` | **SUNSET-FLAG** — folding into `docs/index.md` per its own header. Audit only for cross-check; do not maintain. | | `docs/engine/LEDGER_HEAT_MAP.md` | **engine-sheet handoff (S156)** — extremely stale C81/S30/2026-02-16. Defer to engine-sheet terminal for refresh. | | `docs/engine/LEDGER_REPAIR.md` | **engine-sheet handoff (S156)** — RECOVERY COMPLETE S94, dating language stale but "DO NOT re-analyze" intact. Audit-light. | | `docs/engine/LEDGER_AUDIT.md` | **engine-sheet handoff (S156)** — pre-recovery counts (658/639) stale. Defer. | | `docs/engine/ROLLOUT_ARCHIVE.md` | Frozen archive — read on demand only; verify no active items leaked back in. | ### media — Drift when pipeline or reporters change. | Doc | What to verify | |-----|---------------| | `docs/EDITION_PIPELINE.md` | Terminal count, step count, reporter list, civic voice list match current skill files? Inputs table current? Post-S174 four-file agent structure reflected? | | `docs/EDITION_PIPELINE_v1_archive.md` | Archive — verify no active items leaked in. | | `docs/media/AGENT_NEWSROOM.md` | Reporter count, names, desk assignments match `.claude/agents/` directories (currently 27)? Canon-fidelity rollout (S174-S175) reflected — all 25 generative + reviewer agents have four-file structure? | | `docs/media/DESK_PACKET_PIPELINE.md` | **SUPERSEDED** — canonical is `EDITION_PIPELINE.md`. Do not maintain; archive when `archive/` move happens. | | `docs/media/MEDIA_ROOM_HANDOFF.md` | Engine→Media Room handoff guide current? | | `docs/media/MEDIA_INTAKE_V2.2_HANDOFF.md` | Media Room markdown parsing structure current? | | `docs/media/MEDIA_ROOM_STYLE_GUIDE.md` | Voice rules, data treatment, continuity, clock rules current? Cycle-allowed (S146 reversal) reflected? | | `docs/media/TIME_CANON_ADDENDUM.md` | Dual-clock system (sports time vs city time) current? | | `docs/media/REAL_NAMES_BLOCKLIST.md` | **Active — Rhea reads this every verification.** Real-world sports figures listed; sync with canon Athletics/Bulls rosters. Sports-history carveout (S175) — historical players now permitted; reflect carveout in scope notes. | | `docs/media/CITIZEN_NARRATIVE_MEMORY.md` | Supermemory + Richmond Archive + Ledger integration current? | | `docs/media/JOURNALISM_AI_OPTIMIZATIONS.md` | AP/Reuters/Bloomberg patterns — version current? v1.2 complete per S147. | | `docs/media/GOOGLE_DRIVE_INTEGRATION.md` + `docs/media/DRIVE_MANIFEST.md` | Drive folder + file IDs current? | | `docs/media/podcast/SHOW_FORMATS.md` | Podcast formats match `/podcast` skill? Host assignments current? | | `docs/media/story_evaluation.md` | Changelog growing each cycle (expected: one entry per post-publish run). Front page scoring section present. **If no new entries in 3+ cycles, post-publish Step 10 isn't running — flag.** | | `docs/media/brief_template.md` | Changelog growing. Structure section intact. Good/bad brief examples present. If stale, flag. | | `docs/media/citizen_selection.md` | Changelog growing. MCP lookup rule (citizens vs A's players) current. Name collision warning still needed (check if ledger cleanup happened). | | `docs/media/intake.md` | Edition intake section reference current? | | `docs/media/CANON_ARCHIVE_LEDGER.md` | Every published edition + supplemental indexed with metadata? Latest entry covers most recent shipped edition? | | `docs/media/RICHMOND_ARCHIVE_INDEX.md` | Hal Richmond's archive index — entry count current? Sports-history carveout reflected if archive entries reference real historical figures? | | `docs/media/ANTHONY_RAINES_PORTFOLIO_INDEX.md` + `docs/media/P_SLAYER_JOURNEY_INDEX.md` | Portfolio entry counts current? | | `docs/media/CITIZENS_BY_ARTICLE.md` + `docs/media/ARTICLE_INDEX_BY_POPID.md` | Cross-reference indexes current? Updated post-publish? | | `docs/media/PAULSON_CARPENTERS_LINE.md` | Mike Paulson backstory by Hal Richmond — canon-permanent, audit-light. | | `docs/media/2041_athletics_roster.md` + `docs/media/PLAYER_CARD_INDEX.md` | Roster set in 2041 — verify against truesource_reference.json. Player cards match A's roster? | | `output/DISK_MAP.md` | Directory structure matches actual `output/` layout? Naming conventions match scripts? | ### infra — Drift when services change. | Doc | What to verify | |-----|---------------| | `docs/OPERATIONS.md` | PM2 processes match `pm2 list`? Cron jobs match `crontab -l`? Mobile access instructions current? | | `docs/STACK.md` | All components exist? Versions current? Process names match? Endpoint/skill/agent counts match (currently 27 agents, 41 skills)? | | `docs/DASHBOARD.md` | Endpoint count matches actual `server/*.js` routes? Frontend tabs current? | | `docs/DISCORD.md` | Bot name, model, knowledge sources, Supermemory integration current? | | `docs/SUPERMEMORY.md` | 6 containers listed? Isolation rules match config? Access matrix current? Skills table matches actual commands? | | `docs/CLAUDE-MEM.md` | Bun daemon (NOT PM2)? Port 37777? SQLite + Chroma still the stack? AutoDream config matches `/root/.claude-mem/settings.json` (Gemini 2.5 Pro free tier per S141)? | | `docs/FOUR_COMPONENT_MAP.md` | Terminal count matches `.claude/terminals/` subdirs (5: civic/engine-sheet/mags/media/research-build)? Skill count matches `ls .claude/skills/ \| wc -l` (currently 41)? Agent count matches `ls .claude/agents/ \| wc -l` (currently 27)? Models per role current? Cron inventory matches `crontab -l`? §7 seam map reflects current Phase 40 status (5/6 DONE)? | | `docs/MIGRATION_OFF_CLAUDE.md` | S154 desk-agent migration — DeepSeek V3.1 via OpenRouter results current? Test script + next-steps + survives-list accurate? | | `docs/ACTION_MANAGED_AGENTS.md` | Anthropic Managed Agents research — still ready to evaluate? Status changed? | | `docs/CANCELLATION.md` | Monthly costs current? Cancellation paths still valid? New paid services added (Supermemory P N at $9/mo confirmed)? | | `docs/WORKFLOWS.md` | 7 workflow patterns — match actual session usage? Post-S165 reframe (workflow reference, not boot file) reflected? | | `docs/RESEARCH.md` | Findings log current? Recent evaluations recorded (DeepSeek S154, Sandcastle/Daytona S156, outside-AI reviews S170)? | | `docs/research4_1.md` + `docs/research4_2.md` | Engineering patterns + Ryan dissertation — still load-bearing reference? Cross-references in current plans? | | `docs/research/briefing_bloat_audit_2026-04-17.md` | Audit findings still accurate? Trim plan ([[archive/plans/2026-04-17-briefing-bundle-trim]]) status? | ### data — Drift when sheets change. | Doc | What to verify | |-----|---------------| | `docs/SIMULATION_LEDGER.md` | Citizen count, column count (47 — A-AU per S156 SCHEMA_HEADERS, NOT 46), column numbers match live sheet? ClockMode/Tier/Status/Flag sub-counts updated since S140? | | `docs/SPREADSHEET.md` | Tab count matches actual spreadsheet (53 visible + 6 hidden + utility ≈ 65)? Per-tab row counts — defer to SCHEMA_HEADERS as authoritative. | | `schemas/SCHEMA_HEADERS.md` | **Auto-generated** by `utilities/exportSchemaHeaders.js` — verify it's been regenerated recently (S156 added frontmatter that survives regeneration). Header counts authoritative for all tabs. | | `docs/engine/LEDGER_HEAT_MAP.md` | **engine-sheet handoff (S156)** — extremely stale C81/S30/2026-02-16. Bloat rankings + dead column inventory likely outdated. Do not maintain in research-build; flag for engine-sheet refresh. | | `docs/engine/LEDGER_REPAIR.md` | **engine-sheet handoff (S156)** — RECOVERY COMPLETE S94, "DO NOT re-analyze" intact. Column reference (A-AU now per S156) — needs update from A-AT. Audit-light. | | `docs/engine/LEDGER_AUDIT.md` | **engine-sheet handoff (S156)** — pre-recovery counts (658/639) stale; CLEAN since S68 status correct. Audit-light. | ### plans — High-drift. Status flips fast as work completes. `docs/plans/` files are the most drift-prone in the repo. Each plan tracks status (active/complete/parked); marking a completed plan "complete" without flagging means future sessions waste cycles re-discovering done work. Audit cadence: every 2-3 sessions, or after any session that closes a plan-tracked phase. | Doc | What to verify | |-----|---------------| | `docs/plans/PLAN_TEMPLATE.md` | Reference template — verify shape matches active plan files. Audit-light. | | `docs/plans/BACKLOG.md` | Consolidated parked-phase backlog — verify phases listed are still parked (not started, not complete elsewhere). Cross-check against ROLLOUT_PLAN spine. | | `docs/archive/plans/skill-eval-framework.md` | HIGH priority not started — verify status; check first skill `/skill-check` shipped S156 reference still accurate. | | `docs/archive/plans/2026-04-16-phase-38-5-measurement-loop.md` | DONE S156 — verify Status section reflects completion; consider archive flag. | | `docs/archive/plans/2026-04-16-phase-38-6-skill-shrink.md` | DONE S156 — verify Status section reflects completion. | | `docs/archive/plans/2026-04-16-phase-40-1-session-log-interface.md` | DONE S156 — verify. | | `docs/archive/plans/2026-04-16-phase-40-3-credential-audit.md` | Drafted S156, engine/sheet picks up when priority rises — verify status hasn't changed silently. | | `docs/archive/plans/2026-04-16-phase-40-6-injection-defense.md` | Drafted by research-build; engine/sheet builds — verify build status. | | `docs/archive/plans/2026-04-17-briefing-bundle-trim.md` | Drafted S156; media terminal executes — verify execution status. |