Documentation System

A system for writing clear, maintainable documentation optimized for both humans and AI navigation.

Core Philosophy

1. Document logic, not syntax - Explain how things work together, not what's obvious from code
2. Progressive disclosure - Overview first, details on demand
3. AI-navigable - Clear structure so AI can find and update the right docs
4. Minimal but complete - Include what's needed, nothing more

Folder Structure

Documentation lives in docs/ with three top-level folders: