Skip to main content

ADR NNNN: Short Title Describing the Decision

  • Status: 🟡 Proposed / ✅ Accepted / 🗃️ Superseded by #NNNN / ❌ Rejected
  • Date: YYYY-MM-DD
  • Deciders: @handle1, @handle2
  • Tags: infrastructure, frontend, data-model, etc.

Context​

What's the situation that forced this decision? What constraints or forces are at play? Write like you're explaining to someone who wasn't in the room.

  • Constraint 1
  • Constraint 2
  • Constraint 3

Options Considered​

Option A — [name]​

  • Pros: …
  • Cons: …
  • Cost: …

Option B — [name]​

  • Pros: …
  • Cons: …
  • Cost: …

Option C — [name]​

  • Pros: …
  • Cons: …
  • Cost: …

Decision​

We will [do X].

A short paragraph stating the decision clearly. Include the rationale in one or two sentences — why this option beat the others, specifically.

Consequences​

Positive​

  • Consequence 1
  • Consequence 2

Negative​

  • Tradeoff 1
  • Tradeoff 2

Neutral​

  • Side effect 1

Follow-up Actions​

  • Task 1
  • Task 2

References​

  • Link to prior discussion / PR / Slack thread
  • Related ADRs: #NNNN