Skip to main content
subagent CX Codex

test-engineer · gupsammy — Claude Code subagent: what it does, how to install

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

no license ★ 276 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@Claudest
Open on GitHub

What test-engineer 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.

What it helps with

  • 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 for the agent

  • 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?

How to install test-engineer

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@Claudest

2Manually: put the files in place

.claude/agents/test-engineer.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about test-engineer

How to install test-engineer in Claude Code?

Run /plugin marketplace add gupsammy/Claudest, then /plugin install claude-coding@Claudest.

What does test-engineer do?

It scans changed code for untested critical business paths and writes tests for them, or gives advisor-style guidance on test strategy without generating code.

How does test-engineer differ from code-auditor?

test-engineer only handles testing — coverage gaps and test generation. Code quality review is a separate agent, code-auditor, and performance checks go to performance-auditor.

Similar subagents

All subagents for Testing and QA →

test-engineer by other authors comes first.

test-engineer official Anthropic The test-engineer subagent captures legacy behavior in tests and compares it with a rewritten implementation. Use it before changing existing modules. CX Codex 9,715installs test-engineer alirezarezvani The test-engineer subagent examines code and plans tests from unit checks to integration and E2E scenarios. Use it when basic test scaffolding needs deeper coverage. CX Codex ★ 788repo stars test-engineer qdhenry test-engineer writes unit, integration and end-to-end tests for the code you just finished, then reports coverage by line, branch and function. Useful when a feature works but nothing guards it. CX Codex ★ 1,357repo stars test-engineer managedcode test-engineer — a subagent for generating, repairing, and improving tests across languages. Works with your project's existing test framework and coordinates specialists for bulk test generation and quality assessment. CX Codex ★ 521repo stars test-suite-curation kindlmann test-suite-curation is a Claude Code skill that audits a regression suite for duplicate, outdated, and low-value tests. It activates on requests to review the suite or split it into smoke, core, and extended tiers. CX Codex +1 1,300installs Python Unit Test Generator — Comprehensive, Coverage-Mapped & Production-Ready sivasaiyadav8143 Python Unit Test Generator — Comprehensive, Coverage-Mapped & Production-Ready is a prompt that turns a Python snippet into a pytest suite with a coverage map and mocks for external dependencies. GP ChatGPT ★ 178,201repo stars test-automator qdhenry test-automator is a Claude Code subagent that plans automated tests and connects them to CI/CD. It activates for coverage work or when a project needs a testing setup from scratch. CX Codex ★ 1,357repo stars test-architect CloudAI-X test-architect — a Claude Code subagent for test planning, test writing, coverage checks, and flaky-test analysis. Use it when changing features or fixing bugs. CX Codex ★ 1,424repo stars test-gap-analysis dotnet test-gap-analysis maps which caller-visible production outcomes could change without any existing test failing. Useful before you trust a suite to guard a change. CX Codex +1 4,700installs test-coverage-mcp goldbergyoni test-coverage-mcp feeds your coding agent real coverage numbers from an LCOV file, so it can tell whether its edits helped or hurt the tests. CX Codex +1 ★ 42repo stars

From the same set47

The whole set →
extract-frames extract-frames detects shot boundaries in a video and saves the first or last frame of each shot. Use it to review an edit or collect frames from selected shots. CX Codex +1 ★ 276repo stars search-youtube search-youtube finds YouTube videos, pulls transcripts and metadata, downloads audio and walks a channel's uploads through a single CLI the agent calls on its own. CX Codex +1 ★ 276repo stars improve-skill improve-skill audits skill effectiveness, simulates user requests, and pinpoints missing capabilities in instructions. CX Codex +1 ★ 276repo stars performance-auditor The performance-auditor subagent inspects code for algorithmic, data-access, and resource bottlenecks. Use it after changes on hot paths or when you need to reason about how code scales. CX Codex ★ 276repo stars claude-memory-architecture claude-memory-architecture defines the technical architecture for the claude-memory plugin, detailing hook lifecycles, SQLite database operations, lock handling, and local vector indexing. CX Codex +1 ★ 276repo stars extract-learnings extract-learnings is a Claude Code skill that saves project knowledge and keeps memory notes organized. Record a finding or consolidate existing notes. CX Codex +1 ★ 276repo stars code-auditor code-auditor goes over the code you just changed, flags logic bugs, vague names and leftovers, then says in plain words what needs fixing. CX Codex ★ 276repo stars create-skill create-skill guides Claude Code through building a skill or slash command by clarifying its purpose and activation scenarios. Use it to draft a new instruction file. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open