| .. | ||
| README.md | ||
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