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, classifying fixes as safe auto-updates or changes requiring user approval. - CHANGELOG voice polish and coverage mapping: Scores CHANGELOG entries with a sell-test rubric, builds a Diataxis coverage map (reference/how-to/tutorial/explanation), and detects architecture diagram drift. - Release bookkeeping: Cleans up TODOS.md, optionally bumps VERSION, 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 post-ship docs pass to update the README feature list, polish the CHANGELOG entry, and surface undocumented new flags in the PR body. ## Quick Start Ask the assistant to update the docs and sync documentation for the changes shipped on this branch.
