N. Title of Decision

Date: YYYY-MM-DD Status: [Proposed | Done | Superseded | Deprecated]

Context

What is the issue we’re seeing that is motivating this decision or change?

Decision

What is the change we’re actually proposing or doing?

Rationale

Why are we doing this? What alternatives did we consider?

Alternatives considered:

1. Option A — description. Rejected because…
2. Option B — description. Rejected because…

Why this approach:

• Reason 1
• Reason 2

Impact

What becomes easier or harder as a result of this change? Include:

• Code/architecture changes
• Testing implications
• Documentation updates
• Migration notes (if superseding another ADR)