finish

name	finish
description	Use when implementation is complete — guides branch completion with commit, PR creation, or merge
type	workflow

Finish

Overview

Verify → commit → choose integration method → execute → clean up.

$ARGUMENTS

If $ARGUMENTS contains a branch or feature description, use it as context.

CLI Integration Gate

Before any commit, push, or PR creation:

1. Obtain the issue number: use the number in $ARGUMENTS if provided; otherwise infer from the current branch name (first integer after the last /) or ask the user.
2. Run: hexis status read <issue>
3. If output shows STATE: DONE: proceed.
4. If output shows any other state: surface the full CLI output verbatim to the user; stop. Do not proceed with commit, push, or PR creation.

Process

Step 1: Run verify

Run hexis:verify. Do not proceed to Step 2 if it fails.

Step 2: Handle uncommitted changes

If uncommitted changes exist, commit them following hexis:commit-principles rules.

Step 3: Present options

Ask the user how they want to integrate the completed work. Present these four options:

1. Merge locally into <base-branch>
2. Push and create a PR
3. Keep the branch and handle it manually later
4. Discard the work

Step 4: Execute

Option 1: Local merge

git checkout <base-branch>
git pull
git merge <feature-branch>
<test command>
git branch -d <feature-branch>

Option 2: Push + PR

P2 gate: Show the exact push command and wait for explicit approval. Do not push without approval.

git push -u origin <feature-branch>
gh pr create --title "<title>" --body "$(cat <<'EOF'
## Summary
- <2–3 lines of changes>

## Test Plan
- [ ] <verification step>
EOF
)"

PR title and body follow hexis:commit-principles type rules.

Option 3: Keep

Report branch location. No further action.

Option 4: Discard

Confirm first:

Tell the user exactly what will be permanently deleted:

• Branch: <name>
• Commits: <list>
• Worktree: <path> (if applicable)

Require an explicit destructive confirmation before proceeding, but do not require any exact phrase. Any unambiguous confirmation is acceptable.

After confirmation:

git checkout <base-branch>
git branch -D <feature-branch>

Step 5: Clean up worktree

For Options 1, 2, and 4:

git worktree list | grep <branch>
git worktree remove <worktree-path>

Option 3: keep the worktree.

Red Flags

Never:

• Proceed while verify is failing
• Push without explicit approval
• Delete work without confirmation
• --force-push without an explicit request