/finish

/dev:finish — Complete Development Branch

Verify tests. Present options. Execute choice. Clean up.

Step 1: Verify Tests

Run the project's test suite. Stop if tests fail. Don't present completion options with broken tests.

Step 2: Present Options

Implementation complete. All tests passing. What would you like to do?

1. Merge back to <base-branch> locally
2. Push and create a Pull Request
3. Keep the branch as-is
4. Discard this work

Step 3: Execute Choice

Option 1 — Merge locally:

git checkout <base-branch>
git pull
git merge <feature-branch>
# Verify tests on merged result
git branch -d <feature-branch>

Option 2 — Create PR:

git push -u origin <feature-branch>
gh pr create --title "<title>" --body "<summary>"

Option 3 — Keep as-is: Report branch name and worktree path. Done.

Option 4 — Discard: Require typed confirmation first. Show what will be deleted (branch, commits, worktree).

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

Step 4: Cleanup Worktree

If working in a worktree (from /dev:worktree):

• Options 1, 2, 4: remove the worktree (git worktree remove <path>)
• Option 3: keep the worktree

Rules

• Never proceed with failing tests
• Never force-push without explicit request
• Never discard without typed confirmation
• Verify: run tests on the final state, read output, THEN report success