docs(m13): Phase 3 — docs tell the truth (F-24, F-25, F-26, F-27, F-33, F-59)

[ksdisch]

Executes Phase 3 of docs/AUDIT-2026-07-09.md: the onboarding docs stop describing a project 8 milestones ago. Docs-only — 11 markdown files, no code, no protocol, no deps.

What changed

• README (F-24): rewritten to the shipped game — 4 powers / 3 planets / hub / talents / rhythm portrait / procedural juice; solo keys 1–4; ?test=1 bridge and smoke:relay pointers; plan pointers now go to BACKLOG.md + docs/ instead of the out-of-repo plan file. Dropped the Wordle/mini-Sudoku promises.
• CLAUDE.md (F-25): cast handler is Planet.ts (×2); file layout gains planets/, progression/, testBridge.ts, talents/, puzzleThemes.ts, scripts/, docs/; the server/ line + allowlist sentence state the real relayForward rules (boosted+solveMs, planet-complete, planet-started); "first four powers"; smoke:relay/start:relay in the commands block; the reconnect gotcha now describes the post-Phase-1 heartbeat + one-tap rejoin; worktree note no longer claims a worktree always exists.
• session-start.md (F-26): Path A no longer routes into PROJECT_GUIDE.md; the phase line defers to the BACKLOG audit item's Progress line (drift-proof) instead of a frozen "M4 in flight" claim; version pins corrected to 5.9/3.90 with package.json named as source of truth; the false "don't add automated tests yet" rule replaced with the real gates (Vitest + bridge + human playtest); both "opaque pass-through" spots → allowlist.
• PROJECT_GUIDE.md (F-27): loud [!WARNING] historical-snapshot banner (M4, generated 2026-05-16 per git) above the title; everything below is frozen as-is.
• BACKLOG (F-33 + F-59): playtest item reframed to the shipped game (hub → planets 1–3 → talents → portrait); Galaxy-hub Done entry moved into the 2026-06-05 group so Done stays date-ordered (its "(below)" xref flipped to "(above)").
• F-59 one-liners: smoke-runner keys 1/2/3/4 + dropped its false "don't add tests" hard-rule quote; orchestrator.md allowlist wording; ideas doc status notes its M10 wedge shipped (generator spiked in draft PRs feat(m12): generator spike — grow a playable planet from the pair's rhythm #23/feat(m12): theme grown planets from a pre-baked palette library #24); AUTONOMY networking note now matches .mcp.json's localhost origin pin.

Beyond the enumerated list (gate-driven)

The grep gate caught three drifts the audit's F-25/F-59 lists missed; all are the same falsehood classes, so they're fixed here: protocol-steward.md ×2 ("forwards messages opaquely" — would misdirect a live protocol change, since a new peer-forwarded type does need a relayForward rule), new-power/SKILL.md ×2 (claimed CLAUDE.md names Level.ts — this PR inverts that premise — and "first three powers"), and CLAUDE.md's server/ layout line ("Pass-through forwarding").

Gate

No mechanical gate for this phase. The audit's grep sweep (Level.ts, pass-through, three powers, word-bounded M2/M4 — plus defensive opaque) returns zero live hits; every remaining match is deliberately historical (audit doc, PROJECT_GUIDE below its banner, dated BACKLOG Done notes, .claude/notes/ reports, the labeled orchestrator-prompt.md), an accurate negation ("allowlist, not a pass-through"), or a truthful historical tag ("the M2 reference power"). Evaluated and deliberately kept: planet2.ts's "ALL THREE powers" comment (true in context — it enumerates planet-2's own three gates) and advancement-brainstorm.mjs's M4-era context block (orphaned historical artifact of the v2/v3 brainstorm runs; nothing references it).

Flags for Kyle

• Audit decision feat(m4): persistence + progression spine — durable unlock chain + Vitest #5 (PROJECT_GUIDE): went with the audit-recommended banner-only default; the full regenerate-from-HEAD (~L effort) stays open — say the word and it becomes a backlog item.
• Audit decision feat(m3): complete spellbook trio (Summon Platform + Illuminate) #1 (CI): session-start's no-CI rule was deliberately not touched — that amendment belongs to Phase 4 with your call on F-32.

🤖 Generated with Claude Code