What problem does it solve? After shipping code, project documentation (README, ARCHITECTURE, CONTRIBUTING, CHANGELOG, TODOS) often drifts out of sync with what actually shipped. This Skill audits every doc against the release diff and brings them back into alignment. ## Core Features & Use Cases - Per-file documentation audit: Cross-references README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md against the git diff, auto-applying factual fixes and asking before risky narrative changes. - Diataxis coverage map and CHANGELOG polish: Builds a reference/how-to/tutorial/explanation coverage map, detects architecture diagram drift, and polishes CHANGELOG voice with a sell-test rubric without clobbering existing entries. - Release bookkeeping: Cleans up TODOS.md, optionally bumps VERSION with explicit confirmation, commits doc changes, and updates the PR/MR body and title with a documentation debt summary. - Use Case: After merging a feature branch, run the skill to sync all docs with the shipped diff, surface undocumented public surface as documentation debt in the PR body, and commit the updates. ## Quick Start Ask the assistant to update the docs and sync documentation for everything that shipped on this branch.
