Spec-driven agent orchestration

Code generation is solved. Context isn't.

shipd makes agents converge on a spec before they write code — a plan, testable requirement deltas, a mechanical task list — then an adversarial validator tries to break every scenario before anything merges. What got built and what was asked for are the same document, in your repo.

Install
$curl -fsSL https://shipd.now/install | shcopy
HOW IT WORKS →
the loop:intentinvestigatespeccontext gatebuildrefutereviewmergecapability library ↺
intent
Intent has to be captured as an artifact before it can be enforced.
$ /s:plan checkout retries drop the idempotency keyState intent — prose, a brief, or a screen recording
→ new change: checkout-retries · status: draft
intent can also arrive as a research report (/s:research)
or a screen recording → cited brief, grounded frame by frame
What shipd does with context

Capture it. Gate on it. Verify against it.

01 · CAPTURE

Everything becomes a spec.

Prose, a brief, even a screen recording — shipd compiles whatever you give it into the same three reviewable artifacts: a plan, testable requirement deltas, and a task list, checked into your repo. Answers you've given before are already there; they're never asked twice.

02 · GATE

Insufficient context never builds.

A deterministic gate checks the spec against your actual codebase before a line of code is written. Gaps park the plan with findings attached — you enrich it, it re-enters. The system stops rather than guess.

03 · VERIFY

Quality is checked, not assumed.

An independent validator tries to refute every scenario in the spec against the running code, then CI and a semantic review — explicitly dispositioned, on record — gate the merge. What ships is what the spec says, verified.

The spec is the product.

real artifacts from shipd-now/shipd
plan.mdplan
# oracle-qa-ledger
Status: verified
## Idea
Record every oracle consultation as a
referenceable Q<n> entry so the user can
correct the oracle's standing position.
## Implementation
The ledger is a plan.md section, not a
separate artifact — it rides every existing
read/merge/archive path for free.
specs/shipd-plan/spec.mddelta
## ADDED Requirements
Requirement: Q&A ledger
Every consultation is recorded.
#### Scenario: settled decision
- WHEN the oracle settles a decision
- THEN the plan carries a Q<n> entry
with verdict, answer, and citations
tasks.mdtasks
[x] 1.1 Ledger section grammar in emission.md
[x] 1.2 Error-level lint rule in spec_lint.py
[x] 2.1 /s:teach Q<n> reference mode
[x] 2.2 cat change completed/ fallback
4/4 · status: verified · merged

shipd builds itself. This is the board.

$ shipd board text
175
changes shipped by its own pipeline
36
verified capabilities in the library
11
epics — autopilot delivers approved ones unattended
autonomous-deliveryresearch → epic → unattended member PRscomplete
video-ingestscreen recording → cited intent briefcomplete
mikk-knowledgewiki · memory · ask-first oraclecomplete
delivery-metricsthroughput metrics over the archivecomplete
portable-workspacesdoctor-checked setup, JSON-first CLIactive
+ 6 more epics · lifecycle: draft → ready → active → complete → verified

Stop watching agents type.

$curl -fsSL https://shipd.now/install | sh
then, in your repo: /s:plan /s:build → merged PR