dispatch

name	dispatch
description	Use when a task file exists in `.hyperflow/tasks/` and workers need dispatching — `/hyperflow:dispatch`, "run the plan", "execute the task", "build it". Dispatches parallel workers, runs thinking-tier batch reviews, finishes with a final integration review. Endpoint of the auto-chain (no auto-deploy — user opts in to push).

Dispatch

Workhorse phase. Picks up a task file from /hyperflow:scope and runs it through the orchestrator pattern with parallel worker dispatch and thinking-tier reviews.

This skill exercises Layer 3 (Orchestrator), Layer 5 (Quality Gates), Layer 6 (Project Memory), Layer 8 (Git Workflow), and Layer 9 (Security) from the doctrine. Multi-level review (L1–L5) is applied per the triage's flow profile.

Per-Step Agent Map (DOCTRINE rule 12)

Every substantive step dispatches at least one Agent.

Step	Worker tier	Thinking tier	Notes
0 — Mode confirm	—	—	AskUserQuestion only (exempt)
1 — Load task	—	—	File read only (exempt)
2 — Per batch	Implementer / Searcher / Writer × N parallel (Sonnet)	Reviewer (Opus) per sub-task at L1–L	Both tiers · per sub-task
2b — Quality gates	Worker (Sonnet) runs lint/typecheck/tests	Reviewer (Opus) judges gate output	Both tiers
3 — Final integration	—	Reviewer (Opus) L1–L over full diff	Mandatory
4 — Wrap up	Writer (Sonnet) deletes task, appends memory, auto-commits	Reviewer (Opus) sanity-checks the commit + memory entries	Both tiers
5 — End of chain	—	—	Two AskUserQuestion gates: audit? deploy? (exempt — gates only)

Iron rule — thinking agents ≥ batches + 1 (per-batch reviewer + final integration). With per-step thinking-tier reviewers in Step 4, the floor rises to batches + 2.

Review Levels (scale by flow profile)

Every batch reviewer and the final integration reviewer uses the level set below. Profile comes from /hyperflow:spec triage and is propagated via the chain-mode args.

Profile	Levels	Workers	Reviewers
fast	L1	1	inline self-review only
standard	L1–L2	1–2	1 per-batch reviewer
deep	L1–L5	3+	per-batch + final integration
research	L1–L2 + synthesis	3+ searchers	inline synthesis
creative	L1–L3 + UX	1–2	1 reviewer
scientific	L1–L5 + TDD	2–3	per-batch + final

L1 syntax/format · L2 spec/naming/edges · L3 integration/security · L4 perf/scale · L5 a11y/UX. See review-levels.md for the full checklist.

Approval Gates

Gate	When	Format
Chain mode	Step 0, only if invoked directly	AskUserQuestion — auto / manual
Inter-batch (manual mode only)	After each batch's gates pass	AskUserQuestion — continue / stop
Hard halt	Any SECURITY_VIOLATION from a reviewer	Stop the chain, surface the finding
Audit prompt	Step 5, after wrap-up	AskUserQuestion — run /hyperflow:audit? (yes/no, recommended toggles with flow profile)
Deploy prompt	Step 5, after audit gate	AskUserQuestion — run /hyperflow:deploy? (yes/no, recommended toggles with gate state)

Inputs

• Task file — positional arg (slug or path). Default — most-recently-modified file in .hyperflow/tasks/.
• chain-mode=<auto|manual> — passed in by /hyperflow:scope. Controls whether to pause for confirmation after the final integration review. If absent, assume auto.
• --from-batch <n> — resume from a specific batch (skip prior batches).
• --final-only — skip batch dispatch, run only the final integration review.

Flow

Step 0 — Choose mode (only if invoked directly · STRUCTURAL GATE)

This is a structural gate per DOCTRINE rule 8. When dispatch is invoked directly (no chain-mode arg from scope), it MUST fire. "No clarifying questions" / "auto-pilot" / any autonomy directive does NOT skip it. Defaulting silently is a doctrine violation.

If a chain-mode arg was passed, skip this step — the chain-starter already asked.

Otherwise, ask via AskUserQuestion. Per DOCTRINE rule 8, the recommended option goes first with (Recommended):

How should I handle progress through the batches?

  Auto (Recommended)  — run all batches + final review and stop. Print next-step suggestions.
  Manual              — pause between batches and ask before continuing.

Wait for the user's answer. Do not proceed without it. If AskUserQuestion cannot be presented, print an error and stop — never silently default.

Step 1 — Load the task

Read .hyperflow/tasks/<slug>.md. If absent, stop and suggest /hyperflow:scope first.

Step 2 — For each batch

