# ADR-[number]: [decision title]

> **What this teaches:** I can make a technical choice from constraints and falsifiable evidence while preserving its tradeoffs for later review.

Before comparing options, predict which constraint will dominate. Keep that prediction visible so the evidence can confirm or disprove it.

- Status: Proposed | Accepted | Superseded
- Date: YYYY-MM-DD
- Decision owner: [you]

## Context

Define the problem, constraints, and quality attributes before proposing a solution. This prevents a favorite tool from defining the problem.

[Describe the problem, constraints, quality attributes, and forces that make a decision necessary.]

## Options considered

Apply the same comparison dimensions to at least two viable options.

### Option A — [name]

- Benefits:
- Costs and risks:
- Evidence or official source:

### Option B — [name]

- Benefits:
- Costs and risks:
- Evidence or official source:

## Decision

State the choice and why it best fits the current constraints; do not claim that it is universally best.

[State the selected option and the reason it best fits the current constraints.]

## Consequences

Every decision creates benefits, costs, and future triggers. Record all three.

- Positive:
- Negative:
- Follow-up or trigger to revisit:

## Verification

[Name the cheapest test, prototype, measurement, or failure case that could show this decision is wrong.]

## Explain it back

Explain the selected option, the strongest rejected option, the tradeoff you accepted, and the observation that would make you revisit the decision.