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?

State the chosen approach precisely.

Describe credible alternatives and why they were not selected.

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

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

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