AI-consumed reference. Optimized for Claude to read during execution. Human-readable explanation: see docs/architecture/HIERARCHICAL_PLANNING.md or docs/getting-started/ depending on topic.

Documentation (ADR & Runbook)

When to Create

• Runbook: Service deployment, common ops tasks, incident response
• ADR: → use skills/tech-writing + templates/decision-record.md. That template carries the full 4-tier ladder (Y-statement → Nygard ADR → MADR → RFC) and picks the tier by decision size. The stripped ADR template below is kept only so existing links keep resolving.

ADR Template