Templates
ADR Template
Use this template for durable architecture decisions. Keep the ADR short enough that future teams will actually read it.
# ADR-NNN: Decision title
## Status
Proposed | Accepted | Superseded | Deprecated
## Context
What problem are we solving? What constraints matter? Include business,
technical, compliance, cost, and operational context where relevant.
## Decision
What did we choose?
## Consequences
What improves? What becomes harder? What risks remain?
## Alternatives considered
What did we reject and why?
## Implementation notes
What needs to happen for this decision to become real?
## Review trigger
What event, date, metric, or incident should cause reconsideration?Status guidance
- Proposed: still under review.
- Accepted: current decision.
- Superseded: replaced by a newer ADR.
- Deprecated: still exists but should not be used for new work.
Do not delete old ADRs unless they contain sensitive information that must be removed. Supersede them so the decision history remains useful.