# Template — Architecture Decision Record

**Status:** Proposed / Accepted / Superseded / Rejected  
**Date:** YYYY-MM-DD  
**Decision owners:**

## Context

What problem, constraint or repeated ambiguity requires a durable decision?

## Decision

State the chosen approach precisely.

## Alternatives considered

Describe credible alternatives and why they were not selected.

## Consequences

Record benefits, trade-offs, compatibility implications, migration cost and operational effects.

## Follow-up

Implementation tasks, tests, migration work and documentation that must change.

## Supersession

If this ADR replaces or is replaced by another ADR, link both directions.