Skip to main content
subagent CX Codex

Topology Optimizer — Claude Code subagent: what it does

Topology Optimizer — a subagent that scores swarm topologies — hierarchy, mesh, ring, star, hybrid — against your workload and says which one to switch to.

no license ★ 850 updated 2026-10-26

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

What Topology Optimizer does

Give it a running swarm and a workload profile. It reads the layout you have now, builds candidate topologies, scores each one and comes back with a pick plus a migration plan and a downtime estimate. Candidates include hybrids and layouts the model proposes on its own.

Three parts do the work. One handles topology choice: analysis of the current state, candidate generation, multi-objective selection, migration planning. Another hunts latency: where agents sit, routing tables, caching, compression. A third searches for good agent placement with several algorithms at once — genetic, simulated annealing, particle swarm, graph partitioning, machine learning — and merges the strongest results.

It needs something to measure. With no existing swarm topology and no workload profile there is nothing to compare, and a small gain gets you an empty answer. The improvement threshold comes from constraints, and the fallback is 0.1.

What it helps with

  • Pick a topology that holds up under a new workload
  • Compare mesh against hierarchy before switching
  • Get a migration plan with a downtime estimate
  • Find slow routes and stale caches between agents
  • Run several placement algorithms and keep the best mix

Example prompts for the agent

  • Use Topology Optimizer on my swarm: is mesh better than ring for this workload?
  • Check agent placement and give me a migration plan with minimal downtime
  • Optimize latency across the messaging patterns and tell me what to change first

How to install Topology Optimizer

Manually: put the files in place

.claude/agents/topology-optimizer.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 Topology Optimizer

How do I install Topology Optimizer in Claude Code?

Put the subagent file at .claude/agents/topology-optimizer.md in your project. That is the whole step.

What does Topology Optimizer do?

It analyzes the swarm topology, generates alternatives and picks the best one for your workload across several metrics. The answer carries the recommendation, the expected gain and a migration plan.

What does it need to run?

A live swarm with its current topology and a workload profile. Pass limits through constraints, including the improvement threshold below which no switch is suggested.

Similar subagents

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

From the same set76

The whole set →
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 hierarchical-coordinator 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. 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 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 sublinear-goal-planner sublinear-goal-planner — a Claude subagent that breaks a big goal into actions with dependencies and looks for the cheapest route through the action graph. CX Codex ★ 850repo stars performance-benchmarker performance-benchmarker is a Claude Code subagent that measures throughput, latency, and resource use to compare Byzantine, Raft, and Gossip consensus protocols. CX Codex ★ 850repo stars quorum-manager The quorum-manager subagent adjusts quorum settings, manages membership, and checks network conditions for distributed consensus workflows. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open