TDD task-by-task: NewGame's public seeded roll -> the eleven fragments -> CreationCopy -> CreationDraft -> the theme -> the scene -> the docs. Both of traps.md's bugs get a named guard rather than a hope: the pipeline test that asserts what the screen SHOWED is what construct BUILT (and a step that re-breaks the code to prove the test can fail), and a no-default-parameters rule on the two new public functions. Also corrects the spec: PrimaryCTA already has a disabled stylebox.
/docs — cross-cutting docs
Anything affecting both client and api, plus planning and roadmap. Side-specific docs live in /api/docs and /client/docs.
Put here:
roadmap.md— phases, POC scope, what's nexttraps.md— bugs we have already shipped, and the guards that catch them. Read before writing tests: every one of them passed a green suite.adr/— Architecture Decision Recordscanon-log.md— the cross-boundary contract (§11)- Shared contracts — canon log schema, tag syntax, retry policy (§11, §12)
- Anything spanning the HTTP boundary
The charter itself — CLAUDE.md — stays at the repo root. It is the source of truth; these docs elaborate, they do not override it.