ship

name	ship
description	Commit, push, create PR, then after approval check CI and merge. Use when work is done and ready to ship.
user-invocable	true

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 <[e-mail]>
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: . 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