Release

Release & CHANGELOG

Trigger phrases: "release", "cut a release", "changelog", "version bump", "bump the version", "new version", "tag", "semver"

SemVer mapping (derive from Conventional Commits)

• fix: → PATCH (x.y.Z)
• feat: → MINOR (x.Y.0)
• BREAKING CHANGE: / feat!: → MAJOR (X.0.0)

CHANGELOG (Keep a Changelog)

Headings: Added · Changed · Fixed · Removed · Security · Deprecated. Every version is dated; the Unreleased section can be auto-populated from commits.

Pre-release gates (all must pass)

• [ ] Tests green + sonarqube-check PASSED
• [ ] dependency-audit clean (0 HIGH/CRITICAL)
• [ ] CHANGELOG up to date
• [ ] Version number conforms to SemVer
• [ ] The release commit is a diff too (§4.6). A chore(release) bump, a CHANGELOG-only edit and a docs-site

version touch each stage a diff, and §4.6 exempts nothing by size — crew-review-agent runs over them like any other. A version that disagrees with the tag, a CHANGELOG entry naming the wrong one, a generated manifest edited by hand: that is what this review is for, and all three have shipped before.

• [ ] Every distribution channel has a documented way to GET this version. Publishing and reaching users are

different events. A channel whose consumers pin at install time — an editor extension, a plugin, a vendored copy — leaves them on the version they installed until they ask for a new one, so a security fix ships and does not arrive. For each channel name the upgrade command in the README, and say plainly where it is not automatic.

Tagging

git tag -a vX.Y.Z -m "vX.Y.Z"    # asks for approval (§4.4); push on explicit request (§4.5)

DoD

• Correct SemVer bump; complete CHANGELOG; tag + rollback plan ready.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: crewforth
• Source: crewforth/crewforth
• License: MIT
• Homepage: https://crewforth.com/

Install and usage instructions live in the source repository linked above.