Files

Phillip Tarrant f763aa0c31 docs(m4c): implementation plan — title → creation → shell flow

Five TDD tasks: ShellState.for_character, the shell's injected-character
seams, the emit-only title, the GameFlow coordinator (+ its flow and
construct-failure tests), and the main_scene flip with a human smoke gate.
Each task carries full test code, exact commands, and a revert-and-watch-red
step per docs/traps.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-15 03:54:18 -05:00

adr

docs: record editor-first UI-scene convention (ADR 0001)

2026-07-11 10:04:57 -05:00

schemas

refactor(contract)!: class_id -> calling_id, and the log gains race_id

2026-07-12 20:27:56 -05:00

superpowers

docs(m4c): implementation plan — title → creation → shell flow

2026-07-15 03:54:18 -05:00

canon-log.md

fix(creation-model): migrate stray class_id/allowed_classes copies

2026-07-12 20:58:49 -05:00

README.md

docs: traps.md — the bugs that passed a green suite

2026-07-12 21:07:39 -05:00

roadmap.md

docs(roadmap): M4-b lands; the Title screen was already built

2026-07-13 16:00:17 -05:00

traps.md

fix(creation-screen): the white text, the badge on top of the roll, and a window too big for the laptop

2026-07-14 19:56:09 -05:00

README.md

/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 next
traps.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 Records
canon-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.