# performance-engineer

performance-engineer is a Claude Code subagent for finding performance bottlenecks and planning optimization work. It joins tasks involving scalability, profiling, or load testing.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/infrastructure/performance-engineer.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/qdhenry-performance-engineer

## What it does

performance-engineer analyzes application performance across frontend, backend, infrastructure, and databases. It can assess architecture for scalability, investigate slow queries, and plan load tests. Its tools include profiling and monitoring utilities, plus Playwright for checking web pages.

The agent starts by measuring baseline performance, then prioritizes bottlenecks and proposes ways to validate changes. Context7 can supply technical documentation, while sequential thinking supports analysis and planning. Its focus areas also include Core Web Vitals, caching, capacity planning, and detecting regressions in CI/CD.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/performance-engineer.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/performance-engineer.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/performance-engineer.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/infrastructure/performance-engineer.md

## When to use it
- trace the cause of a slow application
- assess architecture for expected growth
- plan load tests for an API
- optimize slow database queries

## Example prompts
- Ask performance-engineer to find bottlenecks in this application.
- Ask performance-engineer to assess the architecture for higher load.
- Ask performance-engineer to draft a load-testing plan for the API.

## Similar
- [application-performance-performance-engineer](https://affpapa.org/en/nevibecode/agents/application-performance-performance-engineer.md) — subagent · ★ 42780 repo stars
- [agent-performance-engineer](https://affpapa.org/en/nevibecode/skills/agent-performance-engineer.md) — skill · 556 installs
- [performance-testing](https://affpapa.org/en/nevibecode/skills/proffesor-for-testing-performance-testing.md) — skill · 144 installs
- [performance-expert](https://affpapa.org/en/nevibecode/skills/performance-expert.md) — skill · 198 installs
- [performance-tuner](https://affpapa.org/en/nevibecode/agents/performance-tuner.md) — subagent · ★ 788 repo stars
- [performance-optimization](https://affpapa.org/en/nevibecode/skills/performance-optimization.md) — skill · 82600 installs

## Other versions with the same name
- [performance-engineer · voltagent](https://affpapa.org/en/nevibecode/agents/performance-engineer.md) — 671 installs
- [performance-engineer · superclaude-org](https://affpapa.org/en/nevibecode/agents/superclaude-org-performance-engineer.md) — ★ 23950 repo stars
- [performance-engineer · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-performance-engineer.md) — ★ 6505 repo stars
- [performance-engineer · rohitg00](https://affpapa.org/en/nevibecode/agents/rohitg00-performance-engineer.md) — ★ 2858 repo stars
- [performance-engineer · josstei](https://affpapa.org/en/nevibecode/agents/josstei-performance-engineer.md) — ★ 489 repo stars

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
