# tester

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/core/tester.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/ruvnet-tester

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/tester.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/tester.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/tester.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/ruvnet/agentic-flow/tree/HEAD/.claude/agents/core/tester.md

## When to use it
- 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
- Write unit tests for `UserService` with mocked repository methods
- Set up integration tests for the `/users` endpoint with a test database and verify response shapes
- Find and test edge cases: empty collections, maximum string lengths, burst concurrent requests

## Similar
- [nextjs-api-tester](https://affpapa.org/en/nevibecode/commands/nextjs-api-tester.md) — command · 479 installs
- [qe-learning-optimization](https://affpapa.org/en/nevibecode/skills/qe-learning-optimization.md) — skill · 121 installs
- [test-audit](https://affpapa.org/en/nevibecode/skills/mblode-test-audit.md) — skill · 283 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/glebis-tdd.md) — skill · 262 installs
- [qe-iterative-loop](https://affpapa.org/en/nevibecode/skills/qe-iterative-loop.md) — skill · 126 installs
- [test-guard](https://affpapa.org/en/nevibecode/skills/test-guard.md) — skill · 4400 installs

## Other versions with the same name
- [tester · ruvnet](https://affpapa.org/en/nevibecode/agents/tester.md) — ★ 850 repo stars
- [tester · josstei](https://affpapa.org/en/nevibecode/agents/josstei-tester.md) — ★ 489 repo stars

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 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
