# docs/adr/

Accepted architecture decision records (ADRs).

## What belongs here

- Final, accepted architectural decisions that affect the project.
- Decisions that have been promoted from `.sf/DECISIONS.md`.

## What does NOT belong here

- Draft decisions still under discussion.
- Implementation plans (use `docs/plans/`).
- Specifications (use `docs/specs/`).

## Naming convention

`0001-<slug>.md` — zero-padded four digits, auto-numbered by `sf plan promote --to docs/adr`.

## See also

- [AGENTS.md#sf-planning-state](../AGENTS.md#sf-planning-state)