Files

Phillip Tarrant 7471d2e37f docs(traps): the drift guard took three fixes, and the third one whitelisted the gap

Trap 12 told only the first act. The full story is the lesson: ThemeKeys.ALL excludes
the font roles by its own docstring, and the builder styles some base types directly
(RichTextLabel — which renders every line of DM prose on the creation screen). The
meta-guard written specifically to prevent a third miss contained a `continue` that
exempted exactly the gap it existed to catch.

A guard-of-a-guard with an exemption in it is not a guard.

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

2026-07-13 16:48:27 -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(plan): M4-b — the creation screen, seven tasks

2026-07-13 07:07:36 -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

docs(traps): the drift guard took three fixes, and the third one whitelisted the gap

2026-07-13 16:48:27 -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.