finish

Activate When

• /godmode:finish, "done", "merge", "finalize"
• Feature branch has commits ahead of main
• Another skill completes and branch is ready

Auto-Detection

Routes here when:

• git log main..HEAD --oneline returns 1+ commits AND user says "done", "merge", "finish"
• /godmode:build completes all tasks
• User explicitly invokes /godmode:finish

Workflow

1. Snapshot Branch State

branch=$(git branch --show-current)
commits=$(git log main..HEAD --oneline | wc -l | tr -d ' ')
files_changed=$(git diff main..HEAD --stat | tail -1)
echo "Branch: $branch | $commits commits | $files_changed"

# Check if on main
if [ "$branch" = "main" ]; then
  echo "ERROR: Already on main. Nothing to finish."
  exit 1
fi

2. Enforce Clean Worktree

staged=$(git diff --cached --name-only)
unstaged=$(git diff --name-only)
untracked=$(git ls-files --others --exclude-standard)

IF staged non-empty: STOP — commit or stash first
IF unstaged non-empty: STOP — commit, stash, or discard
IF untracked files: WARN — won't be in merge

3. Run Full Guard Suite

build_cmd && lint_cmd && test_cmd

THRESHOLDS:
  Build: must exit 0
  Lint: must exit 0 with --max-warnings=0
  Tests: 100% pass rate required
  IF any failure: STOP, run /godmode:fix first
  IF no test runner: WARN, continue

4. Check Merge Conflicts

git fetch origin main
git merge-tree \
  $(git merge-base HEAD origin/main) origin/main HEAD

IF conflicts: print files, recommend rebase.

5. Determine Outcome

PRIORITY (first match wins):
  DISCARD: user says "discard", "abandon" (confirm)
  KEEP: user says "keep", "not yet", "park it"
  MERGE: user says "merge" OR PR approved
  PR: default when checks pass

6. Execute Outcome

MERGE:

git checkout main && git pull origin main
git merge --squash {branch}
git commit -m "feat({module}): {title}

Squashed {N} commits from {branch}."
git branch -d {branch}

PR:

gh pr create --title "feat({module}): {title}" \
  --body "## Changes
$(git log main..HEAD --format='- %s')

## Guard Results
Build: PASS | Lint: PASS | Tests: PASS"