ADR-NNN — A specific decision title¶
Status¶
Proposed (YYYY-MM-DD). Record acceptance and its source when decided.
For a record written or rewritten from now on, this status statement is five
lines at most (Scope and Relations aside), and delivery progress lives in
docs/merge/PROGRESS.md and changes/, never in the record.
Scope: the component or product rule this decision governs.
Relations: links to the exact sections this amends, supersedes or depends on; omit this line when none apply. Add reciprocal amendment links in older records.
Context¶
Explain the problem and constraints. Link requirement IDs and open questions; do not duplicate their complete definitions.
Decision¶
State the chosen rule, its boundaries and exceptions. Separate accepted decisions from implementation progress; link task cards or code for the latter.
Consequences¶
Explain the benefits, costs, risks and work this decision requires.
Alternatives considered¶
Name the plausible alternatives and why they were rejected.