| name | ship |
| description | Ship the current branch — commit, rename, push, create PR, merge to main, and create a new branch for the next piece of work. |
| user-invocable | true |
Ship It
Ship the current branch to main and set up for the next piece of work. Never ask the user questions — derive everything from the code and commits. Just do it.
Arguments
/ship — derive branch name from changes, next branch is dev/ship <branch-name> — use the given name, next branch is dev/ship <branch-name> <next-branch> — use both names as given
Steps
1. Assess current state
git status
git log --oneline main..HEAD
git diff --stat main..HEAD
2. Commit uncommitted changes (if any)
If there are staged, unstaged, or untracked files (excluding secrets/build artifacts):
- Stage relevant files
- Create a commit with a clear message derived from the changes
- Follow the repo's commit message style from
git log
3. Rename the branch (if needed)
If the user provided a branch name, use it. Otherwise derive one from the commits (e.g., feat/add-test-coverage, fix/rebalance-threshold). Rename without asking.
git branch -m <current-branch> <new-branch-name>
4. Push the branch
git push -u origin <branch-name>
5. Create the PR
Derive title and body from the commits. Don't ask — just create it.
gh pr create --title "<title>" --body "$(cat <<'EOF'
## Summary
<bullet points>
## Test plan
<how to verify>
🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"
6. Merge the PR
gh pr merge --squash --delete-branch
Use --squash to keep main history clean.
7. Update local main
git checkout main
git pull origin main
8. Create the next branch
Use the user-provided name, or default to dev.
git checkout -b <next-branch>
9. Print summary
- PR URL
- What was shipped (one line)
- Current branch
Rules
- Never ask the user questions — derive branch names, PR titles, and commit messages from the code
- Never force-push
- If the merge fails (conflicts, checks), stop and report — don't force it
- If there's nothing to ship (no changes and no commits beyond main), say so and stop
