# Architecture Decision Records One file per decision: `NNNN-short-title.md`. Record the context, the decision, and the consequences. When a decision conflicts with [`CLAUDE.md`](../../CLAUDE.md), change the charter first (charter §18). ## Index - [0001 — UI screens are editor-authored scenes, not code-built](0001-editor-first-ui-scenes.md) (accepted)