Pre-operation Checks

Verify working tree is clean and current branch matches feature/* per ${CLAUDE_PLUGIN_ROOT}/references/invariants.md .

Phase 1: Identify Feature

Goal: Determine feature name from current branch or argument.

Actions:

• If $ARGUMENTS provided, use it as feature name

• Otherwise, extract from current branch: git branch --show-current (strip feature/ prefix)

Phase 2: Pre-finish Checks

Goal: Run tests before finishing.

Actions:

• Identify test commands (check package.json, Makefile, etc.)

• Run tests if available; exit if tests fail

Phase 3: Update Changelog

Goal: Document changes in CHANGELOG.md.

Actions:

• Ensure changes are in [Unreleased] section per ${CLAUDE_PLUGIN_ROOT}/examples/changelog.md

• Commit CHANGELOG updates with Co-Authored-By footer

Phase 4: Finish Feature

Goal: Complete feature using git-flow-next CLI.

Actions:

• Run git flow feature finish $FEATURE_NAME

• Verify current branch: git branch --show-current (should be on develop)

• Push develop: git push origin develop