ADR-NNNN: Title
Status
Proposed | Accepted | Deprecated | Superseded by ADR-XXXX
Date
YYYY-MM-DD
Context
Describe the forces at play. What is the problem? What constraints exist? Keep it factual — no marketing language.
Decision
State the decision clearly. Use active voice: "We will..." or "The system uses..."
Include key details: what technology, what pattern, what boundary.
Consequences
Positive
- What becomes easier or better as a result of this decision.
Negative
- What becomes harder or what trade-offs we accept.
Neutral
- What changes without clear positive or negative impact.