# Architecture decision records

Decisions this repo has made and will not silently revisit. One file per
decision, named `NNN-<slug>.md`, listed here — an unlisted page fails `kb-lint`
and does not exist as far as any agent is concerned.

**No ADRs yet.** The first one lands the moment a decision stops being
reversible.

## Format

Same shape as the `dank/dankvoice` decision records, which read well under time
pressure:

- `# <Decision as a claim> (YYYY-MM-DD)` — a title you can disagree with.
- **Root** — the situation and the evidence that forced the question, with measured
  output rather than recollection where measurement exists.
- **Decision** — what was chosen, and the rule an agent must follow because of it.
- **Rejected** — the alternatives and the specific reason each was turned down, so
  nobody spends an afternoon rediscovering them.
- **Verification** — what was run to prove the decision holds, and where that
  proof lives.

Frontmatter is required like any other page in this bundle (`type: decision`), and
an ADR that a code change has superseded gets an amendment section appended rather
than a rewrite: the point of the record is that the reasoning is still readable.