# tester

tester is a Claude Code subagent that creates tests and checks code, recording past failures in claude-flow.

- 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/agentic-flow/.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/tester

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

## 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/agentic-flow/.claude/agents/core/tester.md

## When to use it
- 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
- 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

## 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-runner](https://affpapa.org/en/nevibecode/agents/test-runner.md) — subagent · 846 installs
- [test-coverage](https://affpapa.org/en/nevibecode/skills/test-coverage.md) — skill · 1900 installs
- [huawei-cloud-skill-tester](https://affpapa.org/en/nevibecode/skills/huawei-cloud-skill-tester.md) — skill · 626 installs
- [testing-best-practices](https://affpapa.org/en/nevibecode/skills/testing-best-practices.md) — skill · 975 installs

## Other versions with the same name
- [tester · ruvnet](https://affpapa.org/en/nevibecode/agents/ruvnet-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
