Release Checklist

The command sequence lives in ../SKILL.md. This covers judgment calls and failure triage.

Version policy

Minor bump by default. Patch or major only when explicitly requested or clearly justified by the release scope.

Changelog

Keep CHANGELOG.md user-facing: user-visible fixes, behavior changes, and compatibility notes rank above internal refactors.

Failure triage

• release-pretag-guard.sh fails on a non-monotonic build number: run ./scripts/bump-version.sh, commit the bump, retry.
• Release automation fails before signing: inspect workflow configuration and version metadata.
• Release automation fails during signing or notarization: inspect secret availability and Apple account status.

Asset rename

If cmux-macos.dmg is ever renamed, update every surface that assumes the releases/latest/download/cmux-macos.dmg path (README, website, updater feed, Homebrew formula).