bmad-testarch-atdd

Generates red-phase acceptance test scaffolds with fixtures, factories, and implementation checklists for TDD workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams practicing acceptance test-driven development often skip writing failing tests first, or produce inconsistent test scaffolds that developers cannot act on. This Skill generates red-phase acceptance test scaffolds before implementation, complete with fixtures, data factories, mock requirements, and a developer-ready implementation checklist. ## Core Features & Use Cases - Red-Phase Test Generation: Creates E2E, API, and component test scaffolds marked with test.skip() following Given-When-Then structure, so activated tests fail for the right reason before implementation. - Test Infrastructure Scaffolding: Produces faker-based data factories, Playwright fixtures with auto-cleanup, mock requirement documentation, and data-testid attribute lists. - Tri-Modal Workflow: Supports Create, Resume, Validate, and Edit modes with step-file architecture, progress tracking frontmatter, and checklist-based validation. - Use Case: Given a user story with acceptance criteria, the Skill maps criteria to test levels (E2E/API/Component), prioritizes them P0-P3, and outputs an ATDD checklist that hands developers a red-green-refactor roadmap. ## Quick Start Ask the agent to write acceptance tests for a story by saying something like "let's write acceptance tests for the guest checkout story" and provide the story file path.

Frequently Asked Questions about bmad-testarch-atdd

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

FAQPage Schema
How do I generate acceptance tests before implementation with ATDD?

Provide a story file with clear acceptance criteria and activate the workflow in Create mode. It maps each criterion to E2E, API, or component test levels, then generates test.skip() scaffolds plus an implementation checklist for developers.

What test frameworks does this ATDD workflow support?

The workflow primarily targets Playwright, with Cypress configuration detection also supported. Backend stacks are detected automatically and use AI generation from API documentation or source code instead of browser-based tests.

Why are generated tests marked with test.skip()?

Tests are red-phase scaffolds in the TDD cycle, so they must not run as active tests before implementation exists. Developers remove test.skip() one task at a time, confirm the test fails, then implement until it passes.

Can I resume an interrupted ATDD workflow run?

Yes, Resume mode reads the output checklist's YAML frontmatter to find completed steps and routes to the next incomplete step. Progress is saved after every step in the output file.

Does the workflow support Pact contract testing?

Yes, when the tea_use_pactjs_utils flag is enabled and a real consumer-provider boundary exists, it loads Pact.js utilities knowledge fragments. The flag never forces contract tests onto projects without that boundary.