Skip to content

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.