paqad-ai/runtime/base/rules/canonical-docs.md

Spec-driven development framework — AI agents that think before they type

# Canonical Docs

- Treat `docs/` as the authoritative description of current system behavior; when code and docs disagree, resolve the mismatch rather than ignoring it.
- Keep each module's docs scoped to that module and complete enough to act on without reading the source.
- Update the docs that describe an area in the same change that alters its behavior.