Multi-Worker Parallel Orchestration Skill

Overview

Parallel execution of plans using Claude and/or Copilot CLI workers in Kitty terminal tabs. Supports mixed-engine mode where Claude handles complex tasks and Copilot handles mechanical ones.

When to Use

• Complex tasks with 4+ independent subtasks
• Release preparations with multiple verification steps
• Large refactoring across multiple file domains
• Any plan created by strategic-planner agent

Requirements

Quick Start

# Claude-only (default):
orchestrate.sh <plan> 4

# Copilot-only (all workers use copilot --yolo):
orchestrate.sh <plan> 4 --engine copilot

# Mixed (Claude for complex, Copilot for codex:true tasks):
orchestrate.sh <plan> 4 --engine mixed

# Monitor (detects both Claude-N and Copilot-N tabs):
claude-monitor.sh

# Launch single worker by type:
worker-launch.sh claude "Claude-2" <task_db_id> --cwd /worktree
worker-launch.sh copilot "Copilot-3" <task_db_id> --cwd /worktree

# Standalone Copilot worker (no Kitty needed):
copilot-worker.sh <task_db_id> --model claude-sonnet-4-5 --timeout 600

Integration with Agents

strategic-planner

The strategic-planner agent can create plans with Claude assignments and execute them in parallel:

@strategic-planner Create an execution plan for [task] with parallel execution

When asked "Vuoi eseguire in parallelo?", it will:

1. Verify Kitty environment
2. Launch Claude workers
3. Send tasks to each worker
4. Monitor progress
5. Report completion

Plan Format

Plans for parallel execution must include:

## 🎭 RUOLI CLAUDE

| Claude   | Role        | Tasks      | Files           |
| -------- | ----------- | ---------- | --------------- |
| CLAUDE 1 | Coordinator | Monitor    | -               |
| CLAUDE 2 | Implementer | T-01, T-02 | src/api/        |
| CLAUDE 3 | Implementer | T-03, T-04 | src/components/ |
| CLAUDE 4 | Implementer | T-05       | src/lib/        |

Critical Rules

1. NO FILE OVERLAP - Avoid git conflicts
2. MAX 4 WORKERS - Beyond = chaos
3. VERIFY LAST - lint/typecheck/build at end
4. GIT COORDINATION - One commit at a time
5. WORKTREE MANDATORY - Every worker runs worktree-guard.sh first. NEVER on main.
6. COPILOT: --yolo - Always use copilot --yolo for full autonomy (no confirmation prompts)

Copilot CLI Flags Reference

Scripts

Related

• Agent: .claude/agents/core_utility/strategic-planner.md
• Global config: ${CLAUDE_HOME:-.claude}/commands/planner.md
• Drift check: plan-db.sh drift-check <plan_id>