Skip to main content
subagent CX Codex

performance_engineer — Claude Code subagent: analysis and setup

The performance_engineer Claude Code subagent finds application, API, database, and infrastructure bottlenecks from measurements. It builds an optimization plan with baselines, experiments, and regression checks.

no license ★ 776 updated 2026-11-12

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

What performance_engineer does

The subagent reviews performance evidence and returns a Markdown report. It records the baseline, workload model, and evidence quality, then ranks bottleneck hypotheses and experiments with their expected trade-offs. The report covers CPU, memory, I/O, networking, concurrency, and databases.

It also sets out a benchmark protocol, acceptance thresholds, regression tests, and rollback steps. Measured facts stay separate from hypotheses and recommendations; benchmark results and production traffic are never fabricated. Benchmark output, profiles, traces, resource metrics, and architecture context can be supplied as supporting evidence, but they are optional.

What it helps with

  • locate API bottlenecks from measurements
  • rank experiments for a latency target
  • assess optimization trade-offs across CPU and memory
  • define acceptance thresholds and regression checks

Example prompts for the agent

  • Analyze these API performance measurements and create an optimization plan with baselines and regression checks.
  • Write a database performance report from these profiles and traces.
  • Compare the measured workload with the latency budget and rank the next experiments.

How to install performance_engineer

Manually: put the files in place

.claude/agents/performance_engineer.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 performance_engineer

How do I install performance_engineer in Claude Code?

Add the subagent file at .claude/agents/performance_engineer.md.

What does performance_engineer do?

It examines performance evidence for an application, API, database, or infrastructure and produces a Markdown report with bottleneck hypotheses, ranked experiments, and regression controls.

What evidence can performance_engineer use?

Provide a workload target, latency or throughput budget, environment, and constraints. Benchmark output, profiles, traces, resource metrics, and architecture context are optional supporting evidence.

Similar subagents

All subagents for Backend and APIs →

From the same set24

The whole set →
research_analyst The research_analyst Claude Code subagent turns a research question and supplied sources into a structured report. It compares conflicting claims and marks its own inferences separately. CX Codex ★ 776repo stars accessibility_tester accessibility_tester is a Claude Code subagent that reviews interface evidence for accessibility requirements. It covers keyboard use, focus, semantics, contrast, and interaction. CX Codex ★ 776repo stars business_requirements_analyst The business_requirements_analyst Claude Code subagent turns unclear stakeholder requests into testable business requirements. It connects goals to acceptance criteria and flags gaps or conflicting statements. CX Codex ★ 776repo stars test_driven_qa test_driven_qa — a subagent for Claude Code turns requirements and repository materials into a QA plan or test artifact. It ranks test scenarios and keeps observed evidence separate from proposed checks. CX Codex ★ 776repo stars refactoring_specialist refactoring_specialist — a subagent for Claude Code plans code refactoring while preserving observable behavior. It pairs structural changes with regression protection. CX Codex ★ 776repo stars research_queries The research_queries Claude Code skill turns research questions into targeted searches. It identifies entities, dates and constraints, then looks for evidence behind unresolved claims. CX Codex +1 ★ 776repo stars evidence_synthesis The evidence_synthesis Claude Code skill builds concise answers from supplied observations and task materials. It links claims to evidence and distinguishes reported facts from model inference. CX Codex +1 ★ 776repo stars source_verification The source_verification Claude Code skill ties claims to supporting sources. It helps check dates, figures, and entity identity in research responses. CX Codex +1 ★ 776repo stars

Project sponsors

Companies that keep this analytics open