📝 Templates

Copy the template for the document type you're writing. Fill in every field — don't leave placeholders.

Template	Use for
PRD / Spec	Product requirements, feature specs
RFC	Significant change proposals
ADR	Architecture/technical decisions
Decision	Product or business decisions
Design Spec	UX/UI design specifications
Runbook	Operational playbooks

Golden rules

1. Every doc has an owner. No owner = no one updates it.
2. Status is mandatory. Draft, In Review, Approved, Deprecated.
3. Short > long. A 1-page doc that's read beats a 10-page doc that isn't.
4. Link, don't duplicate. Link to the ADR instead of re-explaining the decision.
5. AI-assisted docs must include ai_assisted: true and be reviewed before Approved.