ADR-NNN: [Short title of the decision]
- Status: Proposed | Accepted | Deprecated | Superseded by ADR-XXX
- Date: YYYY-MM-DD
- Decider(s): Names
- Revisit by: YYYY-MM-DD (or “no review planned”)
Context
What’s the situation that forced us to make a decision? What are the business or technical forces at play?
Options considered
At least two. Preferably three. For each:
- Option A: [name] — what it is, pros, cons, cost estimate
- Option B: [name] — what it is, pros, cons, cost estimate
- Option C: [name] — what it is, pros, cons, cost estimate
Decision
What we chose. One paragraph.
Reasoning
Why we chose it. What tipped the scales? What did we explicitly NOT care about that others might?
Consequences
- Positive: what gets easier
- Negative: what gets harder or more expensive
- Neutral: what we now need to monitor
Revisit triggers
When would this decision be wrong? What would we need to see to reopen it?