Drive Engine
The reusable execution body behind /craft:orch:drive. The command
owns condition synthesis and gating; this skill owns the work.
Responsibilities
- Resolve phases — if an
ORCHESTRATE-*.mdexists in the worktree root, parse its phases and file-scopes. If not, derive phases directly from the SPEC's## Phase/## Increment/task-list sections. An ORCHESTRATE file is preferred when present but never required. - Dispatch — per turn, launch
--agents N(default 1) file-scoped subagents, one per pending wave item, each scoped to its files only. Keep the transcript linear whenN == 1so the/goalevaluator can read it. - Real verify gate — when the
/goalcondition clears, run the project's actual verification (auto-detected, see table) and treat its exit status as the authoritative "done". A green transcript is NOT sufficient; the command must actually run.
Phase resolution
Look for, in order: worktree ORCHESTRATE-*.md → SPEC ## Phase N /
## Increment N headings → top-level numbered task list. Emit a wave list
of {phase, files[], tasks[]}.
Verify-command auto-detection
See ../references/verify-gate-detection.md for the
full detection table and how to use it. Always pair with git status --short to confirm a clean,
committed tree.
Outputs
A structured verify result: { command, exit_code, passed: bool, summary }.
On passed: true, the caller stops at verified-green and prints the
gh pr create command — this skill never opens a PR.
Not this skill's job
The #NNN issue-premise pre-filter (does the spec cite an open issue? if
so, run /craft:git:issue-check <N> and surface the verdict) lives in
/craft:orch:drive's own Step 2, not here — it's part of the command's
gating responsibility, run once before any dispatch begins. It never
blocks and never runs unless a citation is found.