docs(wiki): add topic pages to the project wiki - #37
Merged
Conversation
…net-Data-Model, Deploy-And-Ops Each page synthesizes across multiple sources that no single docs file covers: - Milestone-Feature-Map: draws across all four plan docs (m5/m7/m8/m9), BACKLOG Done entries, Decisions.md (D6/D8), and the audit to show what each milestone actually shipped vs. cut — and how the wire protocol grew across them. - Puzzle-and-Planet-Data-Model: mines PlanetConfig, PuzzleOverrides, TALENTS, ProgressState/ PlanetTelemetry, Portrait, and relayForward entirely from code; this schema exists in no docs file. - Deploy-And-Ops: synthesizes DEPLOY.md (walkthrough), m5-deploy-plan.md (deliberate cuts), Decisions.md D6/D8, and Phase 6 audit findings (F-34 multi-machine HA and others) that DEPLOY.md does not mention. Autonomy-Loop rejected: AUTONOMY.md is already a complete standalone spec; code adds no independent synthesis. _index.md updated with all three new rows. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What each page synthesizes and why it clears the no-restatement bar
Milestone-Feature-Map
Draws across 4 plan docs (m5-deploy-plan.md, m7-talents-plan.md, m8-strength-talents-plan.md, m9-themed-puzzles-plan.md) + BACKLOG Done entries + Decisions.md + AUDIT-2026-07-09.md. No single plan doc covers more than one milestone. This page answers: what did each milestone ship vs. deliberately cut, what decisions shaped those cuts (D2/D3/D5/D6/D8), and how the wire protocol grew across M5–M9. The protocol-growth section (optional fields, backward-compat design) is a pattern visible only when reading all four plan docs together.
Puzzle-and-Planet-Data-Model
Mined entirely from code (
planet1.ts,registry.ts,protocol.ts,talents.ts,save.ts,portrait.ts,relay.ts). No docs file describes the full schemas or the relationships betweenPlanetConfig,PuzzleOverrides,ProgressState/PlanetTelemetry, andrelayForward. The "0-is-no-sample" guard in both the clear-best and per-power bestMs accumulators, the relay allowlist's growth pattern, and the two-function architecture (tuningFor / strengthFor) are all code-only facts.Deploy-And-Ops
Synthesizes DEPLOY.md (accurate walkthrough) + m5-deploy-plan.md (deliberate cuts: tsx at runtime, Cloudflare left out, relay-only container) + Decisions.md D6/D8 (Docker slim approach still unresolved; Phase 6 rides the deploy) + AUDIT Phase 6 findings (F-34 multi-machine HA, F-60 image size, F-61 Dockerfile hygiene) that DEPLOY.md does not mention. F-34 in particular (Fly default HA → rooms split across machines → joins fail) is the highest-priority pre-deploy finding not yet landed.
Rejected page
Autonomy-Loop —
docs/AUTONOMY.mdis already a complete, detailed standalone spec (the audit called it "impressively accurate"). Reading the test bridge source alongside it adds no independent synthesis; the doc references the code throughout and is accurate. A wiki page would restate rather than synthesize.🤖 Generated with Claude Code