tester · ruvnet — Claude Code subagent: unit, integration, E2E testing
tester — a subagent that designs and runs tests across the pyramid: units with mocks, integration against a real database, E2E flows, performance checks, and security validation. Keeps coverage above 80% and catches bugs early.
no license ★ 850 updated 2026-10-26
.claude/agents/tester.mdWhat tester does
tester handles all testing duties: writing unit tests with mocks, integration tests that spin up a test database, E2E scenarios, and security probes for SQL injection and XSS. It auto-detects Jest or Vitest configuration and hooks into the build, generating coverage reports and test summaries before deploy.
The subagent includes templates for boundary conditions (max string length, empty arrays, concurrent requests), performance benchmarks (memory usage, execution time), and security checks (injection attacks, markup escaping). Every test gets documented with prerequisites and expected outcome so contributors understand the intent.
Requires Jest or Vitest already in your project to run. Coordinates through MCP to share status with other agents in the workflow.
What it helps with
- write unit tests for a service with repository mocks
- set up integration tests against a test database
- validate code against SQL injection and XSS vulnerabilities
- measure execution time and memory allocation
- generate coverage reports and display them pre-deploy
Example prompts for the agent
- Write unit tests for
UserServicewith mocked repository methods - Set up integration tests for the
/usersendpoint with a test database and verify response shapes - Find and test edge cases: empty collections, maximum string lengths, burst concurrent requests
How to install tester
Manually: put the files in place
.claude/agents/tester.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/tester.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/tester.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 tester
How do I install tester in Claude Code?
Create the file .claude/agents/tester.md with the subagent configuration. Claude Code will detect it on next run and integrate tester into your agent workflow.
What does tester do?
Designs and writes tests across the full pyramid: unit tests with mocks, integration tests against a real database, E2E user flows. Checks for security risks (SQL injection, XSS), measures performance, and ensures coverage stays above 80%.
Which test frameworks does tester support?
Jest and Vitest. The subagent auto-detects jest.config.js or vitest.config.ts in your project. If neither exists, it will prompt you to set one up.
Similar subagents
All subagents for Testing and QA →tester by other authors comes first.