Skip to main content
subagent CX Codex

hierarchical-coordinator — Claude Code subagent

hierarchical-coordinator — a coordinator subagent that splits a job into sub-tasks and hands them to worker agents through the claude-flow MCP server. Fits work that runs top-down.

no license ★ 850 updated 2026-10-26

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/hierarchical-coordinator.md
Open on GitHub

What hierarchical-coordinator does

This one sits at the top of a small hierarchy. It reads the task, cuts it into work packages, and spawns a worker for each: researcher, coder, analyst, tester. Spawning goes through mcp__claude-flow__agent_spawn with a capability list.

Two hooks wrap the run. The pre hook calls mcp__claude-flow__swarm_init hierarchical --maxAgents=10 --strategy=adaptive, saves coordination state to memory and starts monitoring at an interval of 5000. The post hook writes a detailed performance report, then runs coordination_sync to clean up.

Both hooks call mcp__claude-flow__* tools, so the claude-flow MCP server has to be connected first. Without it you get a markdown prompt full of dead calls. A separate path uses AttentionService from agentdb with hyperbolic attention and a queen weight of 1.5; that one needs the agentdb package installed.

What it helps with

  • break a large feature into sub-tasks and route them to the right worker
  • run a swarm capped at 10 agents
  • watch swarm state on a 5000 interval
  • pull a performance report once the run ends
  • settle clashing edits between a coder and a tester worker

Example prompts for the agent

  • Use hierarchical-coordinator to split this migration into sub-tasks and hand them to workers.
  • Run the refactor through hierarchical-coordinator with no more than 10 agents.
  • After the test run, have hierarchical-coordinator pull the swarm performance report.

How to install hierarchical-coordinator

Manually: put the files in place

.claude/agents/hierarchical-coordinator.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about hierarchical-coordinator

How do I install hierarchical-coordinator in Claude Code?

Put the subagent file at .claude/agents/hierarchical-coordinator.md inside your project. Claude reads subagents from that folder.

What does hierarchical-coordinator do?

It plans at the top level: decomposes the goal, spawns specialised workers and supervises them. Worker roles are researcher, coder, analyst and tester.

Does it work without the claude-flow MCP server?

No. The hooks call mcp__claude-flow__* tools, so spawning, monitoring and the performance report all need that server connected.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set76

The whole set →
release-manager release-manager runs a multi-package release: version bumps, tests, deploy and rollback, then keeps what worked in memory for the next one. CX Codex ★ 850repo stars Performance Monitor Performance Monitor collects system and agent metrics, hunts bottlenecks and watches SLA thresholds. Useful when several agents run at once and it is unclear which one is slow. CX Codex ★ 850repo stars Benchmark Suite Benchmark Suite runs throughput and latency benchmarks, measures resource consumption, and detects performance regressions in agent clusters. CX Codex ★ 850repo stars security-manager security-manager — a Claude Code subagent that embeds cryptographic security into distributed consensus protocols. Runs on critical operations, verifying threshold signatures, detecting attacks, and encrypting node communications. CX Codex ★ 850repo stars refinement SPARC methodology subagent for iterative code refinement. Optimizes architecture, runs test suites, and learns from refactoring history. CX Codex ★ 850repo stars workflow-automation workflow-automation is a Claude Code subagent that creates and updates GitHub Actions workflows. It handles CI/CD setup requests and workflow run analysis. CX Codex ★ 850repo stars Topology Optimizer Topology Optimizer — a subagent that scores swarm topologies — hierarchy, mesh, ring, star, hybrid — against your workload and says which one to switch to. CX Codex ★ 850repo stars crdt-synchronizer crdt-synchronizer — a Claude Code subagent for conflict-free state synchronization across nodes using CRDT structures and vector clocks. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open