xcode-release-skill

Automate Xcode TestFlight releases with multi-agent review. Bumps build number, generates changelog, runs pre-release checks, and pushes to trigger CI.

claude skill install hksw-io/xcode-release-skill

Quick start

/xcode-release

That's it. The skill handles everything automatically: pre-flight checks, release readiness debate, format/lint/build/test, build bump, changelog, commit, and push.

What happens

1. Pre-flight -- verifies clean working tree, correct branch (master), remote up to date
2. Read state -- current build number (agvtool), marketing version, last changelog entry
3. Identify changes -- NET diff since last build (reverted changes excluded from changelog)
4. Release readiness debate -- multi-agent review of the diff for data migration safety, bugs, regressions, and release blockers. Depth scales by complexity: quick for cosmetic changes, deep for schema/migration changes. Produces a go/no-go recommendation
5. Pre-release gate -- make format, make lint, make build, make test across the entire app
6. Bump build number -- agvtool new-version (only after checks pass)
7. Generate changelog -- conventional format with platform scope and cross-checked against the diff
8. Commit and push -- stages all modified files (including format auto-fixes), pushes to master
9. Monitor -- reports the CI run URL after push

Key design decisions

• Build bump after checks -- if checks fail, no build number is wasted
• Debate before mutations -- a no-go leaves the working tree clean
• Full-app validation -- checks run against the entire app state, not just recent changes
• Stages format fixes -- make format auto-fixes are staged automatically, preventing CI divergence
• Fix forward -- never revert a build bump; fix and re-push under the same number

Requirements

• Xcode project using agvtool for build number management
• A Makefile with format, lint, build, and test targets (or equivalent CI config)
• debate-skill -- required for release readiness review
• GitHub CLI (gh) -- for post-push CI monitoring
• CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 in Claude Code settings

License

MIT