decompose: Skill for Claude Code

You are helping the user cut a new release of decompose.

Version format

The crate uses SemVer. Cargo rejects PEP 440 syntax (0.1.0a1 is not valid). Use:

• Stable: 0.1.0, 0.2.0, 1.0.0
• Pre-release: 0.1.0-alpha.1, 0.1.0-beta.1, 0.1.0-rc.1

The git tag is always v + the version, e.g. v0.1.0-alpha.1.

Args

The user invokes this skill with the target version as the argument, e.g. /release 0.1.0-alpha.1. If no argument is given, ask the user which version to cut before doing anything else. Validate the version is SemVer.

Steps

Execute these in order. Stop and ask the user if anything is surprising.

1. Preflight

Run these checks in parallel. Abort if any fails.

git status --porcelain              # must be empty (clean tree)
git rev-parse --abbrev-ref HEAD     # must be "main"
git fetch origin main               # sync refs
git rev-list --count HEAD..origin/main  # must be 0 (up to date with remote)
git rev-list --count origin/main..HEAD  # must be 0 (no unpushed commits)

Check CI is green on the current HEAD:

gh run list --branch main --limit 1 --json conclusion,status,headSha

The most recent run on main must have conclusion == "success" and headSha matching current HEAD. If it's still running (status == "in_progress"), ask the user whether to wait or proceed. If it's failing, abort.

2. Determine version and previous tag

• Current version: read the version = "..." line from Cargo.toml.
• Target version: from the skill args (validated above).
• Previous tag: git describe --tags --abbrev=0 2>/dev/null -- may be empty for the first release.

Confirm to the user: "Cutting release: current={current}, target={target}, previous tag={tag or none}. Proceed?" Do not take any irreversible action until they confirm.

3. Bump Cargo.toml

Use Edit to change the version = "..." line in Cargo.toml to the target version. Then run cargo build --locked to refresh Cargo.lock. (If --locked fails because the lockfile needs updating, run cargo build without --locked once, then re-run with --locked to verify.)