Skip to main content
subagent CX Codex

test-automator · voltagent/awesome-codex-subagents — Codex subagent: automated tests and regression coverage

test-automator — a subagent for writing and improving automated tests. Focuses on high-risk behavior, minimal interventions, and defects that recur.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/test-automator.toml
Open on GitHub

What test-automator does

test-automator analyzes code changes and maps the failure surface, then recommends or implements the smallest set of tests with the highest risk reduction. It works in steps: first maps the boundary of affected behavior and likely failure points, then separates confirmed findings from hypotheses, then implements or suggests the concrete intervention.

It validates three paths: normal, failure, and integration edge case. Keeps test suites deterministic and avoids timing-dependent flakiness or hidden data coupling. Evaluates test runtime cost and parallelization tradeoffs for CI stability.

Returns the exact scope analyzed, key findings or risk hypothesis with supporting evidence, smallest recommended mitigation and expected risk reduction, what was validated and what still needs environment verification, residual risk, and concrete follow-up actions.

What it helps with

  • plan regression coverage for a new feature or behavior change
  • identify high-risk code paths and add targeted tests for them
  • improve test suite architecture to prevent flaky tests
  • verify a test fails on broken code and passes after the fix
  • estimate how much CI time grows with new test additions

Example prompts for the agent

  • Write regression tests for the /users/:id/update endpoint, strict parameter validation
  • Analyze risks in error handling changes for checkout, recommend edge cases with highest impact
  • Improve a React component test suite: remove timing-dependent flakes and assertions tied to implementation

How to install test-automator

Manually: put the files in place

.codex/agents/test-automator.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/

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

Questions about test-automator

How do I install test-automator in Codex?

Add the configuration file test-automator.toml to the .codex/agents/ directory.

What does test-automator do?

It analyzes code and recommends or writes automated tests that catch high-risk failures. It prioritizes the smallest set of checks that deliver the most risk reduction without slowing down CI.

When should I use test-automator?

Use it for new features, complex behavior changes, or recurring defects. If the work is not about testing or regression risk, test-automator is not needed.

Source text

test-automator.toml · MIT
# test-automator

Use when a task needs implementation of automated tests, test harness improvements, or targeted regression coverage.

Own test automation engineering work as evidence-driven quality and risk reduction, not checklist theater.

Prioritize the smallest actionable findings or fixes that reduce user-visible failure risk, improve confidence, and preserve delivery speed.

Working mode:
1. Map the changed or affected behavior boundary and likely failure surface.
2. Separate confirmed evidence from hypotheses before recommending action.
3. Implement or recommend the minimal intervention with highest risk reduction.
4. Validate one normal path, one failure path, and one integration edge where possible.

Focus on:
- prioritizing high-risk behavior for durable regression coverage
- test architecture choices that keep suites deterministic and maintainable
- fixture and data setup that minimizes flakiness and hidden coupling
- assertion quality focused on behavior contracts, not implementation detail
- integration points where automated coverage prevents recurring defects
- test runtime cost and parallelization tradeoffs for CI stability
- clear mapping from bug/risk to added or updated automated tests

Quality checks:
- verify tests fail for the broken behavior and pass after the fix
- confirm new tests are deterministic and avoid timing-dependent fragility
- check that test scope is minimal but sufficient for regression prevention
- ensure CI/runtime impact is acceptable and documented if increased
- call out any environment or mock assumptions limiting confidence

Return:
- exact scope analyzed (feature path, component, service, or diff area)
- key finding(s) or defect/risk hypothesis with supporting evidence
- smallest recommended fix/mitigation and expected risk reduction
- what was validated and what still needs runtime/environment verification
- residual risk, priority, and concrete follow-up actions

Do not introduce broad framework migration in test suites unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Testing and QA →

test-automator by other authors comes first.

test-automator VoltAgent Community The test-automator subagent designs test automation, writes test scripts, and connects testing to CI/CD. Use it when manual checks leave important gaps. CX Codex 625installs 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 incident-response-test-automator Seth Hobson incident-response-test-automator writes unit, integration, regression and security tests around a bug fix, then runs the whole suite and reports coverage. CX Codex ★ 42,780repo stars test coco-research Runs the complete test cycle: coverage analysis, test generation, and regression validation. Call it to fill coverage gaps or verify the test suite runs end-to-end. CX Codex +1 ★ 328repo 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 qa-test-planner softaworks Turns a feature description into a test plan, manual test cases, a regression suite or a bug report. Fires only when you name it: qa-test-planner. CX Codex +1 4,400installs codebase-cleanup-test-automator Seth Hobson codebase-cleanup-test-automator — a testing subagent that runs the TDD loop, writes tests and wires them into CI. Useful when coverage is thin or failures keep repeating. CX Codex ★ 42,780repo stars update-or-delete-tests-that-assert-intentionally-removed-behavio ZaxbyHub update-or-delete-tests-that-assert-intentionally-removed-behavio is a Claude Code skill for revising or removing tests of deliberately removed behavior. It applies to code changes that retire a code path. CX Codex +1 ★ 539repo stars

From the same set176

The whole set →
data-analyst data-analyst — a subagent for analyzing metrics and trends. Separates signal from noise, explains what drove changes, and delivers actionable recommendations with explicit uncertainty bounds. CX Codex ★ 6,505repo stars azure-databricks-platform-architect azure-databricks-platform-architect architects end-to-end Azure Databricks environments covering lakehouse layout, Unity Catalog governance, networking, and compute. CX Codex ★ 6,505repo stars ai-engineer ai-engineer — a Codex subagent that fixes model-backed features as system failures: orchestration, tool wiring, fallbacks. Not just prompt tweaks. CX Codex ★ 6,505repo stars ui-ux-tester ui-ux-tester — a subagent that tests your interface as a frustrated user: walks every documented flow end to end, catches micro-interaction bugs, validates error states and accessibility, produces a severity-ranked defect report. CX Codex ★ 6,505repo stars security-auditor security-auditor is a Codex subagent that examines code, authentication flows, and infrastructure settings for security risks. It joins focused security review tasks. CX Codex ★ 6,505repo stars reviewer reviewer is a Codex subagent for PR-style checks of correctness, security, regressions, and test gaps. It joins tasks that call for a focused code review. CX Codex ★ 6,505repo stars qa-expert qa-expert plans risk-based test strategies, acceptance criteria coverage, and release gating signals without checklist theater. CX Codex ★ 6,505repo stars powershell-security-hardening The powershell-security-hardening subagent reviews PowerShell safety, privileged automation, execution controls, and Windows security posture. Use it when a change needs evidence-backed hardening. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open