master-session

Coordinates parallel sessions building an epic through wave planning, dispatch, and acceptance.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Large epics split across multiple parallel AI sessions need a single coordinator that plans the work into waves, launches batches, answers questions against the actual code, accepts returns, and keeps a durable ledger — without this role, parallel sessions drift, duplicate work, or deadlock on merges. ## Core Features & Use Cases - Wave planning and dispatch: Splits an epic into batches, launches them through hcb-dev:wave-dispatch, and opens each next wave only when its gate clears. - Event-driven coordination loop: Handles start reports, questions, statuses, returns, landings, and tracker edits per a defined protocol, recording every event in a wave ledger before moving on. - Acceptance and findings ruling: Accepts batch returns per the order-return protocol, rules tracker candidates through hcb-dev:findings-pass, and manages the merge queue without ever merging itself. - Use Case: You assign a session "ты — мастер-сессия" over a milestone; it files an umbrella issue, draws the wave plan, launches parallel worker sessions, coordinates their questions and landings, and closes the epic with a final report. ## Quick Start Tell the session to act as the master session for your epic or milestone and let it plan the waves and coordinate the parallel batches.

Frequently Asked Questions about master-session

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

FAQPage Schema
How do I coordinate multiple Claude Code sessions on one epic?▼

Assign one session the master-session role over the epic. It plans the work into waves, launches batches through wave-dispatch, answers batch questions after re-verifying against the tree, and accepts returns per the order-return protocol while keeping a wave ledger current.

What is a wave ledger in multi-session coordination?▼

The wave ledger is the master session's durable state record, hung on the epic's umbrella issue. Every event — launches, decisions, landings, candidate rulings — is written to it before the conversation moves on, and it is the first thing read after a restart.

Does the master session merge pull requests itself?▼

No. The merge is never the master session's to take — each batch takes its own merge and everything its completion owes behind it. The master manages the merge queue, speaks the go to the batch whose slot freed, and checks landings against the gates.

How does the master session recover after a restart or compaction?▼

It reads the wave ledger first, wears the master name recorded there, corrects the header if the host handed back a variant, then re-introduces itself to every batch still engaged with the standing plan and a status request.

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

Use master-session when coordinating a whole epic built by parallel sessions across waves. Use session-dispatch for writing one standalone order, and wave-worker when your session is itself one batch of a wave.