# docs/specs/

Durable specifications and contracts.

## What belongs here

- Long-lived spec documents describing behavior contracts, APIs, or protocols.
- Documents that outlive any single implementation plan.

## What does NOT belong here

- Architecture decisions (use `docs/adr/`).
- Implementation plans (use `docs/plans/`).

## Naming convention

`<topic>.md` — e.g., `promote-command-spec.md`

## See also

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