bmad-testarch-automate

Generates prioritized E2E, API, component, and unit tests with fixtures and coverage summaries.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-testarch-automate-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-testarch-automate
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-testarch-automate
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-testarch-automate-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Expanding test automation coverage across an existing codebase is slow and inconsistent when done manually. This Skill analyzes source code or BMad artifacts, identifies coverage gaps, and generates prioritized test suites with fixtures, factories, and helpers. ## Core Features & Use Cases - Multi-level test generation: Creates E2E, API, component, and unit tests with P0-P3 priority tags, Given-When-Then structure, and data-testid selectors. - Adaptive orchestration: Dispatches parallel subagents for API, E2E, backend, or mobile test generation based on detected stack (frontend, backend, fullstack, mobile). - Test healing and validation: Optionally runs generated tests, heals failures (selector, timing, data issues), and marks unfixable tests with test.fixme(). - Use Case: Point the workflow at a feature directory like src/orders/refunds/ and receive a complete test suite with fixtures, factories, package.json scripts, and an automation summary report. ## Quick Start Ask the agent to expand test coverage for a specific feature or directory in your project and let it generate the prioritized test suite.

Frequently Asked Questions about bmad-testarch-automate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I expand test coverage for an existing codebase?

Run the automate workflow in standalone mode by specifying a target feature or directory. It analyzes source files, identifies coverage gaps, and generates prioritized tests at the appropriate level (E2E, API, component, or unit) with supporting fixtures and factories.

What test frameworks does the automate workflow support?

The workflow supports Playwright and Cypress for frontend, framework-specific runners like pytest, JUnit, Go test, xUnit, and RSpec for backend, and Maestro for mobile. A framework configuration file must exist before running, or the workflow halts.

Does the workflow require BMad artifacts like stories or PRDs?

No, BMad artifacts are optional. The workflow runs in BMad-Integrated mode when stories or test-design documents exist, but falls back to Standalone or Auto-discover mode that analyzes source code directly.

Can the workflow generate Pact contract tests?

Yes, when the pactjs-utils flag is enabled and a consumer-provider boundary exists, it generates consumer contract tests and provider verification using createProviderState and buildVerifierOptions, with mandatory provider source scrutiny for each interaction.

What happens when generated tests fail?

If auto-healing is enabled, the workflow identifies failure patterns (stale selectors, race conditions, hardcoded data) and applies fixes up to three iterations. Tests that cannot be healed are marked with test.fixme() and detailed comments explaining the failure.

Why does the workflow halt with a framework error?

The workflow requires existing test framework scaffolding such as playwright.config.ts or cypress.config.ts. If none is found, it halts and instructs you to run the framework setup workflow first before generating tests.