coordinator

Orchestrate and manage multiple worktree agents for software development workflows.

Updated Sep 1, 2024
One-click install
npx skills add https://github.com/jaesoekjjang/dotfiles --skill coordinator-jaesoekjjang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coordinator
Source: https://github.com/jaesoekjjang/dotfiles/tree/main/claude/skills/coordinator
Command: npx skills add https://github.com/jaesoekjjang/dotfiles --skill coordinator-jaesoekjjang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires workmux, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of coordinating multiple worktree agents, streamlining the process of spawning, monitoring, communicating, and merging their activities.

Core Features & Use Cases

  • Agent Orchestration: Spawn, monitor, communicate, and merge worktree agents.
  • Task Dispatching: Distribute tasks to agents using prompt files, ensuring self-contained context.
  • Status Tracking: Monitor the status of agents in real-time, including working, waiting, and done states.
  • Output Capture: Capture and review the output of agents for analysis and debugging.
  • Command Execution: Run shell commands directly in a worktree's pane with captured output and exit code.
  • Merge and Cleanup: Trigger merges and remove worktrees as needed.
  • Cross-Project Targeting: Send instructions and capture outputs from agents across different projects.
  • Use Case: For a software development project, coordinate multiple agents to implement features, write tests, and document changes, ensuring a smooth workflow.

Quick Start

Use the coordinator skill to spawn a new agent for implementing the auth module, then monitor its status and merge the changes when done.

Frequently Asked Questions about coordinator

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

FAQPage Schema
How do I coordinate multiple worktree agents for software development workflows?

To coordinate worktree agents, you can use a dispatcher role to spawn, monitor, and merge multiple agents concurrently. This allows you to distribute tasks using prompt files and track agent status in real-time across different projects.

Can I send instructions and run shell commands directly in a specific worktree agent?

Yes, you can send instructions to specific worktree agents and run shell commands directly in their panes. The system captures the command output and exit code for immediate analysis and debugging.

What is the best way to monitor the status of worktree agents after dispatching tasks?

The best way to monitor worktree agents is through real-time status tracking, which displays their current working, waiting, and done states. This allows you to review their captured outputs and trigger merges when tasks are complete.

Do I need workmux to manage task coordination across different projects?

Yes, workmux is a required dependency for task coordination. You need the workmux CLI and a dispatcher role to enable cross-project targeting, allowing you to send instructions and capture outputs from agents across separate projects.

How does agent orchestration handle merging and cleaning up worktrees?

Agent orchestration handles merging by triggering merges directly once an agent finishes its task. After the changes are successfully merged, it removes the worktree to clean up the workspace and maintain a smooth development workflow.