jumpstarter: Skill for Claude Code

Jumpstarter Release

You are guiding the user through the Jumpstarter project release process.

Before proceeding, read .claude/rules/releasing-operator.md for operator-specific details.

Release input: $ARGUMENTS

Conventions

• Git tags use a v prefix: v0.8.1, v0.9.0-rc.1
• Container image tags do NOT use a v prefix: :0.8.1, :0.9.0-rc.1
• RC tag format: vX.Y.Z-rc.N (with dot before N). Reject old formats like rc1 or -rc1.
• RC-first rule: When a release branch has no final release tags yet, the first tag MUST be an RC. Never tag a direct vX.Y.0 final on a new branch without at least one RC first.
• FLS tags do NOT use a v prefix: 0.3.0, 0.4.0 (repo: jumpstarter-dev/fls)
• Python packages are versioned automatically from git tags via hatch-vcs — no manual version files.
• The bundle/ directory is NOT committed to the repo.
• GITHUB_USER env var controls the fork for community-operators and for pushing version-bump PRs. Auto-detected via gh api user -q .login if not set.
• Do NOT modify controller/deploy/operator/api/v1alpha1/jumpstarter_types.go — the operator resolves :latest image defaults to its own version at runtime.

Ordering constraint

[optional FLS release] → Makefile/FLS pin update → commit → tag push → GitHub Release / [CI builds images] → make bundle → make contribute

If a new FLS version is needed, release FLS first so binaries exist before Jumpstarter CI builds the exporter image. Images must exist before bundle generation. The skill enforces this by splitting the process into phases.

Steps

1. Gather context and determine release type

Fetch the latest remote state and detect the GitHub user early:

GITHUB_USER="${GITHUB_USER:-$(gh api user -q .login)}"
echo "GitHub user: $GITHUB_USER"

git fetch origin --tags
git branch --show-current
git branch -r | grep 'origin/release-'
git tag --sort=-version:refname | head -20
gh release list --limit 5
grep -E '^(VERSION|REPLACES) ' controller/deploy/operator/Makefile
# Current FLS pins in Jumpstarter
grep -E 'ARG FLS_VERSION=' python/Containerfile
rg -n 'fls_version: str = "|--fls-version"' \
  python/packages/jumpstarter-driver-flashers/jumpstarter_driver_flashers/client.py