bmad-testarch-test-design

Generate system-level and epic-level test design documents and risk assessments from PRD/ADR artifacts.

Updated May 5, 2026

Search Tags:#architecture #qa #risk-assessment #test-design #bmad #epic-planning

Ready to run

npx skills add https://github.com/b566776/whitebox --skill bmad-testarch-test-design-b566776

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bmad-testarch-test-design
Source: https://github.com/b566776/whitebox/tree/main/.gemini/skills/bmad-testarch-test-design
Command: npx skills add https://github.com/b566776/whitebox --skill bmad-testarch-test-design-b566776

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill automates the creation of comprehensive test design documents for both system-level architecture reviews and epic-level planning, aligning QA activities with architectural decisions and risk considerations.

Core Features & Use Cases

Supports system-level (Phase 3) and epic-level (Phase 4) test design workflows.
Loads PRD/ADR context, knowledge fragments, and customization settings to produce consistent templates.
Generates risk assessments, coverage plans, execution strategies, and resource estimates ready for BMAD handoff.

Quick Start

Run the BMAD test design workflow using your PRD and ADR to generate system-level architecture and epic-level QA outputs.

Frequently Asked Questions about bmad-testarch-test-design

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

FAQPage Schema

How do I generate a test design document for epic planning?▼

To generate a test design document for epic planning, load your project artifacts like PRDs and ADRs into the workflow. The skill produces template-based outputs including risk assessments, coverage plans, and execution strategies ready for QA handoff.

What is system-level test design in architecture reviews?▼

System-level test design in architecture reviews is the process of aligning QA activities with architectural decisions and risk considerations. It generates comprehensive test strategies and risk assessments from project artifacts to validate system architecture.

How do I create a risk assessment from PRD and ADR files?▼

You can create a risk assessment from PRD and ADR files by loading them into the test design workflow. The system evaluates the project artifacts and automatically generates a structured risk assessment alongside coverage plans and resource estimates.

Does the BMAD test design workflow support custom templates?▼

Yes, the BMAD test design workflow supports custom templates via a customize.toml configuration file. You can apply specific settings and use resolve-customization.py to tailor the generated outputs for architecture and QA.

Can I use knowledge fragments for test strategy generation?▼

Yes, you can use knowledge fragments for test strategy generation. The workflow loads these fragments dynamically as needed alongside your PRD and ADR context to produce consistent and comprehensive test design templates.

What is the best way to align QA activities with architectural decisions?▼

The best way to align QA activities with architectural decisions is to apply a system-level test design workflow during architecture reviews. This automates risk assessment and coverage plan generation directly from your ADRs and PRDs.