ADR-NNN: [Title]

Field

Value

Status

Proposed / Accepted / Deprecated / Superseded

Date

YYYY-MM-DD

Deciders

e.g. Full Team, Backend Lead, AI Lead

Supersedes

ADR-XXX or –

Superseded by

ADR-XXX or –


Context

What is the situation, problem, or force that requires a decision?

Decision Drivers

Considered Options

  • Option A – [short label]

  • Option B – [short label]

  • Option C – [short label]

Decision

Chosen option: Option X – [one sentence rationale]

Rationale

Why was this option chosen over the others?

Pros and Cons of the Options

Option A – [label]

  • ✅ [positive consequence]

  • ❌ [negative consequence]

Option B – [label]

  • ✅ [positive consequence]

  • ❌ [negative consequence]

Consequences

Positive:

Negative / Trade-offs:

Follow-up actions: