bmad-testarch-atdd

Generate red-phase acceptance test scaffolds for TDD using step-file architecture.

Updated Dec 26, 2025
One-click install
npx skills add https://github.com/tiween/tiween --skill bmad-testarch-atdd-tiween
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-testarch-atdd
Source: https://github.com/tiween/tiween/tree/main/.agents/skills/bmad-testarch-atdd
Command: npx skills add https://github.com/tiween/tiween --skill bmad-testarch-atdd-tiween

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, pact-js, faker, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the generation of red-phase acceptance test scaffolds for TDD, reducing manual effort and ensuring consistent test design.

Core Features & Use Cases

  • Red-Phase Test Generation: Automatically generates red-phase test scaffolds for API and E2E tests.
  • Test Strategy Mapping: Maps acceptance criteria to appropriate test levels and priorities.
  • Data Infrastructure: Creates data factories and fixtures for test data generation and cleanup.
  • Mocking: Documents external service mocking requirements for API tests.
  • Implementation Checklist: Provides a detailed implementation checklist for developers.
  • Validation: Validates generated tests and outputs against a checklist.
  • Use Case: Imagine you have a user story with complex requirements. Use this Skill to generate the initial test scaffolds, including API and E2E tests, and ensure they are aligned with the acceptance criteria.

Quick Start

Use the bmad-testarch-atdd skill to generate acceptance test scaffolds for the user story 'User Registration'.

Frequently Asked Questions about bmad-testarch-atdd

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

FAQPage Schema
How do I automate acceptance test generation for the TDD red phase?

Automating acceptance test generation for the TDD red phase involves creating test scaffolds from user story criteria. This process maps requirements to appropriate test levels, generating initial API and E2E tests using frameworks like Playwright and Pact.js.

What is ATDD test strategy mapping and how does it work?

ATDD test strategy mapping is the process of aligning acceptance criteria with specific test levels and priorities. It works by evaluating user story requirements and automatically documenting the necessary API, E2E tests, and external service mocking needs.

Does this test generation approach work with both frontend and backend projects?

Yes, this test generation approach works with both frontend and backend projects. It handles various test levels and prioritization, applying step-file architecture to generate scaffolds for API tests using Pact.js and E2E tests using Playwright.

How do I generate test data factories and fixtures for E2E test automation?

Generating test data factories and fixtures for E2E test automation requires defining data generation and cleanup rules. This approach creates structured data infrastructure using tools like Faker to support consistent test execution across acceptance criteria.

Do I need Playwright and Pact.js to automate acceptance test scaffolds?

Yes, you need Playwright and Pact.js to automate acceptance test scaffolds in this workflow. These dependencies provide the core testing infrastructure for E2E browser automation and API contract mocking, alongside Faker for generating test data.

What is the best way to mock external services for API acceptance tests?

The best way to mock external services for API acceptance tests is to document mocking requirements during scaffold generation. This ensures external service interactions are defined upfront, allowing Pact.js to handle contract testing and isolate API behavior validation.