| name | docs-auto-sync |
| description | Automatically update repository documentation whenever code changes (add/edit/refactor) occur. Use when modifying source code, public APIs/contracts, rendering/interaction/data/compute logic, diagnostics, or build/release/CI flows so docs stay consistent without asking. |
Docs Auto Sync
Overview
Keep documentation in sync with code changes by updating the required docs in the same change set. Default to automatic updates; only ask if a required detail is missing.
Workflow
- Classify the change scope.
- Identify layers touched (core/rendering/interaction/data/compute/api/diagnostics/ci/packaging).
- Note any contract, lifecycle, or budget changes (see
AGENTS.md).
- Choose docs to update.
- Use
references/doc-impact-matrix.mdto map change types to docs. - If multiple layers are touched, add a short design note per
AGENTS.md. - For contract changes, add version notes and a migration note.
- Update docs automatically.
- Apply edits in the same change set.
- Add a rationale to any new doc: why it belongs in chart-engine and not quant-lab.
- Keep cross-links and references consistent.
- Validate before final response.
- Ensure doc DoD: cross-links updated, invariants/SLOs referenced, version notes added.
- Summarize which docs were updated and why.
Resources
references/doc-impact-matrix.md- change types and required docs.