Spec-to-Ship
Your AI coding workflow
with engineer structure.
Spec-to-Ship (s2s) is the stage-gated engineered workflow for AI-assisted development. It brings AI conversations into engineering deliverables.
Stop vibe coding.
Define the spec, run the stages, ship with confidence — every time.
From Intent to Code
s2s enforces a stage-gated engineered workflow for AI development, ensuring every code change has clear lineage back to requirements.
The Orchestrator is s2s's central intelligence layer. It receives your natural language request, classifies the intent across 9 work types, and builds the minimum stage route needed — dispatching only the stages your change actually requires.
Product Manager
›Describe what you want to build. s2s captures the intent and classifies it before any code is touched.
research
›The agent explores the codebase, maps dependencies, and breaks the work into slices — bounded units tied to your requirements.
design
›Architecture decisions are locked in per slice before any code is written. Gates prevent skipping ahead.
engineering
›Each slice is executed in an isolated git worktree. Your main branch stays untouched until you approve.
Chat-native by design
Works where you already work
No new UI. No new editor. s2s runs alongside your preferred AI chat tool — Claude, Codex, or any other. Each stage injects exactly the right context into your conversation, so the model always knows what to build, why, and within what scope.
- Focused, bounded context package per stage
- No hallucinated scope or stray dependencies
- You approve the gates — AI does the work
Your AI does the work — s2s makes sure it stays on track.
AI proposes. You decide.
You're always in control
Every code change runs in an isolated git worktree on a dedicated branch. Your main branch stays clean until you review the diff and tell your AI to proceed. Nothing merges without a deliberate human decision.
- Isolated worktree per slice — main branch untouched
- Full diff review before anything is merged
- Gates enforce the human-in-the-loop at every stage
- Worktree cleaned up automatically after approval
Less overhead. Lower cost.
s2s handles orchestration, routing, and state management in the binary — zero LLM tokens charged. Your AI only sees focused context for the work it actually needs to do.
Engineered for Reliability
The difference between an AI that guesses and one that follows a governed engineering workflow.
| Challenge | Without s2s | With s2s |
|---|---|---|
| Scope control | AI decides what to build and how far to go | Intent classified → minimum stage route selected |
| Execution safety | Code lands directly in your workspace | Isolated git worktree per slice — main stays clean |
| State & audit trail | Lost when the chat window closes | Persistent specs, plans, and diffs in .s2s/ |
| Human oversight | Ad-hoc, no approval structure | Structured gates — you review the diff, you decide |
| AI client | Locked to one tool or workflow | Works with Claude Code, Codex, OpenCode, any chat |
Built in the open.
Governed by design.
s2s is MIT-licensed and community-driven. The governance layer, the stage agents, and the gate protocol are all auditable — because engineering standards for AI should be transparent.
Ship with structure.
Starting today.
Install in seconds. Works with your existing AI chat tool. No new UI, no lock-in — just a governed workflow for every change.
$ brew tap kiniuncorp/s2s && brew install s2s $ s2s init