Docs Audit

Audit structure mechanically, then verify semantic drift against relevant source files.

Procedure

1. Run scripts/check_docs.py <project-root>.
2. Read docs/index.md, then only files implicated by findings.
3. Compare behavior claims with code, tests, configuration, and explicit decisions.
4. Fix issues when authorized; otherwise report the smallest actionable set.
5. Re-run the checker after changes.

Review Rules