Skip to content

ADR-NNNN:

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

Context

What is the problem or force at play? What constraints, requirements, and assumptions are relevant? Link to related docs/ADRs. Keep it factual.

Decision

The decision, stated plainly: "We will …". Be specific enough that someone can act on it.

Consequences

What becomes easier or harder as a result? Include positive, negative, and neutral consequences, and any follow-up work this implies.

Alternatives considered

What else was on the table, and why it was not chosen. A short pros/cons per option is enough.