# docs/

Reviewed and accepted documents. Everything here has passed human review.

## What goes here

| Type | Naming | Example |
|---|---|---|
| PRD / feature spec | `{date}-prd-{title}.md` | `20260401-prd-product-level-indicators.md` |
| Detail design | `{date}-design-{title}.md` | `20260331-design-agent-era-infrastructure-v2.md` |
| Test plan | `{date}-test-{title}.md` | `20260415-test-cmek-m2.md` |
| Architecture decision | `{date}-adr-{title}.md` | `20260405-adr-ticat-vs-cobra.md` |
| Project decision | `{date}-decision-{title}.md` | use only for durable reviewed decisions |
| Operator guide | `{date}-get-started-{title}.md` | use only for durable reviewed guides |

## Workflow

1. Agent produces a draft (design doc, test plan, etc.)
2. Human reviews and approves
3. Approved doc is committed here with date-prefixed filename
4. Doc is referenced in the corresponding GitHub issue

## What does NOT go here

- Work-in-progress drafts (keep in PR description or issue comments)
- Auto-generated docs (those live next to code, e.g., `--help` output)
- Meeting notes or ad-hoc discussions
- Agent/human workflow skills (those live under `skills/`, e.g., `skills/get-started/SKILL.md`)