# ADR-[number]: [decision title]

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

Superseded means a newer decision replaced this one.

## Context

Before you propose an answer, describe the problem, the limits, and the qualities that matter, like speed, cost, or safety. This stops a favorite tool from defining the problem.

[Describe the problem, the limits, the qualities that matter, and the pressures that force a decision.]

## Options considered

Compare at least two real options using the same points.

### Option A — [name]

- Benefits:
- Costs and risks:
- Proof or official docs:

### Option B — [name]

- Benefits:
- Costs and risks:
- Proof or official docs:

## Decision

Say what you chose and why it fits the current limits best. Don't claim it is best everywhere.

[State the option you picked and why it fits the current limits best.]

## Consequences

Every decision brings benefits, costs, and future triggers. Write down all three.

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

## How to test this decision

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

---

## About this template

An ADR is an architecture decision record. It is one page that saves a technical choice, the options you weighed, and what it costs you later.

> **What this teaches:** I can make a technical choice from my limits and from proof that could show I'm wrong. I save the tradeoffs for later review.

Before you compare options, guess which limit will matter most. Keep that guess visible so the proof can confirm it or knock it down.

Use this template only after a week page names the exact `.md` path inside the repo. Before it asks you to write, that block must print an **EXACT RECORD FILES** panel. The panel shows the complete commands to create, open, save, read back, and commit the file. If the block does not name the path and show that panel, stop. Don't invent a file.

**Explain it back:** Explain the option you picked, the strongest option you rejected, and the tradeoff you accepted. Then name the thing you could see that would make you rethink the decision.

**Delete this whole section once you have filled the document in.** What is left should read as a finished document on its own.