# ADR-NNN: [Short decision title]

> Template by Philip Scheer — philipscheer.github.io

- **Status:** proposed / accepted / deprecated / superseded by ADR-NNN
- **Date:** YYYY-MM-DD
- **Deciders:** who was involved in the decision

## Context

What is the issue we are facing? What forces are at play (technical, business, cost, team)? Keep it factual — a reader two years from now should understand the situation without attending the meeting.

## Decision

What we decided, stated in full sentences, in active voice. "We will use X because Y."

## Options considered

### Option A — [name]
- Pros: ...
- Cons: ...

### Option B — [name]
- Pros: ...
- Cons: ...

## Consequences

What becomes easier, what becomes harder, what we are consciously accepting.

- **Positive:** ...
- **Negative:** ...
- **Cost impact:** ... (include the cost consequence, not just the technical one)

## Follow-up

Actions this decision triggers (migrations, deprecations, documentation updates).