Files

Phillip Tarrant aaff2c8554 docs(m4c): spec — title → creation → shell flow

A GameFlow coordinator node (new main_scene) owns the Title → Creation →
Shell sequence in one file: instantiate → inject → add_child, reusing the
existing injection seam that change_scene_to_file cannot. Title becomes
emit-only; the shell gains injected_log/injected_state seams and stops
self-seeding on the real path (seed stays as the F6 fallback), so the
created character's vitals, location, and opening narration are real.

The ⛨ saga constraint is honored structurally: _show_creation and
_start_campaign are separate, so the fourth entry path is an added arm,
not surgery on existing edges.

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

2026-07-15 03:43:57 -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): spec — title → creation → shell flow

2026-07-15 03:43:57 -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.