ADR NNNN — Title
- Status: Proposed | Accepted | Deprecated | Superseded by ADR-NNNN
- Date: YYYY-MM-DD
Context
Section titled “Context”The forces at play: the situation, constraints, and facts that make a decision necessary. Neutral — no recommendation yet.
Decision
Section titled “Decision”The decision, stated in the active voice: “We will …”.
Consequences
Section titled “Consequences”What becomes easier and what becomes harder as a result. Include follow-on work and anything we’re now committed to (or foreclosed from).
ADRs record decisions already made (the “why” behind the architecture); RFCs propose changes for review before building. An RFC that lands a durable architectural decision should leave an ADR behind.