finish-release

Pre-operation Checks

release/*

${CLAUDE_PLUGIN_ROOT}/references/invariants.md

Phase 1: Identify Version

1. If

   $ARGUMENTS

   provided, use it as version (strip 'v' prefix if present)
2. Otherwise, extract from current branch:

   git branch --show-current

   (strip

   release/

   prefix)
3. Store clean version without 'v' prefix (e.g., "1.0.0")

Phase 2: Pre-finish Checks

1. Identify test commands (check package.json, Makefile, etc.)
2. Run tests if available; exit if tests fail

Phase 3: Update Changelog

1. Get previous tag:

   git tag --sort=-v:refname | head -1

2. Collect commits per

   ${CLAUDE_PLUGIN_ROOT}/references/changelog-generation.md

3. Update CHANGELOG.md per

   ${CLAUDE_PLUGIN_ROOT}/examples/changelog.md

4. Commit:

   chore: update changelog for v$VERSION

   with

   Co-Authored-By

   footer

Phase 4: Finish Release

1. Run

   git flow release finish $VERSION --tagname "v$VERSION" -m "Release v$VERSION"

2. Verify current branch:

   git branch --show-current

   (should be on develop)
3. Push all:

   git push origin main develop --tags

Phase 5: GitHub Release

1. Extract changelog for this version from CHANGELOG.md
2. Run

   gh release create "v$VERSION" --title "v$VERSION" --notes "<changelog>" --verify-tag