Architecture Decision Record — Template Pointer¶

The canonical ADR template lives at docs/decisions/adr-template.md. This file exists here in templates/ purely for discoverability — so that someone browsing the company template index finds their way to the real template — and is intentionally kept as a thin pointer rather than a duplicate, to avoid the two drifting out of sync.

Do not fork this template¶

Always use docs/decisions/adr-template.md directly when writing a new ADR. Do not copy this file's (nonexistent) body as a starting point.

Section list (for quick reference only)¶

The canonical template includes, at minimum, sections along these lines — consult the canonical file for the authoritative structure and any additional requirements:

Title and status (proposed / accepted / superseded / rejected)
Context (what problem/decision prompted this)
Decision (what was decided)
Consequences (what follows from this decision, including trade-offs)
Alternatives considered
Related decisions / superseded-by links

Numbering and status rules¶

Get the next ADR number in sequence; never renumber existing ADRs.
New ADRs are created with status: proposed pending explicit human ratification — never mark a new ADR accepted on creation.

See ../prompts/create-adr.md for the full checklist for writing a new ADR.

Report an issue about this page