# Contract docs

Cross-cutting interface detail shared by capabilities.

Rules (`docs/STRUCTURE.md`): a contract doc **cites** requirement IDs from `docs/REQUIREMENTS.md`; it never defines or restates them.

Expected files (Phase 2 migration):

- `API.md` — FastAPI HTTP contract (from tag `OPENAPI.md`)
- `DATA-MODEL.md` — SQLite schema and status machine (from tag `DATA-MODEL.md`)
- `UX.md` — screens, field recovery, outcomes (from tag `UX.md`)
- `PROMPTS.md` — Call 1 / Call 2 prompt text (from tag `PROMPTS.md`)
- `TEST-SPEC.md` — test pyramid, vectors, dishonest proxies (from tag `TEST-SPEC.md`)
- `CONTENT-WOO.md` — listing copy and Woo payload detail (migrated from `docs/CONTENT-WOO.md`)

Template: `docs/_templates/contract.md`.