Shipwright

Adaptive agentic development framework for engineering teams. Claude Code plugin.

What It Does

Shipwright orchestrates a disciplined bug fix workflow: triage, TDD implementation, code review, and validation -- with codebase context and crash recovery.

Installation

# Add the RAI marketplace (one-time setup)
/plugin marketplace add RelationalAI/claude-plugins

# Install the beta plugin
/plugin install shipwright-beta@rai-claude-plugins

Stable release coming soon. For now, Shipwright is available as a beta plugin.

Usage

Orchestrated Workflow

/shipwright                                    # Start -- Triage asks what you're working on
/shipwright fix null pointer on details click   # Start with context
/shipwright fix bug RAI-9874                    # Start from Jira ticket (requires Atlassian MCP)

Flow: Triage -> Implementer -> Reviewer -> Validator

Standalone Commands

Command	What it does
/shipwright:codebase-analyze	Full codebase analysis -- writes 7 profile docs to docs/codebase-profile/
/shipwright:doc-digest <path>	Walk through any document section by section
/shipwright:debug	Standalone systematic debugging (4-phase)
/shipwright:report [description]	File bugs, feedback, and suggestions on Shipwright
/promote [comment]	Cherry-pick skills/agents/commands from beta to stable

Agents

Agent	Role
Triage	Reads codebase profiles, brainstorms with user, categorizes decisions, confirms tier
Implementer	Root cause investigation, TDD, systematic debugging, fix verification
Reviewer	Spec compliance review, code quality, approve/challenge/escalate
Validator	Full regression testing, fix confirmation
Doc Digest	Interactive document walkthrough

Skills

Skill	Purpose	Source
TDD	Test-driven development discipline	Superpowers
Verification	Evidence before claims	Superpowers
Systematic Debugging	4-phase root cause investigation	Superpowers
Anti-rationalization	Resist shortcuts and "LGTM"	Superpowers
Decision Categorization	LOCKED/DEFERRED/DISCRETION decisions	GSD
Brownfield Analysis	7-doc codebase profiling	GSD

Design Docs

• Design doc -- the full design
• Comparison -- how Shipwright compares to Superpowers, GSD, and Beads
• Ideas from Beads/GSD -- ideas reviewed, adopted, and deferred
• M1 Milestone -- Tier 1 bug fix scope and plan

Attribution

Shipwright builds on the work of:

• Superpowers by Jesse Vincent -- TDD, verification-before-completion, systematic debugging, and anti-rationalization skills. Licensed under Apache 2.0.
• GSD (Get Shit Done) by gsd-build -- Decision categorization and brownfield codebase analysis patterns.

License

[TBD]