Skip to content

ADR-NNNN: Short decision title

Context

What situation forced this decision? What constraints (time, cost, team, legal, technical) shaped it? What was the state before?

2-3 paragraphs. Name names, cite numbers, link evidence. Future readers should be able to understand the pressure without reconstructing it from memory.

Decision

One crisp sentence stating what we chose. Then 1-2 paragraphs of specifics: what changes, what we commit to, what we're deliberately NOT doing.

Alternatives considered

  • Option A — brief description. Why we didn't pick it.
  • Option B — brief description. Why we didn't pick it.
  • Option C (chosen) — brief description. Why we picked it.

If you only considered one option, say so and explain why. A decision with no alternatives usually means the question wasn't framed sharply enough.

Consequences

What gets easier

  • ...

What gets harder / what we give up

  • ...

What this commits us to (reversibility cost)

  • ...

Risks & mitigations

  • Risk — mitigation
  • Links to Slack threads, emails, PRs, external articles that informed the decision
  • Relevant data or numbers

Review

  • Next review: YYYY-MM-DD (suggest 6-12 months)
  • Triggers to revisit early: conditions that would force reconsideration (e.g., "if CAC exceeds $X", "if marketplace revenue share exceeds 30%")