wave-dispatch

Launch planned work batches as parallel sessions via chips or pasteable orders.

Updated Jun 6, 2026
One-click install
npx skills add https://github.com/hacker-cb/claude-code-plugins --skill wave-dispatch-hacker-cb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wave-dispatch
Source: https://github.com/hacker-cb/claude-code-plugins/tree/main/plugins/hcb-dev/skills/wave-dispatch
Command: npx skills add https://github.com/hacker-cb/claude-code-plugins --skill wave-dispatch-hacker-cb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating a multi-session epic requires turning a planned batch of work into actually running parallel sessions, each with a complete, self-contained order — while avoiding stale chips, unmet environment blockers, and batches launched before their dependencies land. ## Core Features & Use Cases - Preflight gating: Pins the base commit, checks environment blockers, issue-body currency (needs rewrite verdicts), and merge authority before any chip is hung; held batches are reported with the exact condition that releases them. - Chip-based dispatch: Spawns one chip per batch through the host's spawn_task tool with title, tldr, cwd, and a full wave order prompt; falls back to fenced pasteable blocks where chips are unavailable. - Lifecycle management: Withdraws stale chips (dismiss_task), re-issues on fresh pins, re-issues renegotiated boundaries to every affected batch, and sequences staged waves so the next chip only goes up after the predecessor lands. - Use Case: A master session has planned an epic split into three batches across two waves. Invoke this skill to pin the base, verify no blockers hold the batches, hang one chip per batch in launch order, and report where each stands to the user. ## Quick Start From the coordinating master session, ask to launch the planned waves by hanging one chip per batch for the current epic.

Frequently Asked Questions about wave-dispatch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I launch parallel work sessions from a master session?▼

Run wave-dispatch from the coordinating session after the batches are planned. It pins the base commit, checks blockers, then hangs one chip per batch via spawn_task, each carrying a complete wave order the receiving session reads first.

What happens when a batch has an environment blocker or stale issue?▼

The batch is not hung. Preflight checks SDKs, services, and issue bodies ruled needs rewrite; a held batch is reported to the user with the exact condition that releases it, and nothing else releases it.

Can wave-dispatch work where chip tools are unavailable?▼

Yes. The same wave order goes out as a fenced block per batch for the user to paste manually. The order already carries the Start gate and worktree verification the manual path needs.

How does a staged wave sequence its batches?▼

A staged wave hangs one chip at a time. The next chip goes up only after the predecessor has merged and the master cleared that landing against its checks, with preflight re-run and a fresh base pin for each step.

What should I do when a chip goes stale after the base moved?▼

Withdraw it with dismiss_task before it is read, since a hanging chip stays clickable while the delta from its pin is unverified. Then re-issue the chip on a fresh pin and record that pin in the launch row.

When should I use session-dispatch instead of wave-dispatch?▼

Use session-dispatch for a single ad-hoc order pasted by hand. Wave-dispatch is for launching planned batches of an epic in waves, with preflight gating, launch ordering, and a wave ledger behind it.