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: Reads all Markdown docs and cross-references them against the branch diff to find stale features, paths, counts, and commands. - Safe auto-updates with guardrails: Applies factual corrections directly while asking the user about narrative, security, or large rewrite decisions. - CHANGELOG voice polish and VERSION check: Polishes changelog wording without clobbering entries, cleans up TODOS, and confirms version bump decisions via prompts. - Use Case: After merging a feature branch that adds a new CLI command, run this Skill to update the README feature table, fix the project structure section in CLAUDE.md, polish the CHANGELOG entry, and commit the doc updates to 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.
