ADR Template

Copy into docs/adrs/adr-NNN-short-title.md. ADRs are immutable once Accepted — if you change your mind, write a new ADR that supersedes this one.

---

---
id: adr-NNN-short-title
title: "ADR-NNN: Short title"
description: "One-sentence summary of the decision"

status: proposed        # proposed | accepted | deprecated | superseded
date: YYYY-MM-DD
deciders: ["@handle", "@handle"]
supersedes: null        # ADR-NNN if this replaces a previous decision
superseded_by: null     # ADR-NNN if a later decision replaces this
---

# ADR-NNN: Short Title

<div style={{display:'flex',gap:'0.5rem',marginBottom:'1.5rem'}}>
  <span className="badge badge--draft">Proposed</span>
  <span className="badge badge--secondary">YYYY-MM-DD</span>
</div>

## Context

What is the situation that requires a decision? What forces are at play?
(technical constraints, team size, timeline, cost, existing systems)

## Decision

**We will [chosen option].**

One clear sentence stating what was decided.

## Rationale

| Option | Pros | Cons |
|---|---|---|
| ✅ Chosen option | ... | ... |
| ❌ Option B | ... | ... |
| ❌ Option C | ... | ... |

Why this option over the alternatives?

## Consequences

**Positive:**
- Benefit 1
- Benefit 2

**Negative / trade-offs:**
- Trade-off 1
- Risk 1

**Neutral:**
- Impact that is neither good nor bad

## Revisit trigger

Under what conditions should this decision be re-evaluated?
(e.g., "If we exceed X users", "If vendor Y raises prices by Z%")

---

*Decided by @handle and @handle on YYYY-MM-DD.*