Skip to main content

ADR-NNN — Decision Title

Copy this file to docs/adr/adr-NNN-short-title.md and fill in all sections. See the ADR Index for naming conventions and the ADR lifecycle.

FieldValue
DateYYYY-MM-DD
StatusProposed
Proposer@agent-name
Supersedes— (or ADR-NNN if this replaces another)
Superseded By— (filled in when a newer ADR replaces this)

Context​

Decision Drivers​

  • Driver 1
  • Driver 2
  • Driver 3

Considered Options​

Option A: [Name]​

Summary: One sentence describing this option.

Pros:

  • Pro 1
  • Pro 2

Cons:

  • Con 1
  • Con 2

Option B: [Name]​

Summary: One sentence describing this option.

Pros:

  • Pro 1

Cons:

  • Con 1

Decision Outcome​

Chosen option: Option A — [Name]

Rationale: Why this option over the others? Reference the decision drivers.

Positive Consequences​

  • Consequence 1
  • Consequence 2

Negative Consequences / Trade-offs​

  • Trade-off 1 — mitigation: ...
  • Trade-off 2 — mitigation: ...

Implementation Notes​

Related story: NNN_story-name Implementation PR must include: Implements ADR-NNN in the PR description.

References​

  • Reference 1
  • Related: ADR-NNN — replace with a link to the related ADR once it exists