# Docs Workflow Instructions

Use this file when improving onboarding, runbooks, architecture docs, summaries, or documentation tied to code behavior.

Read first:

1. existing repo authority
2. promoted canonical docs
3. `.agent/project.yaml`
4. `.agent/checks.yaml`
5. `.agent/roles/docs-specialist.md`
6. latest handoff or reconcile when docs are part of a broader phase

Keep docs honest:

- repo authority beats generated overlays
- document proven behavior separately from structurally supported or unproven behavior
- surface docs-to-code mismatches explicitly