1. Print the batch header: Batch <n> — <one-line description>.
2. Dispatch all sub-tasks in the batch in a single message with parallel Agent calls (one per sub-task). Use the worker-prompt.md template. Inject Project Context (from .hyperflow/profile.md, architecture.md, conventions.md) plus accumulated Learnings from prior batches.
3. As each worker returns:
   • Print Implementer — completed <subtask> (or relevant role).
   • Immediately dispatch a thinking-tier reviewer per reviewer-prompt.md. Print **Reviewer** — reviewing <subtask> (L1–L<n>) where n is set by the flow-profile table above.
   • If verdict is NEEDS_FIX — re-dispatch worker with the fix list. Repeat until PASS (max 3 retries before escalating to a thinking-tier worker).
   • If verdict is SECURITY_VIOLATION — halt the chain immediately and surface the finding to the user (no auto-continue).
   • On PASS — commit this sub-task immediately per git-workflow.md rule 2 (per-sub-task commit cadence). Stage only the files this sub-task touched, write a conventional commit (feat(<scope>): <title> derived from the task file), commit. One sub-task = one commit. A batch of 3 parallel sub-tasks produces 3 commits.
4. After the full batch — synthesize learnings, check off the batch in the task file, run Layer 5 quality gates (lint / typecheck / tests on affected files) per quality-gates.md. If gates fix anything, those become small additional commits on top (never amend per-sub-task commits). If chain-mode=manual, pause and ask before starting the next batch.

Step 3 — Final Integration Review

Mandatory and separate from batch reviews. Dispatch a thinking-tier reviewer with the full set of changed files. Print **Reviewer** — final integration review (L1–L<n>) using the same level cap as the batch reviewers (per flow profile). Verdict required — PASS / NEEDS_FIX / SECURITY_VIOLATION.

Step 4 — Wrap Up

Agents — Writer (Sonnet) ⇒ Reviewer (Opus).

1. Dispatch Writer — finalizing dispatch artifacts to:
   • Delete the completed task file from .hyperflow/tasks/.
   • Append durable patterns/decisions to .hyperflow/memory/ per memory-system.md.
   • Commit the memory + task-file-deletion as a chore(memory): commit (this is a separate commit from the per-sub-task commits from Step 2 — keeping memory writes out of feature commits keeps the diff clean).
2. Dispatch **Reviewer** — verifying wrap-up to confirm: memory entries are non-duplicate, commit messages match the changes, no half-written artifacts remain in .hyperflow/, per-sub-task commit cadence was respected (one commit per approved sub-task).
3. Print the usage summary per output-style.md.

Step 5 — End of Auto-Chain · Audit + Deploy gates

Dispatch is the endpoint of the auto-chain. Two separate AskUserQuestion gates fire here (DOCTRINE rule 8 — structural gates always fire, never silently default):

Gate 1 — Run /hyperflow:audit?

?  Run /hyperflow:audit on the cumulative diff?
   Yes (Recommended)   — outside-eye L3 review, independent of per-batch reviewers
   No                  — skip; per-batch L1–L<n> reviews were enough

Recommended option scales with the triage's flow profile:

• fast / standard profile → No (Recommended) — per-batch L1–L2 reviewers already covered it
• deep / scientific profile → Yes (Recommended) — L3 outside review is worth it on cross-cutting changes
• creative → Yes (Recommended) if the change touches user-visible surfaces

On Yes → invoke Skill with skill: audit and args: "level=3" (or level=5 for scientific). Wait for it to finish. Then proceed to Gate 2.

Gate 2 — Run /hyperflow:deploy?

?  Run /hyperflow:deploy now? (lint + typecheck + build + tests + security sweep, then asks before push)
   Yes (Recommended)   — green-light path: all dispatch gates passed, ready to ship
   No                  — keep the per-sub-task commits local; you'll push manually later

Recommended option toggles based on dispatch gate state:

• All Step 4 gates were green AND no escalations occurred → Yes (Recommended)
• Any gate fix required ≥2 retries, or an escalation triggered → No (Recommended) — let the user eyeball the diff first

On Yes → invoke Skill with skill: deploy. Deploy has its own push-confirmation gate at its Step 6.

On No to both gates → stop cleanly. Print one line:

Dispatch complete — <n> batches, <m> agents, <p> per-sub-task commits on branch <branch>.
Next: invoke /hyperflow:audit or /hyperflow:deploy manually when ready.

The orchestrator does NOT auto-invoke audit or deploy. Both gates wait for an explicit user choice. Defaulting silently is a doctrine violation.

Agent Label Style

No icons, no brackets. Em-dash separator. Bold for thinking-tier roles:

Implementer — creating auth middleware
Searcher — finding related test files
Writer — generating API documentation
**Reviewer** — reviewing auth middleware output
**Debugger** — investigating test failure in auth.test.ts

Iron Rules

• Workers never review, never coordinate, never ask the user questions.
• Every batch produces one thinking-tier batch reviewer dispatch.
• Plus one thinking-tier final integration review at the end.
• Plus one thinking-tier wrap-up reviewer at Step 4 (DOCTRINE rule 12).
• Therefore — thinking agents in usage summary >= batches + 2. If less, a per-step reviewer was skipped. The task was done wrong.

Doctrine

Full rules in DOCTRINE.md. This skill is the execute phase invoked at the end of /hyperflow:scope.