| name | docs-maintenance |
| description | Update or review documentation safely in this repo. Use when renaming Markdown files, updating mkdocs navigation, fixing doc links, modernizing prompt packs, or enforcing lowercase kebab-case doc naming. |
| argument-hint | [docs task] |
| disable-model-invocation | true |
Before starting: git fetch origin && gh pr list --state open && git log origin/main --oneline -3 — if another agent has an open PR touching the same files you need, wait for it to merge or branch off it instead of main.
Complete this docs task: $ARGUMENTS
Follow these rules:
- prefer lowercase kebab-case for new Markdown filenames unless the ecosystem requires a convention filename
- when renaming docs, update relative links and
mkdocs.yml
- keep prompt packs aligned to current repo structure and current config ownership
- avoid broad rewrites unless the task explicitly asks for them
Before finishing, verify that no obvious stale links or filename references remain in the touched area.