# ADR NNNN: [decision in an imperative or noun phrase]

**Status:** Proposed / Accepted / Superseded
**Date:** [actual date only, do not invent]

## Context

[Problem, constraints and specific forces; link code/docs evidence where available.]

## Decision drivers

- [Need or constraint]

## Options considered

1. [Option A] - [benefits, costs, risks]
2. [Option B] - [benefits, costs, risks]

## Decision

[One concise statement; for proposed ADRs state recommendation, not approval.]

## Consequences

- Positive:
- Negative / tradeoffs:
- Migration or rollback consequences:

## Validation and follow-up

- [How the choice will be tested and reconsidered]
- [Links to superseding ADRs or related plans]