party-to-pipeline

Orchestrates multi-window Claude Code pipelines with DB-backed handshake lifecycle management.

10|3|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill party-to-pipeline-cynthia1070711
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: party-to-pipeline
Source: https://github.com/Cynthia1070711/PHYCOOL_Tools/tree/main/config-templates/claude/skills/party-to-pipeline
Command: npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill party-to-pipeline-cynthia1070711

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Coordinating multiple Claude Code sub-windows to execute Story pipelines (create-story, dev-story, code-review) requires reliable dispatch, completion detection, review gating, and window cleanup; this Skill provides the full controller-side SOP and scripts so no phase is lost, double-dispatched, or force-killed. ## Core Features & Use Cases - Three dispatch modes: Mode A (Party Mode discussion then Story creation), Mode B (skip discussion when a backlog stub exists), and Mode C (general non-Story tasks driven directly by the main window via dispatch-general.ps1 and worker-general.ps1). - DB-backed handshake closed loop: worker_runs.lifecycle state machine (dispatching → running → reported → awaiting-review → approved → closed) with ack_worker_run / gate_worker_run MCP tools, preflight five-checks, and close-worker.ps1 as the only programmatic window-close path. - Guardian and knock mechanisms: pipeline-guardian.ps1 resident watcher (zero-kill, stall detection), plus console-knock.ps1 / knock-worker.ps1 / knock-controller.ps1 for injecting one-line prompts into idle windows. - Use Case: A controller window dispatches a dev-story phase to a sub-window, receives the reported notification, runs the six-evidence GATE check, acknowledges and approves the run, closes the worker window, and commits the phase with a pathspec-scoped git commit. ## Quick Start Ask the AI to dispatch Story X through the pipeline using dispatch-general.ps1 with the create-story phase and then follow the handshake loop through ack, gate, and close-worker.

Frequently Asked Questions about party-to-pipeline

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

FAQPage Schema
How do I dispatch a Story pipeline across multiple Claude Code windows?

Run dispatch-general.ps1 with -StoryId and -Phase (create-story, dev-story, or code-review) from the main controller window. The script registers the run in worker_runs, spawns the worker sub-window, confirms startup within a bounded window, and exits without waiting.

What is the difference between Mode A, Mode B, and Mode C?

Mode A runs Party Mode multi-agent discussion before creating a Story. Mode B skips discussion when a backlog stub already satisfies four completeness conditions. Mode C handles non-Story general tasks like batch corrections or documentation directly from the main window without BMAD workflows.

How does the worker handshake lifecycle work in worker_runs?

The lifecycle moves from dispatching to running, then reported when the worker Stop hook fires, awaiting-review after the controller calls ack_worker_run, and approved or revising after gate_worker_run. Approved runs are closed via close-worker.ps1, which writes the terminal CAS state before taskkill.

Can worker windows be closed automatically or killed by the guardian?

No. Worker windows never auto-close, and pipeline-guardian.ps1 only observes and flags stalled runs without killing anything. The only programmatic close path is close-worker.ps1, and direct taskkill calls are hard-blocked by worker-kill-guard.js for active runs.

When should I use git worktree isolation for parallel dispatches?

Use the -Worktree flag on dispatch-general.ps1 for high-conflict-risk batches where multiple workers might race on the git index. It is opt-in per dispatch, keeps the control plane pinned to main, and does not solve semantic merge conflicts, which still require task splitting.

Why was the E1 orchestrator.ps1 batch mode frozen?

E1 relied on file-based ACK and Wait-WindowClosed, but worker-side ack reading and auto-close were removed, so every phase ended in a forced kill via Stop-WorkerSafe. This violated the notify-only rule, so E1 is frozen and batch needs are handled by sequential E2 dispatches.