286 lines
7.6 KiB
Markdown
286 lines
7.6 KiB
Markdown
# Test Design: Epic {epic_num} - {epic_title}
|
|
|
|
**Date:** {date}
|
|
**Author:** {user_name}
|
|
**Status:** Draft / Approved
|
|
|
|
---
|
|
|
|
## Executive Summary
|
|
|
|
**Scope:** {design_level} test design for Epic {epic_num}
|
|
|
|
**Risk Summary:**
|
|
|
|
- Total risks identified: {total_risks}
|
|
- High-priority risks (≥6): {high_priority_count}
|
|
- Critical categories: {top_categories}
|
|
|
|
**Coverage Summary:**
|
|
|
|
- P0 scenarios: {p0_count} ({p0_hours} hours)
|
|
- P1 scenarios: {p1_count} ({p1_hours} hours)
|
|
- P2/P3 scenarios: {p2p3_count} ({p2p3_hours} hours)
|
|
- **Total effort**: {total_hours} hours (~{total_days} days)
|
|
|
|
---
|
|
|
|
## Risk Assessment
|
|
|
|
### High-Priority Risks (Score ≥6)
|
|
|
|
| Risk ID | Category | Description | Probability | Impact | Score | Mitigation | Owner | Timeline |
|
|
| ------- | -------- | ------------- | ----------- | ------ | ----- | ------------ | ------- | -------- |
|
|
| R-001 | SEC | {description} | 2 | 3 | 6 | {mitigation} | {owner} | {date} |
|
|
| R-002 | PERF | {description} | 3 | 2 | 6 | {mitigation} | {owner} | {date} |
|
|
|
|
### Medium-Priority Risks (Score 3-4)
|
|
|
|
| Risk ID | Category | Description | Probability | Impact | Score | Mitigation | Owner |
|
|
| ------- | -------- | ------------- | ----------- | ------ | ----- | ------------ | ------- |
|
|
| R-003 | TECH | {description} | 2 | 2 | 4 | {mitigation} | {owner} |
|
|
| R-004 | DATA | {description} | 1 | 3 | 3 | {mitigation} | {owner} |
|
|
|
|
### Low-Priority Risks (Score 1-2)
|
|
|
|
| Risk ID | Category | Description | Probability | Impact | Score | Action |
|
|
| ------- | -------- | ------------- | ----------- | ------ | ----- | ------- |
|
|
| R-005 | OPS | {description} | 1 | 2 | 2 | Monitor |
|
|
| R-006 | BUS | {description} | 1 | 1 | 1 | Monitor |
|
|
|
|
### Risk Category Legend
|
|
|
|
- **TECH**: Technical/Architecture (flaws, integration, scalability)
|
|
- **SEC**: Security (access controls, auth, data exposure)
|
|
- **PERF**: Performance (SLA violations, degradation, resource limits)
|
|
- **DATA**: Data Integrity (loss, corruption, inconsistency)
|
|
- **BUS**: Business Impact (UX harm, logic errors, revenue)
|
|
- **OPS**: Operations (deployment, config, monitoring)
|
|
|
|
---
|
|
|
|
## Test Coverage Plan
|
|
|
|
### P0 (Critical) - Run on every commit
|
|
|
|
**Criteria**: Blocks core journey + High risk (≥6) + No workaround
|
|
|
|
| Requirement | Test Level | Risk Link | Test Count | Owner | Notes |
|
|
| ------------- | ---------- | --------- | ---------- | ----- | ------- |
|
|
| {requirement} | E2E | R-001 | 3 | QA | {notes} |
|
|
| {requirement} | API | R-002 | 5 | QA | {notes} |
|
|
|
|
**Total P0**: {p0_count} tests, {p0_hours} hours
|
|
|
|
### P1 (High) - Run on PR to main
|
|
|
|
**Criteria**: Important features + Medium risk (3-4) + Common workflows
|
|
|
|
| Requirement | Test Level | Risk Link | Test Count | Owner | Notes |
|
|
| ------------- | ---------- | --------- | ---------- | ----- | ------- |
|
|
| {requirement} | API | R-003 | 4 | QA | {notes} |
|
|
| {requirement} | Component | - | 6 | DEV | {notes} |
|
|
|
|
**Total P1**: {p1_count} tests, {p1_hours} hours
|
|
|
|
### P2 (Medium) - Run nightly/weekly
|
|
|
|
**Criteria**: Secondary features + Low risk (1-2) + Edge cases
|
|
|
|
| Requirement | Test Level | Risk Link | Test Count | Owner | Notes |
|
|
| ------------- | ---------- | --------- | ---------- | ----- | ------- |
|
|
| {requirement} | API | R-004 | 8 | QA | {notes} |
|
|
| {requirement} | Unit | - | 15 | DEV | {notes} |
|
|
|
|
**Total P2**: {p2_count} tests, {p2_hours} hours
|
|
|
|
### P3 (Low) - Run on-demand
|
|
|
|
**Criteria**: Nice-to-have + Exploratory + Performance benchmarks
|
|
|
|
| Requirement | Test Level | Test Count | Owner | Notes |
|
|
| ------------- | ---------- | ---------- | ----- | ------- |
|
|
| {requirement} | E2E | 2 | QA | {notes} |
|
|
| {requirement} | Unit | 8 | DEV | {notes} |
|
|
|
|
**Total P3**: {p3_count} tests, {p3_hours} hours
|
|
|
|
---
|
|
|
|
## Execution Order
|
|
|
|
### Smoke Tests (<5 min)
|
|
|
|
**Purpose**: Fast feedback, catch build-breaking issues
|
|
|
|
- [ ] {scenario} (30s)
|
|
- [ ] {scenario} (45s)
|
|
- [ ] {scenario} (1min)
|
|
|
|
**Total**: {smoke_count} scenarios
|
|
|
|
### P0 Tests (<10 min)
|
|
|
|
**Purpose**: Critical path validation
|
|
|
|
- [ ] {scenario} (E2E)
|
|
- [ ] {scenario} (API)
|
|
- [ ] {scenario} (API)
|
|
|
|
**Total**: {p0_count} scenarios
|
|
|
|
### P1 Tests (<30 min)
|
|
|
|
**Purpose**: Important feature coverage
|
|
|
|
- [ ] {scenario} (API)
|
|
- [ ] {scenario} (Component)
|
|
|
|
**Total**: {p1_count} scenarios
|
|
|
|
### P2/P3 Tests (<60 min)
|
|
|
|
**Purpose**: Full regression coverage
|
|
|
|
- [ ] {scenario} (Unit)
|
|
- [ ] {scenario} (API)
|
|
|
|
**Total**: {p2p3_count} scenarios
|
|
|
|
---
|
|
|
|
## Resource Estimates
|
|
|
|
### Test Development Effort
|
|
|
|
| Priority | Count | Hours/Test | Total Hours | Notes |
|
|
| --------- | ----------------- | ---------- | ----------------- | ----------------------- |
|
|
| P0 | {p0_count} | 2.0 | {p0_hours} | Complex setup, security |
|
|
| P1 | {p1_count} | 1.0 | {p1_hours} | Standard coverage |
|
|
| P2 | {p2_count} | 0.5 | {p2_hours} | Simple scenarios |
|
|
| P3 | {p3_count} | 0.25 | {p3_hours} | Exploratory |
|
|
| **Total** | **{total_count}** | **-** | **{total_hours}** | **~{total_days} days** |
|
|
|
|
### Prerequisites
|
|
|
|
**Test Data:**
|
|
|
|
- {factory_name} factory (faker-based, auto-cleanup)
|
|
- {fixture_name} fixture (setup/teardown)
|
|
|
|
**Tooling:**
|
|
|
|
- {tool} for {purpose}
|
|
- {tool} for {purpose}
|
|
|
|
**Environment:**
|
|
|
|
- {env_requirement}
|
|
- {env_requirement}
|
|
|
|
---
|
|
|
|
## Quality Gate Criteria
|
|
|
|
### Pass/Fail Thresholds
|
|
|
|
- **P0 pass rate**: 100% (no exceptions)
|
|
- **P1 pass rate**: ≥95% (waivers required for failures)
|
|
- **P2/P3 pass rate**: ≥90% (informational)
|
|
- **High-risk mitigations**: 100% complete or approved waivers
|
|
|
|
### Coverage Targets
|
|
|
|
- **Critical paths**: ≥80%
|
|
- **Security scenarios**: 100%
|
|
- **Business logic**: ≥70%
|
|
- **Edge cases**: ≥50%
|
|
|
|
### Non-Negotiable Requirements
|
|
|
|
- [ ] All P0 tests pass
|
|
- [ ] No high-risk (≥6) items unmitigated
|
|
- [ ] Security tests (SEC category) pass 100%
|
|
- [ ] Performance targets met (PERF category)
|
|
|
|
---
|
|
|
|
## Mitigation Plans
|
|
|
|
### R-001: {Risk Description} (Score: 6)
|
|
|
|
**Mitigation Strategy:** {detailed_mitigation}
|
|
**Owner:** {owner}
|
|
**Timeline:** {date}
|
|
**Status:** Planned / In Progress / Complete
|
|
**Verification:** {how_to_verify}
|
|
|
|
### R-002: {Risk Description} (Score: 6)
|
|
|
|
**Mitigation Strategy:** {detailed_mitigation}
|
|
**Owner:** {owner}
|
|
**Timeline:** {date}
|
|
**Status:** Planned / In Progress / Complete
|
|
**Verification:** {how_to_verify}
|
|
|
|
---
|
|
|
|
## Assumptions and Dependencies
|
|
|
|
### Assumptions
|
|
|
|
1. {assumption}
|
|
2. {assumption}
|
|
3. {assumption}
|
|
|
|
### Dependencies
|
|
|
|
1. {dependency} - Required by {date}
|
|
2. {dependency} - Required by {date}
|
|
|
|
### Risks to Plan
|
|
|
|
- **Risk**: {risk_to_plan}
|
|
- **Impact**: {impact}
|
|
- **Contingency**: {contingency}
|
|
|
|
---
|
|
|
|
## Approval
|
|
|
|
**Test Design Approved By:**
|
|
|
|
- [ ] Product Manager: **\*\***\_\_\_**\*\*** Date: **\*\***\_\_\_**\*\***
|
|
- [ ] Tech Lead: **\*\***\_\_\_**\*\*** Date: **\*\***\_\_\_**\*\***
|
|
- [ ] QA Lead: **\*\***\_\_\_**\*\*** Date: **\*\***\_\_\_**\*\***
|
|
|
|
**Comments:**
|
|
|
|
---
|
|
|
|
---
|
|
|
|
---
|
|
|
|
## Appendix
|
|
|
|
### Knowledge Base References
|
|
|
|
- `risk-governance.md` - Risk classification framework
|
|
- `probability-impact.md` - Risk scoring methodology
|
|
- `test-levels-framework.md` - Test level selection
|
|
- `test-priorities-matrix.md` - P0-P3 prioritization
|
|
|
|
### Related Documents
|
|
|
|
- PRD: {prd_link}
|
|
- Epic: {epic_link}
|
|
- Architecture: {arch_link}
|
|
- Tech Spec: {tech_spec_link}
|
|
|
|
---
|
|
|
|
**Generated by**: BMad TEA Agent - Test Architect Module
|
|
**Workflow**: `bmad/bmm/testarch/test-design`
|
|
**Version**: 4.0 (BMad v6)
|