coordinator

Orchestrate multiple git worktree agents via workmux CLI commands.

2|Updated Oct 16, 2021
One-click install
npx skills add https://github.com/pattobrien/dotfiles --skill coordinator-pattobrien
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: coordinator
Source: https://github.com/pattobrien/dotfiles/tree/main/claude/skills/coordinator
Command: npx skills add https://github.com/pattobrien/dotfiles --skill coordinator-pattobrien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing multiple parallel coding agents across git worktrees is chaotic without a central dispatcher. This Skill turns the AI into a coordinator that spawns, monitors, instructs, and merges worktree agents using the workmux CLI, so parallel tasks stay organized and conflicts are avoided. ## Core Features & Use Cases - Agent Spawning: Write self-contained prompt files and launch background agents with workmux add, each in its own git worktree and branch. - Monitoring & Communication: Check agent statuses, wait for completion with timeouts, capture output, and send follow-up instructions or skill commands like /merge. - Fan-out / Fan-in Workflows: Spawn several agents in parallel, wait for all to finish, review captured output, then merge branches one at a time to avoid conflicts. - Use Case: You need an auth module, API tests, and docs updated simultaneously. The coordinator writes three prompt files, spawns three worktree agents, waits for completion, reviews each output, and sequentially triggers merges. ## Quick Start Ask the AI to coordinate worktree agents by spawning a background agent for each task, waiting for them to finish, and merging their branches one at a time.

Frequently Asked Questions about coordinator

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

FAQPage Schema
How do I run multiple Claude Code agents in parallel?▼

Write a self-contained prompt file for each task, then spawn background agents with `workmux add <handle> -b -P <file>`. Each agent runs in its own git worktree and tmux window, and you monitor them with `workmux status` and `workmux wait`.

How do I merge branches from parallel worktree agents?▼

Send `/merge` to each agent with `workmux send <handle> "/merge"` so the agent handles rebasing and conflict resolution itself. Merge one agent at a time and wait for each to finish before starting the next to avoid conflicts.

Can workmux agents in different projects communicate?▼

Yes, agent commands like send, capture, status, wait, and run resolve handles globally across projects. Use the `project:handle` syntax to disambiguate when worktree names collide, while lifecycle commands like add and remove stay repo-scoped.

Why does workmux wait return a non-zero exit code?▼

Exit code 1 means the timeout was reached, 2 means the worktree was not found, and 3 means the agent exited unexpectedly. Always pass `--timeout` and handle these exit codes gracefully in coordination workflows.

What are the limitations of delegating tasks to worktree agents?▼

Agents cannot see the coordinator's conversation, so prompt files must be fully self-contained with verbatim context and relative paths. The coordinator must never edit source files directly and should not delegate skills unless explicitly instructed.