release-cch

Contents

• Overview
• Decision Tree
• Phase 1: Prepare Release
• Phase 2: Execute Release
• Phase 3: Verify Release
• Phase 4: Hotfix Release
• Scripts Reference
• References

Overview

Single Source of Truth: Version is stored in Cargo.toml (workspace root):

[workspace.package]
version = "1.0.0"

Release Trigger: Pushing a tag like v1.0.0 triggers .github/workflows/release.yml

Build Targets:

Repository: SpillwaveSolutions/code_agent_context_hooks

Decision Tree

What do you need?
|
+-- Starting a new release? --> Phase 1: Prepare Release
|
+-- PR merged, ready to tag? --> Phase 2: Execute Release
|
+-- Tag pushed, checking status? --> Phase 3: Verify Release
|
+-- Need to patch an existing release? --> Phase 4: Hotfix Release
|
+-- Something went wrong? --> references/troubleshooting.md

Phase 1: Prepare Release

1.1 Read Current Version

# Run from repo root
.claude/skills/release-cch/scripts/read-version.sh
# Output: 1.0.0

1.2 Determine New Version

Follow semantic versioning:

• MAJOR (X.0.0): Breaking changes
• MINOR (x.Y.0): New features, backwards compatible
• PATCH (x.y.Z): Bug fixes only

Update Cargo.toml (manual step):

[workspace.package]
version = "1.1.0"  # <- Update this

1.3 Create Release Branch

VERSION=$(.claude/skills/release-cch/scripts/read-version.sh)
git checkout -b release/v${VERSION}

1.4 Run Pre-flight Checks

.claude/skills/release-cch/scripts/preflight-check.sh

This validates:

• Clean working directory (or only release files modified)
• All unit tests pass (cargo test)
• All integration tests pass (task integration-test)
• Clippy has no warnings
• Format check passes

IMPORTANT: Integration tests are REQUIRED before any release.

1.5 Generate Changelog

VERSION=$(.claude/skills/release-cch/scripts/read-version.sh)
.claude/skills/release-cch/scripts/generate-changelog.sh ${VERSION}

1.6 Commit and Push

VERSION=$(.claude/skills/release-cch/scripts/read-version.sh)
git add CHANGELOG.md Cargo.toml
git commit -m "chore: prepare v${VERSION} release"
git push -u origin release/v${VERSION}

1.7 Create Release PR

VERSION=$(.claude/skills/release-cch/scripts/read-version.sh)
gh pr create --title "chore: prepare v${VERSION} release" --body "..."

1.8 Wait for CI

gh pr checks <PR_NUMBER> --watch

Phase 2: Execute Release

2.1 Merge the Release PR

gh pr merge <PR_NUMBER> --merge --delete-branch

2.2 Sync Local Main

git checkout main
git pull

2.3 Create and Push Tag

VERSION=$(.claude/skills/release-cch/scripts/read-version.sh)
git tag v${VERSION}
git push origin v${VERSION}

Phase 3: Verify Release

3.1 Monitor Workflow

.claude/skills/release-cch/scripts/verify-release.sh

3.2 Verify Release Assets

VERSION=$(.claude/skills/release-cch/scripts/read-version.sh)
gh release view v${VERSION}

Phase 4: Hotfix Release

See hotfix-workflow.md for detailed steps.

Scripts Reference

All scripts are located in .claude/skills/release-cch/scripts/.

References

• release-workflow.md - Standard release workflow diagram
• hotfix-workflow.md - Hotfix release workflow diagram
• troubleshooting.md - Common issues and solutions