Skip to content

ADR-NNNN: Title

Status

Proposed | Accepted | Deprecated | Superseded by ADR-XXXX

Date

YYYY-MM-DD

Context

Describe the forces at play. What is the problem? What constraints exist? Keep it factual — no marketing language.

Decision

State the decision clearly. Use active voice: "We will..." or "The system uses..."

Include key details: what technology, what pattern, what boundary.

Consequences

Positive

  • What becomes easier or better as a result of this decision.

Negative

  • What becomes harder or what trade-offs we accept.

Neutral

  • What changes without clear positive or negative impact.