Skip to content

Add a Claude skill for cutting State Tool releases - #3861

Open
icanhasmath wants to merge 2 commits into
masterfrom
marcg/release-state-tool-skill
Open

icanhasmath wants to merge 2 commits into
masterfrom
marcg/release-state-tool-skill

Conversation

@icanhasmath

@icanhasmath icanhasmath commented Oct 22, 2026 •

Copy link
Copy Markdown
Collaborator

Adds .claude/skills/release-state-tool/SKILL.md, the release procedure as learned while cutting 0.48.2-RC1 (PROD-240). It's separate from the release PRs.

Work in progress. Steps 0–6, up to merging the release PR into beta, were done for real on #3863, #3865, #3866 and #3864. Steps 7–10 (staging, Windows signing, promotion, verification, merge-back) come from the CI config and haven't been run yet. This PR will be updated once they have, so please don't merge it until then.

What it records:

  • The base: continue the last release's version branch (version/0-48-1-RC4 + version.txt bump = version/0-48-2-RC1) and cherry-pick the master changes that ship. Don't merge master, which has drifted, and don't branch from beta.
  • What ships: master's first-parent commits since the last Merge branch 'version/...', not beta..master.
  • version/* is protected: direct pushes and "Update branch" are refused, so every change goes in as a PR.
  • Syncing with beta: a PR that merges beta in, merged with a merge commit, so the release PR isn't BEHIND.
  • CI failures from 0.48.2 and their fixes: the check-format bug on an empty diff, the Scan/Trivy CVE gate (it blocks Deploy) and how to bump Go and dependencies for it, the keypair test flake after the Go bump, and the macOS sysinfo timing flake.
  • Local checks (constants generation, -vet=off, running Trivy locally), CI tooling quirks, and the S3 checks to run before and after.

Needs input: step 8 (signing the Windows binaries). @mitchell-as, could you describe it here?

Records the release flow (master after the last beta merge-back ->
release branch -> beta -> release), the changelog convention, and the
post-merge staging, Windows signing, S3 promotion and merge-back steps.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@icanhasmath icanhasmath mentioned this pull request Oct 22, 2026
Releases continue the last RC branch with cherry-picks from master; they
are not cut from master or beta. Records the protected version branches,
the beta sync merge, the CI failures hit on 0.48.2 and their fixes, the
Trivy scan gate, CI tooling quirks, and the S3 checks. Steps after the
beta merge are marked unverified.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant