ADR-NNNN: Title
Record the date this decision was first proposed (e.g., YYYY-MM-DD). Use the date of the underlying documentation, not the date of implementation.
State the current condition of the decision (Proposed | Accepted | Superseded). If superseded, include a link to the newer ADR.
Describe the forces at play and the technical or business context that compels a decision. Keep it to a concise paragraph explaining why a change is needed.
State the chosen option in active voice. Outline exactly what is being decided. Avoid low-level implementation specifics and focus on the architectural intent.
Detail the positive and negative outcomes of this decision. Describe what becomes easier, what becomes harder, and any new constraints or risks introduced.
List the other options evaluated before arriving at this decision. Briefly explain why they were rejected.
Reference any past ADRs that are superseded by or closely related to this decision. If none exist, state 'None'.