Ship-It Plugin

All-in-one shipping workflow for Claude Code that unifies what would otherwise require multiple separate tools: branch creation, code simplification, atomic commits, PR creation, and multi-agent code review.

Overview

Ship-It automates the entire process of shipping code changes. Instead of juggling separate /commit, /create-pr, and code review tools, Ship-It combines them into a single, coherent workflow:

1. Pre-flight Check - Validates git state, detects uncommitted changes, checks branch protection
2. Branch Creation - Creates feature branches with smart naming and style detection
3. Code Simplification - Opus agent refines code for clarity without changing functionality
4. Atomic Commits - Splits changes into logical, independently revertable commits
5. Push & PR - Pushes branch and creates a well-documented pull request
6. Code Review - Multi-agent review with confidence-based issue scoring

Installation

From GitHub (Recommended)

claude plugins add https://github.com/sungmanch/ship-it

# Verify installation
claude plugins list

From Local Directory

# Clone or copy to your local plugins directory
git clone https://github.com/sungmanch/ship-it ~/.claude/plugins/local/ship-it

# Add the plugin
claude plugins add ~/.claude/plugins/local/ship-it

# Verify installation
claude plugins list

Usage

/ship-it [options]

Options

Option	Description
--branch <name>	Custom branch name (default: auto-generated based on changes)
--base <branch>	Base branch for PR (default: main or master)
--no-simplify	Skip the code simplification phase
--no-review	Skip the PR code review phase
--dry-run	Show what would happen without executing

Examples

# Full workflow with all phases
/ship-it

# Ship without code review
/ship-it --no-review

# Ship with custom branch name
/ship-it --branch feat/user-authentication

# Preview what would happen
/ship-it --dry-run

# Ship to a specific base branch
/ship-it --base develop

# Skip simplification and review (fast mode)
/ship-it --no-simplify --no-review

Workflow Phases

Phase 1: Pre-flight Check

Uses a Haiku agent to verify:

• No uncommitted changes blocking the workflow
• Not on a protected branch (main/master)
• Check for existing PRs on the current branch

Phase 2: Branch Creation

• Analyzes last 30 commits to detect commit style (semantic, plain, Korean)
• Creates feature branch with smart naming: {type}/{context}-{YYYYMMDD}
• Examples: refactor/auth-component-20260122, feat/user-dashboard-20260122

Phase 3: Code Simplification

Uses an Opus agent to refine recently modified code:

• Preserve all functionality
• Enhance clarity and readability
• Apply DRY principle
• Follow project standards from CLAUDE.md

Phase 4: Atomic Commits

Splits changes into logical commits:

Files Changed	Minimum Commits
3+ files	2+ commits
5+ files	3+ commits
10+ files	5+ commits

Commits are split by:

• Directory/module
• Component type
• Concern (UI/logic/config/test)

Phase 5: Push & PR Creation

• Pushes branch to origin with tracking
• Creates PR with:
  • Title following detected commit style
  • Summary of changes
  • List of commits
  • Test plan checklist

Phase 6: Code Review

Multi-agent review workflow:

Step	Agent	Purpose
6.1	Haiku	Eligibility check (not closed/draft)
6.2	Haiku	Find CLAUDE.md guideline files
6.3	Haiku	Summarize PR changes
6.4	5x Sonnet	Parallel code review from different angles
6.5	Nx Sonnet	Score each issue 0-100
6.6	-	Filter issues below 80 confidence
6.7	Haiku	Re-verify PR still eligible
6.8	-	Post review comment

Review Agents Focus:

1. CLAUDE.md compliance
2. Bug detection (changes only)
3. Git history context
4. Previous PR comments
5. Code comment compliance

Requirements

• Git repository
• GitHub CLI (gh) installed and authenticated
• Claude Code with plugin support

Error Handling

Situation	Behavior
Uncommitted changes	Prompts to commit or stash
On protected branch	Aborts with message
Existing PR	Asks to update or create new
Branch exists	Offers suffix or checkout
Pre-commit hook fails	Fixes and creates new commit
Push rejected	Suggests rebase and retry

Output

After completion, Ship-It reports:

Ship-It Complete:
- Branch: feat/user-auth-20260122
- Commits: 4 atomic commits
- PR: #123 - https://github.com/owner/repo/pull/123
- Review: 2 issues found

Tips

• Use --dry-run first to preview what will happen
• Keep CLAUDE.md updated for better code review results
• Use --no-simplify if you want full control over code changes
• Use --no-review for quick iterations or trivial changes

Credits

Ship-It integrates and unifies concepts from:

• git-master by code-yeongyu - Atomic commits, commit style detection, rebase workflow
• code-simplifier by Anthropic - Opus-powered code refinement
• code-review by Anthropic - Multi-agent PR review with confidence scoring

Version

1.0.0

Author

Sungman Cho

License

MIT