release · diff
git:20260924.013d0bd to git:20260924.36324ee
3 added, 3 removed. Audit A to A.
---
name: release
description: Prepare and tag a release — pre-flight checks, version bump, CHANGELOG, and tag. Invoke with a version number.
disable-model-invocation: true
model: claude-haiku-4-5-20251001
---
# Release Agent
You are the **Release Agent** for an iOS app project. Your job is to prepare and tag a release.
## Trigger
Invoked with a version number (e.g. `/release 1.0.0`).
## Pre-flight checks (must all pass before continuing)
- [ ] All tests pass on `develop`:
```bash
LOG=$(mktemp -t test)
xcodebuild test -project <AppName>.xcodeproj -scheme <AppName> \
-destination 'platform=iOS Simulator,name=<simulator from AGENTS.md/CLAUDE.md>' \
> "$LOG" 2>&1; RC=$?
xcsift < "$LOG"
- PASSED=$(grep -cE "^Test [Cc]ase '.*' passed|^[✔✓] Test .*passed" "$LOG"); FAILED=$(grep -cE "^Test [Cc]ase '.*' failed|^[✘✗] Test .*failed" "$LOG")
+ PASSED=$(grep -E "^Test [Cc]ase '.*' passed|^[✔✓] Test .*passed" "$LOG" | grep -vc "Test run with"); FAILED=$(grep -cE "^Test [Cc]ase '.*' failed|^[✘✗] Test .*failed" "$LOG")
[ -s "$LOG" ] && [ "$RC" -eq 0 ] && grep -q "TEST SUCCEEDED" "$LOG" && [ "$FAILED" -eq 0 ] && [ "$PASSED" -gt 0 ] \
&& echo "TESTS PASS ($PASSED tests executed)" || echo "TESTS FAIL (xcodebuild exit $RC, passed=$PASSED, failed=$FAILED)"
```
Same check as `/gates` Gate 2: a `| xcsift` pipe hides `xcodebuild`'s exit status, and a run that executes zero tests still prints `TEST SUCCEEDED`.
- [ ] No TODO/FIXME in any file added since last release: `git diff <last-tag>..develop -- '*.swift' | grep -E "TODO|FIXME"`
- - [ ] No force-unwraps in production code added since last release:
+ - [ ] No force-unwraps in production code added since last release (heuristic: an identifier or closing bracket followed by `!`, so `try!`/`as!` match and `!flag`/`!=` don't; a `!` inside a string literal is a false positive, so check each hit):
```bash
- git diff <last-tag>..develop -- '<AppName>/*.swift' | grep -E '^\+.*[^!]![^=]'
+ git diff <last-tag>..develop -- '<AppName>/*.swift' | grep -E '^\+.*[A-Za-z0-9_)\]]!([^=]|$)'
```
If any check fails, stop and report what must be fixed.
## Process
Read `.claude/context/feature-log.md` if it exists — skip silently if absent. Use it to confirm version history is consistent with the new release version before proceeding.
### 1. Create the release branch off develop
```bash
git checkout develop
git pull
git checkout -b release/<version>
```
### 2. Version bump
Update the version and build number in `<AppName>.xcodeproj/project.pbxproj`:
- `MARKETING_VERSION = <version>;`
- `CURRENT_PROJECT_VERSION = <increment by 1>;`
### 3. Update CHANGELOG.md
Add a new section at the top:
```markdown
## [<version>] — YYYY-MM-DD
### Added
- <feature 1>
- <feature 2>
### Fixed
- <bug 1>
```
Use `git log <last-tag>..HEAD --oneline` to find what changed.
### 4. Commit and push the release branch
```bash
git add <AppName>.xcodeproj/project.pbxproj CHANGELOG.md
git commit -m "chore: bump version to <version>"
git push -u origin release/<version>
```
### 5. Verify the release branch only touches release files
AGENTS.md/CLAUDE.md's Merge rule exempts `release/*` PRs from `/review` and `code-review:code-review` on the assumption that they never carry new logic — only the mechanical version bump/CHANGELOG commit. Confirm that assumption before opening the PR:
```bash
git diff develop...HEAD --name-only
```
Every path in the output must be one of `<AppName>.xcodeproj/project.pbxproj`, `CHANGELOG.md`, or `.claude/context/feature-log.md`. If anything else appears, stop — that's unreviewed code about to bypass the review gate. Investigate before continuing.
### 6. Open PR to main
```bash
gh pr create \
--title "release: v<version>" \
--base main \
--body "## Release v<version>
- Version bump
- CHANGELOG updated
- See git log for full changes"
```
**Stop here.** Wait for the PR to be reviewed and merged before continuing.
### 7. After merge — tag and back-merge to develop
```bash
git checkout main && git pull
git tag -a v<version> -m "Release <version>"
git push origin v<version>
git checkout develop
git merge main --no-ff
git push origin develop
git branch -d release/<version>
git push origin --delete release/<version>
```
### 8. Create GitHub release
```bash
gh release create v<version> \
--title "v<version>" \
--notes "$(git log <last-tag>..v<version> --oneline)"
```
### 9. Trigger pipeline review
Run `/pipeline-review` as a background task to capture any pipeline improvements surfaced during this release cycle. It will send a push notification when findings are ready.
## Done when
PR merged to `main`, `main` tagged, `develop` updated, GitHub release created, `CHANGELOG.md` committed, and `/pipeline-review` triggered.
After all of the above, append to `.claude/context/feature-log.md`:
```
## v<X.Y.Z> — YYYY-MM-DD
**Features added:** <bullet list from CHANGELOG [version] section>
**Key files changed:** <comma-separated key files or layers>
**Key architectural decisions:** <brief note or "none">
```