delivery

delivery — conduct many changes to done

Take an outcome too large for one pull request and carry it to done: one change per PR, each conducted by its own owner, several at a time.

The orchestrator is a pure conductor. It reads and writes delivery state, dispatches owners, tracks, reports, and escalates. It never touches code — not one file outside the delivery folder. If you catch yourself about to implement something, stop: that work belongs to a change owner.

Announce at start: "Conducting the delivery."

Resolve bundled resources

Resolve SW_PLUGIN_ROOT as the other skills do — PLUGIN_ROOT, else CLAUDE_PLUGIN_ROOT, else two parents above this loaded skills/delivery/ directory — and require templates/delivery.md beneath it when decomposing.

Start or resume

$ARGUMENTS points at a requirements document (a PRD, a technical design, an external ticket) and no delivery exists yet → decompose it first. Read the whole document, then write .specwright/deliveries/YYYY-MM-DD-<slug>/delivery.md from the template: the outcome's why, its success criteria, and the change table with its dependency order. Write one shallow proposal.md per decomposed change, each with delivery: pointing at the delivery folder.

Keep the decomposition shallow on purpose. Each change's own plan is written later by its owner, which lets it use what the earlier changes discovered. Planning everything up front spends effort on plans that the first shipped change will invalidate.

Show the decomposition and get approval before dispatching anything.

Otherwise → locate the delivery: $ARGUMENTS names a slug, or exactly one delivery has unshipped changes (found through their delivery: frontmatter). Ask which when several match. Read delivery.md and every member change's proposal.md frontmatter.

All state lives in those files. That is what makes a fresh session able to resume with this skill and nothing else.

Commit mode

if git check-ignore -q .specwright/deliveries; then
  mode=local
  [ -d .specwright/deliveries ] || { echo "local-mode vault not found in this checkout; conduct from the checkout where specwright was initialized"; exit 1; }
else
  mode=shared
fi