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 git diff and brings them back into alignment before a PR merges. ## Core Features & Use Cases - Diff-driven doc audit: Reads all Markdown docs in the repo and cross-references them against the branch diff to find stale descriptions, wrong counts, and outdated paths. - Auto-update with guardrails: Applies clear factual fixes directly (tables, version numbers, file paths) while asking the user before narrative, security, or large rewrite changes. - CHANGELOG voice polish: Rewords existing CHANGELOG entries to lead with user value without ever deleting or regenerating entries. - TODOS and VERSION management: Marks completed TODO items, flags new deferred work, and asks before any version bump. - Use Case: After merging a feature branch that added a new command, run this Skill to update the README feature table, fix the skill count in CLAUDE.md, polish the CHANGELOG entry, and confirm the VERSION bump covers all changes. ## Quick Start Ask the assistant to run the document-release workflow to sync all project docs with the changes on the current feature branch.
