# test-engineer

test-engineer generates tests for critical business logic right after a feature or bug fix, skipping tests written purely to inflate coverage numbers.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/test-engineer.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/samarth-gupta-test-engineer

## What it does

The subagent runs in two modes. Advisor handles quick questions — unit versus integration, how to mock a dependency, whether existing tests are brittle — by grounding answers in the project's own conventions rather than generic testing rules. Generator mode kicks in on explicit requests like writing tests or running a gap analysis, and also fires automatically right after new code lands, scoped to the diff.

In Generator mode it first reads manifest files such as `package.json`, `pyproject.toml`, `Cargo.toml` or `go.mod` to detect the stack and test runner, then judges project maturity to decide how aggressive to be: an early-stage MVP gets tests for the two or three paths that would break the business, a mature codebase gets strategic gap-filling instead of blanket coverage. Gaps get ranked from critical (untested business logic) down to low (simple utilities nobody needs to test).

It runs the tests it writes through `Bash`, but only with read-only commands — `git diff`, `git log`, test runner calls — never `rm`, `mv`, `git commit`, or package installs like `npm install`. If a test fails for lack of environment variables or infrastructure, it reports the gap instead of touching the implementation. Code quality review and performance benchmarking sit outside its scope, handled by separate code-auditor and performance-auditor agents in the same repository.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-coding@Claudest
```

2. **Manually: put the files in place**
- File: `.claude/agents/test-engineer.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/test-engineer.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/test-engineer.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/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/test-engineer.md

## When to use it
- find untested critical paths after shipping a feature or fix
- write tests for business logic instead of chasing a coverage number
- decide between a unit test and an integration test
- judge a project's test maturity and set a phased plan
- flag brittle or redundant tests in an existing suite

## Example prompts
- Write tests for the payment flow I just implemented
- Run a test gap analysis on the auth module
- Should this UI formatting function even have a test?

## Similar
- [test-suite-curation](https://affpapa.org/en/nevibecode/skills/test-suite-curation.md) — skill · 1300 installs
- [Python Unit Test Generator — Comprehensive, Coverage-Mapped & Production-Ready](https://affpapa.org/en/nevibecode/prompts/python-unit-test-generator-comprehensive-coverage-mapped-production-ready.md) — prompt · ★ 178201 repo stars
- [test-automator](https://affpapa.org/en/nevibecode/agents/qdhenry-test-automator.md) — subagent · ★ 1357 repo stars
- [test-architect](https://affpapa.org/en/nevibecode/agents/test-architect.md) — subagent · ★ 1424 repo stars
- [test-gap-analysis](https://affpapa.org/en/nevibecode/skills/test-gap-analysis.md) — skill · 4700 installs
- [test-coverage-mcp](https://affpapa.org/en/nevibecode/mcp/test-coverage-mcp.md) — MCP server · ★ 42 repo stars

## Other versions with the same name
- [test-engineer · anthropics](https://affpapa.org/en/nevibecode/agents/test-engineer.md) — 9715 installs
- [test-engineer · alirezarezvani](https://affpapa.org/en/nevibecode/agents/alirezarezvani-test-engineer.md) — ★ 788 repo stars
- [test-engineer · qdhenry](https://affpapa.org/en/nevibecode/agents/qdhenry-test-engineer.md) — ★ 1357 repo stars
- [test-engineer · managedcode](https://affpapa.org/en/nevibecode/agents/managedcode-test-engineer.md) — ★ 521 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 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
