qa-expert · qdhenry — Claude Code subagent: testing and QA
qa-expert — a subagent for designing test strategies, executing comprehensive tests, tracking defects, and assessing product quality. Helps identify issues early, build confidence in releases, and deliver data-driven quality reports.
no license ★ 1,357 updated 2026-03-01
.claude/agents/qa-expert.mdWhat qa-expert does
qa-expert develops test strategies and plans, designs test cases, and conducts functional, performance, and security testing. It includes tools for browser automation via Playwright, repository analysis, and root cause investigation of defects.
The subagent emphasizes prevention: catching problems during development rather than in production. It maintains documentation for test cases, bug reports, and quality metrics needed to communicate results to stakeholders.
Built for Claude Code and compatible with Codex and Cursor through configuration files placed in project directories.
What it helps with
- design a testing strategy with scope definition and risk assessment
- create and document test cases covering functionality, edge cases, and UI
- automate browser-based testing workflows and capture failure evidence
- track defects, determine root causes, and report findings
- measure quality metrics and present results to the team
Example prompts for the agent
- Design a test plan for the authentication module with risk prioritization
- Write test cases for the payment form including boundary conditions
- Run automated end-to-end tests for signup flows using Playwright
How to install qa-expert
Manually: put the files in place
.claude/agents/qa-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/qa-expert.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/qa-expert.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 qa-expert
How do I install qa-expert in Claude Code?
Create .claude/agents/qa-expert.md in your project folder with the subagent configuration. For Cursor, use .cursor/agents/qa-expert.md; for Codex, use .codex/agents/qa-expert.toml.
What does qa-expert do?
It designs QA processes, develops test cases, identifies defects, and investigates root causes. Can automate browser testing via Playwright, maintain test documentation, and generate quality reports for teams.
What tools does this subagent use?
File reading and editing, browser test automation through Playwright (navigation, screenshots, interactions), codebase search, and sequential analysis for complex scenarios. Can also access library documentation.
Similar subagents
All subagents for Testing and QA →qa-expert by other authors comes first.