ADR-NNNN —

  • Status: Proposed | Accepted | Deferred | Superseded by ADR-NNNN
  • Date: YYYY-MM-DD
  • Relates to:

Context

What problem or force prompts this decision? What constraints and goals are in play? State the facts plainly — including any hard realities that bound the option space.

Considered options

The alternatives weighed, each with its trade-offs. (Omit if there was only one path.)

Decision

What was decided — or Deferred, and why. Be specific enough that a reader can act on it.

Consequences

What changes as a result: what we keep, what we change, what we give up, and any new constraints or follow-up work. Note downstream impact on contracts, dependencies, or other ADRs.