wave-worker

Executes a dispatched wave batch order and coordinates its return with the master session.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? When a master session fans an epic out into parallel batches, each receiving session needs a strict protocol for verifying its order, reporting scope before building, routing reserved decisions back to the master, and returning results that survive restarts. This Skill governs that engagement so parallel wave work stays coordinated instead of drifting. ## Core Features & Use Cases - Order verification and scope reporting: Reads the full batch (order, ledger, forge issues, code) before building and reports the actual scope found to the master before the first write. - Reserved-fork routing: Sends forks the order marks "agree with the master" to the master with analysis and recommendations, while deciding everything else autonomously. - Durable return protocol: Posts the full batch report to the tracker coordinate the order names, keeps the session engaged until the master accepts, and handles master-silent versus master-unreachable states. - Use Case: A session started from a wave chip uses this Skill to verify its worktree, read its batch's issues, build through the named workflow (usually implementation-workflow), report milestone statuses, and deliver a return the master can accept. ## Quick Start Invoke this skill in a session that received a batch order from a master session to verify the order, build the batch, and coordinate the return until acceptance.

Frequently Asked Questions about wave-worker

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

FAQPage Schema
How do I execute a wave batch order from a master session?▼

Invoke the wave-worker skill in the receiving session. It verifies the order and worktree, reads the full batch including ledger and forge issues, reports the discovered scope to the master before building, then runs the workflow the order names.

What is the difference between wave-worker and session-handoff?▼

wave-worker governs a batch dispatched by a master session within a wave, keeping the session engaged until the master accepts the return. session-handoff is for returning a hand-carried single order with no master session over it.

Can wave-worker change the order it received?▼

No. A plugin update or newly discovered facts never amend the order from the worker side. Divergences are reported to the master with a recommendation, and the order's ask and terminal deliverable remain the row the return is judged against.

What happens if the master session goes silent during a batch?▼

The skill distinguishes master-silent from master-unreachable per the session-comms reference. Work not depending on an answer continues; if the master is gone for good, the engagement ends through the user by reporting the return's coordinates in chat.

When should I not use the wave-worker skill?▼

Do not use it in a session with no master session over it, or for returning a single hand-carried order. Those cases belong to session-handoff or ordinary standalone workflows.