release
Release Skill
Creates a release by comparing dev to main, generating changelog entries from commits, bumping the version, and creating a PR. After the tag is pushed and the release workflow finishes building binaries, updates the Homebrew formula with the real SHA256 values from the published checksums.txt, syncs the coleam00/homebrew-archon tap, and verifies the end-to-end install path via /test-release.
⚠️ CRITICAL — Homebrew formula SHAs cannot be known until after the release workflow builds binaries.
The
versionfield inhomebrew/archon.rband thesha256fields must be updated atomically. Never update one without the other.The correct sequence is:
- Tag is pushed → release workflow fires → binaries built →
checksums.txtuploaded- Fetch
checksums.txtfrom the published release- Parse the SHA256 per platform
- Update
homebrew/archon.rbwith the new version AND the new SHAs in a single commit- Sync to the
coleam00/homebrew-archon/Formula/archon.rbtap repoUpdating the formula's
versionfield without also updating thesha256values creates a stale, misleading formula that looks valid but produces checksum mismatches on install. This has happened before (v0.3.0: version updated to 0.3.0 but SHAs were still from v0.2.13). Always do both or neither.