Skip to content

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

Merged
icanhasmath merged 2 commits into
masterfrom
marcg/release-state-tool-skill
Nov 2, 2026
Merged

icanhasmath merged 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.

Steps 0–10 were all done for real on the 0.48.2 beta (#3863, #3865, #3866, #3864, then staging, signing, promote and verify, 2026-10-23 to 10-26). Two things haven't been run with it yet: the merge back into master and the stable (beta → release) path.

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. The release PR itself is squash-merged, so each release repeats this.
  • 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, the macOS sysinfo timing flake and the Windows internal/hail TestOpen flake.
  • Staging: what Deploy stages, and that the served version drops -RCn (0.48.2-SHA89954c6).
  • Windows signing: the TI team signs the four exes in the update zip (PROD-1352). How to check the returned zip, then put it in place and update the sha256 in both Windows info.json files, since the updater checks it. Remove TI's sign/ folder before promoting.
  • Promote: run it from a clean beta checkout after generating the constants (otherwise it fails with undefined: constants.ChannelName). It moves everything under staging/.
  • Verify: query the update service for every platform, check the production Windows zip's hash and signatures, and run the downloaded Linux binary.
  • Local checks (constants generation, -vet=off, running Trivy locally) and CI tooling quirks.

@icanhasmath icanhasmath mentioned this pull request Oct 22, 2026
Adds .claude/skills/release-state-tool/SKILL.md, written from the
0.48.1 and 0.48.2 releases: RC branches off beta, fix-up RCs, staging,
TI signing of the Windows build, promote, post-promote verification
(with updates disabled), and merging beta back into master.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@icanhasmath
icanhasmath force-pushed the marcg/release-state-tool-skill branch from bdf0423 to 8b4ab16 Compare November 2, 2026 20:06
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@icanhasmath
icanhasmath requested a review from MDrakos November 2, 2026 20:20

@MDrakos MDrakos left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very nice!

@icanhasmath
icanhasmath merged commit cc320b4 into master Nov 2, 2026
12 checks passed
@icanhasmath
icanhasmath deleted the marcg/release-state-tool-skill branch November 2, 2026 21:27
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.

2 participants