s2s

Spec-driven development framework that orchestrates multi-agent workflows on top of Claude Code

---

🎯 What Spec2Ship Is

Spec2Ship is a Claude Code plugin that adds structured orchestration for requirements, architecture, and implementation planning.

The core idea: instead of prompting Claude Code directly, you run roundtable discussions where multiple agents, each representing a real role, debate and refine decisions collaboratively.

It is:

• A spec-driven framework where specifications are treated as executable intent
• An orchestration layer built on Claude Code primitives
• A deliberation system with configurable facilitation strategies

It is not:

• A standalone CLI or generic tool (requires Claude Code)
• A prompt library or template pack
• A code generator (it produces specs and plans; you write the code)

[!NOTE] Spec2Ship requires Claude Code to run. It extends Claude Code with structured workflows, not replaces it.

---

❓ Why Not Just Prompt Claude Code Directly?

When you prompt Claude Code directly for requirements or architecture decisions:

What happens	The problem
Single perspective	Optimized for agreement rather than rigorous challenge
No adversarial review	Security gaps, edge cases, feasibility issues missed
Freeform output	Hard to review, audit, or hand off to team
Ephemeral sessions	Context lost between conversations
No structure	Each session starts from scratch

Spec2Ship solves this by:

• Convening 12 specialized agents with distinct viewpoints
• Enforcing structured discussion via facilitation strategies
• Producing standards-based artifacts (arc42, ISO 25010, MADR)
• Persisting sessions with full audit trail
• Supporting escalation triggers for human review

---

⚖️ How Spec2Ship Compares

Aspect	Spec2Ship	Claude-Flow	Spec-Kit	OpenSpec
Approach	Multi-agent deliberation	Swarm task execution	Document checkpoints	Lightweight diffs
Agents	12 specialized roles debating	54+ task workers	Single agent	Single agent
Quality mechanism	Adversarial review built-in	Speed optimization	Human review points	Minimal overhead
Strategies	5 facilitation methods	Hierarchical/mesh	Linear	Linear
Output	arc42, ISO 25010, MADR	Custom	Markdown	Diff-based
Best for	Decisions needing debate	Parallel task execution	Greenfield features	Brownfield changes

Choose Spec2Ship when:

• Decisions need multiple expert perspectives
• You want adversarial review (security, scalability, edge cases)
• Artifacts must be auditable and standards-based
• You're already using Claude Code

Choose alternatives when:

• Claude-Flow: Parallel execution of many independent tasks
• Spec-Kit: Simple greenfield specs with checkpoint review
• OpenSpec: Incremental changes to existing codebases

---

🚀 Quick Start

# 1. Add the plugin
/plugin marketplace add spec2ship/spec2ship

# 2. Install it
/plugin install s2s

# 3. Initialize your project
/s2s:init

# 4. Run your first roundtable
/s2s:specs

After /s2s:specs completes, you'll have:

• .s2s/sessions/YYYYMMDD-specs-*.yaml: full discussion transcript
• .s2s/requirements.md: structured requirements with IDs (REQ-001, REQ-002...)

[!TIP] For your first run, use /s2s:specs --interactive to pause after each round and see how the discussion unfolds.

---

🔄 Roundtable: The Core Primitive

Roundtable is the fundamental abstraction of Spec2Ship.

Every major decision flows through a structured discussion: