130 lines
2.9 KiB
Markdown
130 lines
2.9 KiB
Markdown
---
|
|
sidebar_label: Run Test Design
|
|
description: How to create comprehensive test plans using TEA's test-design workflow
|
|
---
|
|
|
|
# How to Run Test Design
|
|
|
|
Use TEA's `*test-design` workflow to create comprehensive test plans with risk assessment and coverage strategies.
|
|
|
|
---
|
|
|
|
## When to Use This
|
|
|
|
**System-level (Phase 3):**
|
|
- After architecture is complete
|
|
- Before implementation-readiness gate
|
|
- To validate architecture testability
|
|
|
|
**Epic-level (Phase 4):**
|
|
- At the start of each epic
|
|
- Before implementing stories in the epic
|
|
- To identify epic-specific testing needs
|
|
|
|
---
|
|
|
|
## Prerequisites
|
|
|
|
- BMad Method installed
|
|
- TEA agent available
|
|
- For system-level: Architecture document complete
|
|
- For epic-level: Epic defined with stories
|
|
|
|
---
|
|
|
|
## Steps
|
|
|
|
### 1. Load the TEA Agent
|
|
|
|
Start a fresh chat and load the TEA (Test Architect) agent.
|
|
|
|
### 2. Run the Test Design Workflow
|
|
|
|
```
|
|
*test-design
|
|
```
|
|
|
|
### 3. Specify the Mode
|
|
|
|
TEA will ask if you want:
|
|
|
|
- **System-level** - For architecture testability review (Phase 3)
|
|
- **Epic-level** - For epic-specific test planning (Phase 4)
|
|
|
|
### 4. Provide Context
|
|
|
|
For system-level:
|
|
- Point to your architecture document
|
|
- Reference any ADRs (Architecture Decision Records)
|
|
|
|
For epic-level:
|
|
- Specify which epic you're planning
|
|
- Reference the epic file with stories
|
|
|
|
### 5. Review the Output
|
|
|
|
TEA generates a comprehensive test design document.
|
|
|
|
---
|
|
|
|
## What You Get
|
|
|
|
### System-Level Output (`test-design-system.md`)
|
|
|
|
- Testability review of architecture
|
|
- ADR → test mapping
|
|
- Architecturally Significant Requirements (ASRs)
|
|
- Environment needs
|
|
- Test infrastructure recommendations
|
|
|
|
### Epic-Level Output (`test-design-epic-N.md`)
|
|
|
|
- Risk assessment for the epic
|
|
- Test priorities
|
|
- Coverage plan
|
|
- Regression hotspots (for brownfield)
|
|
- Integration risks
|
|
- Mitigation strategies
|
|
|
|
---
|
|
|
|
## Test Design for Different Tracks
|
|
|
|
### Greenfield - BMad Method
|
|
|
|
| Stage | Test Design Focus |
|
|
|-------|-------------------|
|
|
| Phase 3 | System-level testability review |
|
|
| Phase 4 | Per-epic risk assessment and test plan |
|
|
|
|
### Brownfield - BMad Method/Enterprise
|
|
|
|
| Stage | Test Design Focus |
|
|
|-------|-------------------|
|
|
| Phase 3 | System-level + existing test baseline |
|
|
| Phase 4 | Regression hotspots, integration risks |
|
|
|
|
### Enterprise
|
|
|
|
| Stage | Test Design Focus |
|
|
|-------|-------------------|
|
|
| Phase 3 | Compliance-aware testability |
|
|
| Phase 4 | Security/performance/compliance focus |
|
|
|
|
---
|
|
|
|
## Tips
|
|
|
|
- Run system-level test-design right after architecture
|
|
- Run epic-level test-design at the start of each epic
|
|
- Update test design if ADRs change
|
|
- Use the output to guide `*atdd` and `*automate` workflows
|
|
|
|
---
|
|
|
|
## Related
|
|
|
|
- [TEA Overview](../../explanation/features/tea-overview.md) - Understanding the Test Architect
|
|
- [Setup Test Framework](./setup-test-framework.md) - Setting up testing infrastructure
|
|
- [Create Architecture](./create-architecture.md) - Architecture workflow
|