claude-ship

A 14-step ship pipeline for Claude Code. Takes a fuzzy goal → crisp spec → risk-classified plan → reviewed diff → engineer-in-the-loop commit → captured lessons. Packaged as an installable Claude Code plugin.

Status: v0.1 — extracted from a personal config. Works as-is. Names and project namespaces are pre-set for the original author; see CONFIG.md to personalize.

What you get

7 commands

Command	What it does
/ship "<task>"	14-step orchestrator: parse → context → plan → risk → dispatch → MCP route → execute → judges → revise → done-gate → commit → learn → curate → notion.
/ship <spec-id>	Consume an approved spec from /spec.
/ship resume	Resume the last interrupted /ship session.
/spec	Turn a fuzzy goal into a /ship-consumable spec (draft → approved → shipped).
/postmortem	Failure-side learning loop. Auto-fires on /ship halt.
/morning	Daily kickoff.
/eod	End-of-day wrap.
/weekly	Sunday review.
/cross-learn	Promote patterns learned in one project namespace into system-level rules.

12 skills (orchestrated by the commands above)

spec-builder, judge-panel, done-gate, commit-protocol, project-memory, session-recall, operator-model, mcp-router, notion-bridge, skill-curator, postmortem, plugin-packager.

3 hooks (proposal surfacing — see hooks/README.md)

proposal-watcher.sh (SessionStart banner), composed-statusline.sh (📋 N indicator), proposal-count.sh (helper). Surfaces pending skill-curator proposals on session start and in the statusline.

Design

/ship is the conductor. Every step delegates to a skill. The skills compose:

PARSE → CONTEXT → PLAN → RISK CLASSIFY → DISPATCH → MCP ROUTE →
EXECUTE → JUDGE PANEL → REVISE → DONE GATE → COMMIT → LEARN →
CURATE CHECK → NOTION ROUTE + REPORT

Patterns adapted from Anthropic's multi-agent research system post (effort budgets per risk tier, structured delegation briefs, artifact reference protocol, long-horizon hand-off).

Install

Option A — local plugin (immediate)

git clone https://github.com/shadybad/claude-ship.git ~/.claude/plugins/local/claude-ship

Or symlink from anywhere:

git clone https://github.com/shadybad/claude-ship.git ~/repos/claude-ship
mkdir -p ~/.claude/plugins/local
ln -s ~/repos/claude-ship ~/.claude/plugins/local/claude-ship

Restart Claude Code. /ship should now be available.

Option B — drop directly into ~/.claude/

If you don't want the plugin layer:

git clone https://github.com/shadybad/claude-ship.git /tmp/claude-ship
cp -i /tmp/claude-ship/.claude/commands/*.md ~/.claude/commands/
cp -ri /tmp/claude-ship/.claude/skills/* ~/.claude/skills/

See INSTALL.md for the full options matrix.

Personalize

The skills reference the original author's name and project namespaces (auto-co, margin-invest, personal). To swap them for your own:

./scripts/personalize.sh "<your-name>" "<project-1>" "<project-2>"

See CONFIG.md for what gets rewritten and why.

Recommended companions

/ship degrades gracefully when these aren't installed, but works best with:

• superpowers marketplace plugins (brainstorming, writing-plans, subagent-driven-development, episodic-memory, private-journal-mcp)
• claude-plugins-official (plugin-dev, commit-commands, pr-review-toolkit, hookify, pyright-lsp, notion, github)
• caveman marketplace (token compression)
• ecc marketplace (29-judge roster source)

The skills name these plugins explicitly — install what you need.

License

MIT — see LICENSE.