---
# Optional metadata. Remove any element you don't need.
status: "{proposed | rejected | accepted | deprecated | superseded by ADR-NNNN}"
date: { YYYY-MM-DD when the decision was last updated }
decision-makers: { everyone involved in the decision }
consulted: { subject-matter experts consulted, with two-way communication }
informed: { people kept up to date, with one-way communication }
---

# {short title, representative of the problem and the chosen solution}

## Context and Problem Statement

{Two or three sentences, or a short story, describing the context and the
problem. Framing the problem as a question often helps. Link issues/PRs.}

## Decision Drivers

- {driver 1 — a force, a concern, a constraint}
- {driver 2}

## Considered Options

- {option 1}
- {option 2}
- {option 3}

## Decision Outcome

Chosen option: "{option N}", because {justification — meets a must-have driver,
resolves a key force, or comes out best in the comparison below}.

### Consequences

- Good, because {positive consequence}
- Bad, because {negative consequence / accepted trade-off}

### Confirmation

{How compliance with this ADR is checked — a review, a test, a lint rule,
a sign-off.}

## Pros and Cons of the Options

### {option 1}

- Good, because {argument}
- Neutral, because {argument}
- Bad, because {argument}

### {option 2}

- Good, because {argument}
- Bad, because {argument}

## More Information

{Extra evidence, team agreement, when to revisit, links to related ADRs.}