| name | release |
| description | Execute the Gridix release checklist from bump to publish. Use when asked to release, bump version, publish a release, or tag a version. |
| paths | ["Cargo.toml","docs/CHANGELOG.md"] |
Release process
Tag-triggered: push v* tag → CI builds + publishes all artifacts.
All commands from repo root.
1. Pre-release checks
cargo fmt --check && cargo clippy --all-targets --all-features -- -D warnings && cargo test && python scripts/check_doc_links.py
2. Version bump
Edit Cargo.toml:
version = "X.Y.Z"
3. Changelog
Update docs/CHANGELOG.md — version header, date, categorized bullets (bilingual).
4. Related docs
Shortcut changes → update /keybindings skill. Config changes → update CLAUDE.md. Cross-check docs/CHANGELOG.md.
5. Commit + push (branch first, then tag)
git add Cargo.toml Cargo.lock docs/CHANGELOG.md
git commit -m "release: vX.Y.Z"
git push origin master
Wait for CI: gh run list --workflow build.yml --limit 3
6. Tag → trigger release
git tag vX.Y.Z
git push origin vX.Y.Z
Monitor: gh run list --workflow release.yml --limit 3
7. Verify artifacts
gh release view vX.Y.Z
gh release download vX.Y.Z -p SHA256SUMS.txt -D /tmp/gridix-release
Expected: gridix-linux-x86_64.tar.gz, gridix-windows-x86_64.zip, gridix-macos-arm64.tar.gz, gridix.AppImage, SHA256SUMS.txt.
8. Distribution sync (post-release, manual)
Order: AUR (gridix → gridix-bin → gridix-appimage) → Homebrew → nixpkgs.
Get checksums
VERSION=X.Y.Z
gh release download "v${VERSION}" -p SHA256SUMS.txt -D /tmp/gridix-release
curl -L "https://github.com/MCB-SMART-BOY/Gridix/archive/refs/tags/v${VERSION}.tar.gz" -o /tmp/gridix-release/source.tar.gz
sha256sum /tmp/gridix-release/source.tar.gz
AUR (3 packages)
cd _work_aur_gridix
cd _work_aur_gridix_bin
cd _work_aur_gridix_appimage
Homebrew
cd _work_homebrew_gridix
git add Formula/gridix.rb && git commit -m "gridix vX.Y.Z" && git push origin master
nixpkgs
Update pkgs/by-name/gr/gridix/package.nix: version, src.hash, cargoHash. If new: also add maintainers/maintainer-list.nix entry.
cd _work_nixpkgs
nix-build -A gridix
Verify
- AUR PKGBUILD + .SRCINFO consistent
- Homebrew formula URL + hash match release assets
- nixpkgs build succeeds
Rollback
If severe issue: publish hotfix with incremented patch, mark broken release, update changelog.