Ship

Finalize the current feature branch: commit, push, create a PR, wait for approval, check CI, and merge.

Step 1: Verify branch

Run

git branch --show-current

and confirm you are NOT on

main

or

master

. If you are, STOP and tell the user to check out a feature branch first.

git branch --show-current

If the branch is

main

or

master

, abort with:

"You are on

main

. Please check out a feature branch before shipping."

Step 2: Check for changes

Run

git status

and

git diff --stat

to see what needs to be committed.

• If there are no staged or unstaged changes and no untracked files, skip to Step 4 (push).
• If there are changes, proceed to Step 3.

git status
git diff --stat

Step 3: Commit

1. Run

   git diff

   (staged + unstaged) to understand all changes.
2. Run

   git log --oneline -5

   to match the repo's commit message style.
3. Stage relevant files (use specific file names, never

   git add -A

   ). Do NOT stage files that look like secrets (

   .env

   , credentials).
4. Write a concise commit message summarizing the changes.
5. Commit using a HEREDOC:

git commit -m "$(cat <<'EOF'
feat: <description>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
EOF
)"

Step 4: Push

Push the branch to origin. Use

-u

if this is the first push.

git push -u origin $(git branch --show-current)

Step 5: Create PR

Check if a PR already exists for this branch:

gh pr view --json number,title,url 2>&1

• If a PR already exists, skip to Step 6.
• If no PR exists, create one:

1. Run

   git log --oneline main..HEAD

   to understand all commits on this branch.
2. Run

   git diff main...HEAD --stat

   for a change summary.
3. Create the PR:

gh pr create --title "<short title>" --body "$(cat <<'EOF'
## Summary
<bullet points summarizing changes>

## Test plan
<checklist of testing steps>

Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

4. Report the PR URL to the user.

Step 6: Wait for approval

Tell the user:

"PR is ready for review: <URL>. Let me know when it's approved and I'll check CI and merge."

STOP HERE. Do NOT proceed until the user explicitly says to merge or confirms approval.

Step 7: Check CI status

After user confirmation, check the CI status:

gh pr checks $(gh pr view --json number -q .number)

• If all checks pass, proceed to Step 8.
• If checks are failing, report the failures and offer to investigate with

  /fix-ci

  .
• If checks are still running, wait 30 seconds and check again (up to 3 retries).

Step 8: Merge

Merge the PR using squash merge:

gh pr merge --squash --delete-branch

After successful merge, clean up any associated worktree:

BRANCH=$(gh pr view --json headRefName -q .headRefName 2>/dev/null || echo "")
if [ -n "$BRANCH" ]; then
  git worktree list | grep "$BRANCH" | awk '{print $1}' | while read wt; do
    [ -n "$wt" ] && git worktree remove "$wt" --force 2>/dev/null || true
  done
fi
git worktree prune

Report success:

"PR merged and branch cleaned up."

Safety rules

• NEVER force push
• NEVER merge without user confirmation
• NEVER merge if CI is failing
• NEVER commit

  .env

  , credentials, or secrets
• NEVER push to

  main

  directly