tester · ruvnet, agentic-flow — Claude Code subagent: what it does, how to install
tester is a Claude Code subagent that creates tests and checks code, recording past failures in claude-flow.
no license ★ 850 updated 2026-10-26
.claude/agents/tester.mdWhat tester does
This subagent constructs unit, integration, and browser-driven end-to-end test suites. It focuses on boundary checks, network timeouts, null data handling, and concurrency. Before executing validation work, it inspects the project directory for jest.config.js or vitest.config.ts.
Its lifecycle hooks interface with claude-flow storage. Before executing, it queries past task failures to avoid repeating bugs and loads high-reward test patterns. Afterward, it evaluates npm test JSON output using jq, computes a reward ratio, and triggers neural pattern training whenever more than 50 tests pass.
The automation hooks depend directly on npx claude-flow, jq, and the bc terminal calculator. If these CLI utilities are missing from your environment, post-test metric calculations will crash.
What it helps with
- generate unit and integration test suites for backend services
- validate edge cases including empty payloads and timeouts
- track test failure records across tasks using shared memory
- evaluate test execution summaries from JSON reporter output
Example prompts for the agent
- Write unit tests for UserService covering edge cases and duplicate emails
- Create an end-to-end test for the registration page flow
- Run the full test suite and log performance stats to memory
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 to install tester in Claude Code?
Place the subagent definition file into .claude/agents/tester.md.
What does tester do?
It designs unit and integration tests, evaluates failure conditions, and preserves testing history inside persistent memory.
What tools must be present for tester hooks to run?
The hooks require npx claude-flow, npm test, and the command-line tools jq and bc.
Similar subagents
All subagents for Testing and QA →tester by other authors comes first.