Date: YYYY-MM-DD
Status: Proposed | Accepted | Superseded | Deprecated | Rejected
Deciders: (list the people or teams involved in the decision)
Supersedes: (ADR number and link, if this replaces an earlier decision)
Superseded by: (ADR number and link, if a later ADR replaces this one)
Describe the situation or problem that led to this decision. Include any technical constraints, business requirements, or forces at play. Be specific enough that someone unfamiliar with the codebase can understand the problem without reading other documents.
- Driver 1 (e.g., performance requirement, operational simplicity)
- Driver 2
- Driver 3
Brief description of the option.
Pros:
- Pro 1
- Pro 2
Cons:
- Con 1
- Con 2
Brief description of the option.
Pros:
- Pro 1
Cons:
- Con 1
Brief description of the option.
Pros:
- Pro 1
Cons:
- Con 1
State the chosen option clearly:
We will use Option X because …
Explain the primary reason(s) for the choice, referencing the decision drivers above.
- What becomes easier or better as a result.
- What risks are mitigated.
- What becomes harder, more complex, or constrained.
- Known limitations or future debt introduced.
- Follow-up work required.
- Decisions this record leaves open.
- Related issue or PR: #
- Related documentation: (link)
- Prior art / reference: (link)