bmad-testarch-atdd

Generate red-phase acceptance test scaffolds for ATDD workflows.

1|Updated Apr 27, 2026

Search Tags:#test-driven development #red-green-refactor #ATDD #acceptance testing #test scaffolding

Ready to run

npx skills add https://github.com/peshay/portfolixir --skill bmad-testarch-atdd-peshay

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bmad-testarch-atdd
Source: https://github.com/peshay/portfolixir/tree/main/.claude/skills/bmad-testarch-atdd
Command: npx skills add https://github.com/peshay/portfolixir --skill bmad-testarch-atdd-peshay

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires read_file, write_file, create_directory, list_files, search_repo, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the generation of red-phase acceptance test scaffolds for ATDD workflows, streamlining the test-driven development process and reducing manual effort.

Core Features & Use Cases

Red-Phase Test Scaffolding: Generates test scaffolds that can be used in the initial stages of ATDD to define test cases before implementation.
Test Strategy Mapping: Maps acceptance criteria to appropriate test levels (E2E, API, Component) and assigns priorities.
Data Infrastructure: Creates data factories and fixtures for test data generation and setup.
Mock Requirements: Documents external service mocking requirements for API tests.
Implementation Checklist: Provides a detailed checklist for developers to implement the generated tests.
Validation Report: Generates a validation report to ensure the correctness of the generated tests.
Mode Selection: Allows selection between AI generation, recording, or manual generation modes.
Subagent Orchestration: Orchestrates subagents for parallel execution of test generation tasks.
Output Aggregation: Aggregates outputs from subagents into a final ATDD checklist document.

Quick Start

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

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 scaffolding for ATDD workflows?▼

You can automate acceptance test scaffolding by generating red-phase test files that map story acceptance criteria to appropriate test levels, assign priorities, and create data infrastructure to streamline the test-driven development process.

What is the red-green-refactor process in test-driven development?▼

The red-green-refactor process in test-driven development starts with writing failing tests, implementing code to pass them, and refactoring. This Skill focuses on the red phase by generating initial acceptance test scaffolds before implementation begins.

How do I map acceptance criteria to different test levels like E2E and API?▼

Mapping acceptance criteria to test levels involves assigning appropriate test strategies such as E2E, API, or Component tests. This Skill automates that mapping and assigns priorities to ensure proper test coverage across levels.

Do I need to manually set up data factories and fixtures for acceptance testing?▼

You do not need to manually set up data factories and fixtures for acceptance testing. This Skill automatically creates data factories and fixtures for test data generation and setup as part of the scaffold generation process.

Can I generate mock requirements for external services in API tests?▼

You can generate mock requirements for external services in API tests. The Skill documents external service mocking requirements and orchestrates subagents to handle parallel test generation tasks.

What are the limitations of automated test scaffolding for ATDD?▼

Automated test scaffolding for ATDD requires configuration and knowledge fragments for execution and focuses on the red phase, meaning developers still need to implement the generated tests using the provided checklist and validation report.