skills/vibe-docs/SKILL.md

---
name: vibe-docs
description: "Generate evidence-backed README or design documentation, synchronize stale docs, or plan and implement a scoped migration/refactor. Preserve source ownership and existing compatibility."
---

# Documentation & refactoring

Read [the shared workflow](../../references/workflow.md) once per task, then the one recipe matching the requested operation and boundary. Do not load every recipe. The user's request controls scope and whether edits are allowed.

## Recipes

| Recipe | Operation |
|---|---|
| [DESIGN GEN](references/design-gen.md) | document |
| [Documentation Sync Audit](references/documentation-sync-audit.md) | audit |
| [Documentation Sync Polish](references/documentation-sync-polish.md) | implement |
| [Migration & Refactor Plan](references/migration-refactor-plan.md) | plan |
| [README GEN](references/readme-gen.md) | document |
| [Refactor Boundary Audit](references/refactor-boundary-audit.md) | audit |
| [Refactor Boundary Polish](references/refactor-boundary-polish.md) | implement |

For an explicit multi-stage request, follow the necessary stages without discarding requested work. For a single stage, deliver that result and stop. Use [the catalog](../../references/catalog.md) only if the requested boundary belongs elsewhere.