document-release

Align project documentation with shipped code changes after PR merges.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/Ulanxx/mzstack --skill document-release-ulanxx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-release
Source: https://github.com/Ulanxx/mzstack/tree/main/document-release
Command: npx skills add https://github.com/Ulanxx/mzstack --skill document-release-ulanxx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post-ship documentation drift: after code ships, docs often become outdated. This skill reads project docs, cross-references diffs, updates READMEs, ARCHITECTURE docs, CONTRIBUTING, and CLAUDE.md to reflect what shipped, polishes CHANGELOG voice, cleans up TODOS, and optionally bumps VERSION.

Core Features & Use Cases

  • Auto-diff: cross-reference diffs and refresh docs to align with shipped changes.
  • Polishing: refine CHANGELOG voice and TODOs.
  • Version bump: optionally bump VERSION after shipping.

Quick Start

Run the document-release skill after a PR ships to automatically align documentation with the released changes.

Frequently Asked Questions about document-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically update README and ARCHITECTURE docs after a release?

To update README and ARCHITECTURE docs after a release, you can automate post-ship documentation alignment by cross-referencing code diffs to refresh shipped content. This ensures project docs accurately reflect the latest merged changes.

What is the best way to prevent documentation drift after merging a PR?

Preventing documentation drift involves automatically cross-referencing shipped code diffs with existing project docs. This process updates README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md files to ensure they match the released codebase.

How do I polish a CHANGELOG and clean up TODOs following a version bump?

Polishing a CHANGELOG and cleaning up TODOs after a version bump can be automated by refining the CHANGELOG voice and tidying TODO entries. This runs as part of a post-ship workflow to ensure clear release notes.

Can I automatically bump the VERSION file when code is released?

Yes, you can automatically bump the VERSION file when code is released. The post-ship documentation workflow includes conditional prompts for version changes, allowing an optional version bump after a PR is merged.

Does post-ship documentation sync work with my git state and PR lifecycle?

Post-ship documentation sync coordinates directly with your repo's git state and PR lifecycle. It enforces a plan-driven workflow with telemetry logging and contributor-mode hooks to update docs after a PR ships.

When should I not automate post-ship documentation updates?

You should not automate post-ship documentation updates if your project lacks a plan-driven workflow or git state coordination. The process relies on cross-referencing diffs and requires telemetry logging and contributor-mode hooks to function correctly.