Benchmark Suite — Claude Code subagent: what it does, how to install
Benchmark Suite runs throughput and latency benchmarks, measures resource consumption, and detects performance regressions in agent clusters.
no license ★ 850 updated 2026-10-26
.claude/agents/benchmark-suite.mdWhat Benchmark Suite does
The subagent handles structured benchmarking across latency, throughput, resource usage, and scalability. In distributed setups, it evaluates agent coordination, network topology, fault tolerance, and load balancing between nodes.
Runs can execute sequentially or concurrently. A full test run applies 30 seconds of warmup and 10 seconds of cooldown, cycling through iterations before reporting metrics. Regression analysis combines CUSUM change-point statistical detection with anomaly scoring. Baseline comparisons require prior historical runs to measure divergence.
What it helps with
- Measure latency and processing throughput under sequential or parallel loads
- Assess fault tolerance, node coordination, and topology changes in distributed swarms
- Catch performance regressions using CUSUM change-point statistical algorithms
- Flag anomalous metric shifts against historical baselines via anomaly detection models
Example prompts for the agent
- Execute parallel latency and throughput benchmark suites with a 30-second warmup period
- Test cluster fault tolerance and agent coordination under high concurrent load
- Compare current benchmark outputs against historical baselines using CUSUM regression checks
How to install Benchmark Suite
Manually: put the files in place
.claude/agents/benchmark-suite.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/benchmark-suite.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/benchmark-suite.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 Benchmark Suite
How to install Benchmark Suite in Claude Code?
Add the agent definition file at .claude/agents/benchmark-suite.md inside your project root directory.
What does Benchmark Suite do?
It coordinates benchmark runs, tracks resource footprints, and spots performance degradation across swarm setups.
How does it detect performance regressions?
The agent relies on CUSUM change-point statistical tracking alongside machine learning anomaly detection models.