document-release

Sync README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md with shipped changes.

1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/LaPaGaYo/nexus --skill document-release-lapagayo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-release
Source: https://github.com/LaPaGaYo/nexus/tree/main/skills/support/document-release
Command: npx skills add https://github.com/LaPaGaYo/nexus --skill document-release-lapagayo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post-ship documentation updates require aligning multiple docs with what shipped. This Skill reads project docs, cross-references diffs, and updates README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md to match shipped changes. It also polishes the CHANGELOG voice, cleans up TODOS, and can optionally bump the version.

Core Features & Use Cases

  • Syncs README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md with shipped changes
  • Polishes CHANGELOG language and tone for release readability
  • Cleans up TODOS to reflect current project state
  • Optionally bump VERSION to align with new release
  • Use case: after a PR merge or release to ensure docs reflect code and governance artifacts

Quick Start

Run after a ship or PR merge to sync docs and polish release notes.

Frequently Asked Questions about document-release

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

FAQPage Schema
How do I sync README and CLAUDE.md with shipped code changes after a release?

To automate documentation updates, run a post-ship docs sync process that cross-references code diffs and aligns README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md with the merged changes.

What is the best way to polish a CHANGELOG after merging a pull request?

Polishing a CHANGELOG after a PR merge involves reviewing the shipped changes, refining the release notes language and tone for readability, and cleaning up TODOS to reflect the current project state.

Can I automatically bump the VERSION file when updating project documentation?

Yes, you can optionally bump the VERSION file during the documentation sync process to align the version number with the new release and the updated core project docs.

When do I need to update ARCHITECTURE and CONTRIBUTING docs?

You need to update ARCHITECTURE and CONTRIBUTING docs after a ship or PR merge when structural changes occur, ensuring governance artifacts and architecture descriptions reflect the actual shipped code.

Does post-ship docs sync work without external dependencies?

Yes, the post-ship documentation sync runs without external dependencies, reading project docs and cross-referencing diffs internally to align README, CLAUDE.md, and other files with the shipped state.