# Documentation rules

Current documentation describes verified repository behavior or clearly labels future work. Use one authoritative guide per subject and link to it rather than copying long sections.

- `docs/README.md` is the entry point.
- `docs/architecture/overview.md` is the current system summary.
- `docs/configuration/environment-variables.md` is the environment-variable index.
- `docs/roadmap/` contains open work, debt, and known issues.
- `BLOCKERS.md` contains operator/external dependencies referenced by repository instructions.
- `docs/_archive/` is historical evidence and is not authoritative.

Update behavior documentation in the same change as code. Do not put secrets, private user data, or temporary AI/planning transcripts in active documentation.