What problem does it solve?
After code is shipped or a PR is merged, project documentation often falls out of sync, leading to outdated READMEs, architecture drift, missing changelog entries, and undocumented changes that confuse users and contributors. This Skill eliminates that manual, error-prone work by automatically aligning all project docs with what actually shipped.
Core Features & Use Cases
- Cross-Doc Sync: Automatically updates README, ARCHITECTURE, CONTRIBUTING, and AGENTS.md files to match shipped code changes by cross-referencing code diffs against existing documentation.
- Coverage Mapping: Builds a Diataxis (reference/how-to/tutorial/explanation) coverage map to identify gaps in your documentation suite.
- Debt Surfacing: Detects architecture diagram drift, polishes CHANGELOG voice, cleans up stale TODOs, and surfaces all documentation debt directly in the PR body for easy tracking.
- Use Case: After merging a PR that adds a new local business finder feature to your marketing tool, this Skill automatically updates the feature list in the README, adds the new API to the architecture docs, and notes missing tutorial content for the new feature in the PR.
Quick Start
Use the document-release skill to sync all project documentation with the changes from the most recently merged PR.