What problem does it solve?
Keep project documentation accurate and aligned with code after feature additions, CLI changes, new config keys, interface modifications, or behavioral fixes. This Skill prevents documentation drift by discovering the project's doc surface, identifying owning documents, and orchestrating precise, validated edits rather than making ad-hoc changes.
Core Features & Use Cases
- Dynamic doc discovery: Locates docs roots, internal specs, public guides, generated files, memory, and repo-specific skills without assuming fixed paths.
- Change classification and ownership: Classifies the type of code change and maps which files or doc areas own the change.
- Agent-orchestrated edits: Plans agent-sized tasks, spawns Sonnet agents with focused prompts that grep and validate before editing, and enforces rules such as not editing generated files and committing changes (do not push).
- Validation and regeneration: Verifies no stale references remain via grep and triggers regeneration scripts for generated artifacts when needed.
- Use Case: After adding a new CLI flag and config key, run this orchestrator to update CLI reference, spec, default config, and any derived skills that reference the changed flag.
Quick Start
Run the update-documentation orchestrator after finishing implementation to discover docs, plan targeted edit tasks, spawn Sonnet agents to perform validated edits, and commit the documentation updates.
