ADR-NNNN: Title
Status: OPEN | ACCEPTED | SUPERSEDED (by NNNN) | REJECTED · Date opened: · Date closed: · Spec refs: · Spec issue: (required before any ACCEPTED ADR changes normative text)
Context
What forces the decision, in one or two paragraphs. Cite the spec sections and documents that establish the constraints.
Options
One subsection per option: what it is, what it buys, what it costs, and what it breaks (envelope/registry changes are compatibility-breaking until v1.0 — CONTRIBUTING.md).
Decision criteria
The tests the winning option must pass, stated before the decision so the decision can’t quietly redefine success.
Evidence needed to close
Concrete items: a cryptographer’s review note, a lab’s FIPS opinion, a measurement, a prototype. Who is expected to provide each.
Decision
(Empty while OPEN.) The choice, the reasoning, dissent worth recording, and the list of documents/vectors the closure obligates.