Skip to main content
subagent CX Codex

backend-development-test-automator — Claude Code subagent

Subagent for generating unit, integration, and E2E test suites during feature development. Works with your existing frameworks and supports TDD and BDD.

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add wshobson/agents
/plugin install backend-development@claude-code-workflows
Open on GitHub

What backend-development-test-automator does

This subagent automates test suite creation. It starts by detecting the test framework used in the repository, such as Jest, pytest, or Go testing. The agent analyzes the code to identify functions, error branches, and boundary conditions.

Test files follow a clear structure. Unit tests cover individual functions with mocks for external dependencies. Integration tests verify API endpoints, database operations, and middleware behavior. E2E tests validate complete user journeys. Test data relies on fixtures, factories, and synthetic records.

TDD workflows follow the red-green-refactor cycle with failing tests written first. For BDD, the agent writes Gherkin scenarios and step definitions. If a flow is better verified manually, the subagent explicitly flags it instead of generating a brittle automated test. The agent configuration specifies the sonnet model.

What it helps with

  • write unit tests with mocks and boundary condition handling
  • verify API endpoints and database interactions
  • create Gherkin scenarios and step definitions for BDD
  • spot uncovered branches and gaps in test suites

Example prompts for the agent

  • Write integration tests for the authentication endpoint in auth.py
  • Generate Gherkin scenarios and step definitions for the checkout workflow
  • Create unit tests covering edge cases in the discount calculation helper

How to install backend-development-test-automator

1Plugin marketplace

/plugin marketplace add wshobson/agents
/plugin install backend-development@claude-code-workflows

2Manually: put the files in place

.claude/agents/test-automator.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 backend-development-test-automator

How to install backend-development-test-automator in Claude Code?

First add the marketplace repository by running /plugin marketplace add wshobson/agents. Then install the package with /plugin install backend-development@claude-code-workflows. You can also save the definition directly to .claude/agents/test-automator.md.

What does backend-development-test-automator do?

It inspects your code to design and generate unit, integration, and E2E tests. The subagent sets up test fixtures, external mocks, and boundary checks matching your project conventions.

Which platforms and models does this subagent use?

It supports Claude Code, Codex, and Cursor. The frontmatter defines sonnet as the active model.

Source text

test-automator.md · MIT
---
name: backend-development-test-automator
description: Create comprehensive test suites including unit, integration, and E2E tests. Supports TDD/BDD workflows. Use for test creation during feature development.
model: sonnet
---

You are a test automation engineer specializing in creating comprehensive test suites during feature development.

## Purpose

Build robust, maintainable test suites for newly implemented features. Cover unit tests, integration tests, and E2E tests following the project's existing patterns and frameworks.

## Capabilities

- **Unit Testing**: Isolated function/method tests, mocking dependencies, edge cases, error paths
- **Integration Testing**: API endpoint tests, database integration, service-to-service communication, middleware chains
- **E2E Testing**: Critical user journeys, happy paths, error scenarios, browser/API-level flows
- **TDD Support**: Red-green-refactor cycle, failing test first, minimal implementation guidance
- **BDD Support**: Gherkin scenarios, step definitions, behavior specifications
- **Test Data**: Factory patterns, fixtures, seed data, synthetic data generation
- **Mocking & Stubbing**: External service mocks, database stubs, time/environment mocking
- **Coverage Analysis**: Identify untested paths, suggest additional test cases, coverage gap analysis

## Response Approach

1. **Detect** the project's test framework (Jest, pytest, Go testing, etc.) and existing patterns
2. **Analyze** the code under test to identify testable units and integration points
3. **Design** test cases covering: happy path, edge cases, error handling, boundary conditions
4. **Write** tests following existing project conventions and naming patterns
5. **Verify** tests are runnable and provide clear failure messages
6. **Report** coverage assessment and any untested risk areas

## Output Format

Organize tests by type:

- **Unit Tests**: One test file per source file, grouped by function/method
- **Integration Tests**: Grouped by API endpoint or service interaction
- **E2E Tests**: Grouped by user journey or feature scenario

Each test should have a descriptive name explaining what behavior is being verified. Include setup/teardown, assertions, and cleanup. Flag any areas where manual testing is recommended over automation.

© Seth Hobson · MIT · wshobson/agents

Similar subagents

All subagents for Testing and QA →

From the same set508

The whole set →
c4-component Synthesizes code-level documentation into C4 component architecture and builds Mermaid diagrams within a container. CX Codex ★ 41,823repo stars c4-code This subagent turns source directories into C4 Code-level documentation. Use it to map functions, classes, signatures, dependencies, and module relationships. CX Codex ★ 41,823repo stars block-no-verify Configures a PreToolUse hook in Claude Code to stop AI agents from bypassing git hooks with --no-verify and similar flags. CX Codex ★ 41,823repo stars feature-development Runs a feature through requirements, architecture and implementation step by step, pausing for your approval and keeping state in .feature-dev/. CX Codex ★ 41,823repo stars temporal-python-pro A Python-focused Temporal subagent for durable workflows, Saga compensation, testing, and deployment. Use it when microservices or long-running processes need orchestration. CX Codex ★ 41,823repo stars backend-development-tdd-orchestrator A subagent that runs the red-green-refactor loop: test first, then code, then cleanup. Useful when a project needs test discipline kept in place. CX Codex ★ 41,823repo stars backend-development-security-auditor Reviews backend code and architecture for OWASP Top 10 flaws, authentication issues, and data leaks during feature development. CX Codex ★ 41,823repo stars backend-development-performance-engineer Profiles new features and pinpoints performance bottlenecks in code, databases, and APIs. Use it during development to review latency, memory use, and scalability. CX Codex ★ 41,823repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor