ossrules.md

cmux-release Skill

cmux release workflow, version bumping, changelog updates, pretag guard, release tags, and release asset expectations. Use when preparing or troubleshooting a cmux release.

Install
npx skills add 'https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-release'
Download bundle ↓

references/release-checklist.md

references/release-checklist.mdBrowse 3 files
View on GitHub
205 tokens

951 bytes
Token encoding: o200k_base
Snapshot 6f118af

← Back to SKILL.md

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).

Referenced from SKILL.md
SKILL.mdView in source ↗
Source excerpt starting at line 41.
- [references/release-checklist.md](references/release-checklist.md): changelog tone, failure triage, and asset-rename fallout.
← All cmux skillsProject instructions →