Skip to content

ADR-NNNN: Short decision title

How to use

Copy this page to NNNN-short-title.md, replace the placeholders, set the status, and add the entry to the ADR index and the nav. Keep one decision per ADR.

  • Status: Proposed | Accepted | Rejected | Deprecated | Superseded by ADR-XXXX (link the superseding ADR)
  • Date: YYYY-MM-DD
  • Deciders: roles / agents involved
  • Tags: area(s) affected

Context

What is the problem, force, or requirement driving this decision? Capture the constraints, assumptions, and relevant background. Link to the principle or architecture pages this decision supports.

Decision

The decision, stated in one or two clear sentences. Be specific and unambiguous — this is the binding statement.

Consequences

Positive

  • What becomes easier, safer, or cheaper.

Negative / trade-offs

  • What becomes harder or constrained, and any debt incurred.

Neutral

  • Notable side effects that are neither clearly good nor bad.

Alternatives considered

Alternative Why not chosen
Option A Reason
Option B Reason
  • Links to related ADRs, principles, and architecture pages.