Architecture decision records
Each decision record (ADR) documents one significant design decision: its context, the decision and its consequences. The architecture guide explains how the decisions fit together in the code.
| ADR | Decision |
|---|---|
| 001 | DOM/SVG in headless Chromium as the rendering surface |
| 002 | YAML is the only authoring format |
| 003 | Pure render(t) and determinism rules |
| 004 | Human-marked cues (superseded in part by ADR-013) |
| 005 | Parallel frame-range workers and segment concatenation |
| 006 | Two outputs: master and size-targeted share file |
| 007 | Caption bidi strategy |
| 008 | Procedural sound effects instead of sample libraries |
| 009 | System FFmpeg instead of a bundled binary |
| 010 | Monorepo with pnpm workspaces and package boundaries |
| 011 | Static film grain by default |
| 012 | A project dashboard with write actions |
| 013 | Assisted cue alignment |
| 014 | One tool registry, three transports |
| 015 | Local server security for AI endpoints |
| 016 | 9:16 is the only format for 1.0 |
For a significant design change, add a new record in docs/adr/ (see Contributing).