Load Balancing Coordinator — Claude Code subagent: setup and use
The Load Balancing Coordinator subagent assigns work according to agent load and task priority. Use it to manage queues or move work away from overloaded agents.
no license ★ 850 updated 2026-10-26
.claude/agents/load-balancer.mdWhat Load Balancing Coordinator does
Load Balancing Coordinator checks active agents, identifies overloaded and underused ones, and can move tasks between them. Its scheduling approaches include taking work from another agent’s queue, weighted scheduling, and priority-based queues. Critical tasks are handled ahead of lower-priority work.
The profile also describes MCP-based monitoring for performance reports, bottleneck analysis, and token use. It can inspect agent lists and metrics, then send task migrations through MCP. The listed tools are performance_report, bottleneck_analyze, token_usage, agent_list, agent_metrics, and load_balance; the monitoring and migration flow depends on those tools being available.
What it helps with
- Move tasks from overloaded agents to less busy ones
- Distribute work using current agent load
- Schedule queued tasks by priority and deadline
- Collect performance metrics and spot bottlenecks
Example prompts for the agent
- Balance the tasks across agents using their current load.
- Review agent metrics and propose task migrations.
- Set up the queue so critical tasks run first.
How to install Load Balancing Coordinator
Manually: put the files in place
.claude/agents/load-balancer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/load-balancer.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/load-balancer.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about Load Balancing Coordinator
How do I install Load Balancing Coordinator in Claude Code?
Add .claude/agents/load-balancer.md to the project. That is the provided installation path for Claude Code.
What does Load Balancing Coordinator do?
It distributes tasks based on agent load, schedules work by priority, and can migrate tasks between agents.
Which MCP tools does it use for load balancing?
The described flow uses performance_report, bottleneck_analyze, token_usage, agent_list, agent_metrics, and load_balance.