ADR Index

September 20, 2026 · View on GitHub

The decision ledger. One row per ADR; the Status column is authoritative. A new ADR adds a row. Superseding or amending an ADR updates both its row here and the header of the ADR itself, in the same commit. An ADR never contradicts docs/00-invariants.md; one that would is written as an amendment to that document instead (its §7).

Format of every ADR: title, status line with date, context, decision, consequences, rejected alternatives. Decisions are numbered inside the ADR so later documents can cite "ADR-0002 D3".

#TitleStatus
0001Founding choices: name, scope, licence, toolchain, conventionsAccepted (2026-09-19); D3 amended 2026-09-20: GPL-3.0 to MIT
0002One backend port, four adapter kinds, a capability probe, a readout ladderAccepted (2026-09-19)
0003Jev's evaluate call is the API; extensions are namespaced; the SDK is the acceptance testAccepted (2026-09-19)
0004Recipes: the hashed file that is the only way a model is askedAccepted (2026-09-19)
0005Suites, scorecards, committed evidence, post-hoc calibrationAccepted (2026-09-19)
0006Toolchain, dependency budget and portability: five light core packages, extras, argparse, uv/pipx, Python 3.12–3.14, no lock-inAccepted (2026-09-19); makes ADR-0001 D4 precise