What problem does it solve? After shipping code, project documentation like README, ARCHITECTURE, CONTRIBUTING, and CHANGELOG often drifts out of sync with what actually shipped. This Skill audits every documentation file against the branch diff and brings them back into alignment before a PR merges. ## Core Features & Use Cases - Diff-driven doc audit: Cross-references the git diff against README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, and other Markdown files, auto-applying factual corrections and asking before risky narrative changes. - CHANGELOG voice polish and TODOS cleanup: Rewords existing CHANGELOG entries into user-forward language without altering content, marks completed TODO items, and captures new deferred work found in the diff. - Version and PR integration: Prompts before any VERSION bump, commits doc updates, pushes the branch, and appends a Documentation section with a doc diff preview to the PR body. - Use Case: After merging a feature branch that adds a new command, run this Skill to update the README feature table, fix stale setup steps in CONTRIBUTING, polish the CHANGELOG entry, and commit everything as a single docs commit on the PR. ## Quick Start Ask the assistant to run the document-release workflow to sync all project documentation with the changes on the current feature branch.
