Release Management Skill
Purpose
To automate the software release cycle, ensuring proper Semantic Versioning, Changelog maintenance, and Git tagging conventions.
Rules
- •
Semantic Versioning (SemVer):
- •Analyze commits since the last tag.
- •
fix(...)-> Patch bump (e.g., 1.0.0 -> 1.0.1). - •
feat(...)-> Minor bump (e.g., 1.0.0 -> 1.1.0). - •
BREAKING CHANGEor!:-> Major bump (e.g., 1.0.0 -> 2.0.0). - •Action: Ask user to confirm the calculated version (e.g., "Bump from 1.0.0 to 1.1.0?").
- •
Changelog Management:
- •MUST maintain a
CHANGELOG.mdfile following the Keep a Changelog format. - •Group changes by:
- •
Addedfor new features. - •
Changedfor changes in existing functionality. - •
Deprecatedfor soon-to-be removed features. - •
Removedfor now removed features. - •
Fixedfor any bug fixes. - •
Securityin case of vulnerabilities.
- •
- •Insert the new version section at the top of the changelog (below the Title).
- •MUST maintain a
- •
Release Artifacts:
- •Update
versioninpackage.json(andapps/*/package.jsonif necessary). - •Create a Git Tag:
git tag -a v1.1.0 -m "Release 1.1.0". - •Push Tag:
git push origin v1.1.0.
- •Update
- •
GitHub Release (MCP):
- •If GitHub MCP is available, create a Draft Release with the generated changelog content using the
github_create_releasetool or similar. - •If no MCP is active, simply finish after the git tag push.
- •If GitHub MCP is available, create a Draft Release with the generated changelog content using the