feat: transform QA agent into Test Architect with advanced quality capabilities

- Add 6 specialized quality assessment commands
  - Implement risk-based testing with scoring
  - Create quality gate system with deterministic decisions
  - Add comprehensive test design and NFR validation
  - Update documentation with stage-based workflow integration
This commit is contained in:
Murat Ozcan
2025-08-12 12:59:22 -05:00
parent ffcb4d4bf2
commit b7a34b4fc6
11 changed files with 2321 additions and 96 deletions

View File

@@ -21,12 +21,92 @@ This is a simple step-by-step guide to help you efficiently manage your developm
3. **Execute**: `*develop-story {selected-story}` (runs execute-checklist task)
4. **Review generated report** in `{selected-story}`
## Story Review (Quality Assurance)
## Test Architect Integration Throughout Workflow
### Stage 1: After Story Creation (Before Dev Starts)
**Optional but Valuable - Set Dev Up for Success:**
```bash
# Design test strategy for developer
@qa *design {approved-story}
# Output: docs/qa/assessments/{epic}.{story}-test-design-{YYYYMMDD}.md
# Why: Gives Dev clear test requirements upfront
# Identify risks to watch for
@qa *risk {approved-story}
# Output: docs/qa/assessments/{epic}.{story}-risk-{YYYYMMDD}.md
# Why: Helps Dev avoid critical issues and focus on risk areas
```
### Stage 2: During Development (Optional Checkpoints)
**Dev Can Self-Check Progress:**
```bash
# Validate NFRs mid-implementation
@qa *nfr {story-in-progress}
# Output: docs/qa/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
# Why: Catch performance/security issues early
# Verify test coverage while developing
@qa *trace {story-in-progress}
# Output: docs/qa/assessments/{epic}.{story}-trace-{YYYYMMDD}.md
# Why: Ensure you're writing the right tests
```
### Stage 3: Story Review (Required)
**Standard Review Flow:**
1. **Start new chat/conversation**
2. **Load QA agent**
3. **Execute**: `*review {selected-story}` (runs review-story task)
4. **Review generated report** in `{selected-story}`
2. **Load QA agent** (Test Architect - Quinn)
3. **Execute**: `@qa *review {selected-story}`
4. **Review outputs**:
- QA Results section added to story file
- Quality gate file in `docs/qa/gates/{epic}.{story}-{slug}.yml`
**If Issues Found:**
```bash
# After fixes, update gate status
@qa *gate {reviewed-story}
# Output: Updates docs/qa/gates/{epic}.{story}-{slug}.yml
```
### Special Situations
**High-Risk Stories or Brownfield:**
- Always run `*risk` and `*design` before development
- Extra focus on regression testing
**Complex Integrations:**
- Run `*trace` to ensure all integration points tested
- Consider `*nfr` for performance validation
**Performance-Critical Features:**
- Run `*nfr` during development, not just at review
- Set performance baselines early
### Understanding Gate Decisions
- **PASS**: Ready for production, all quality criteria met
- **CONCERNS**: Non-critical issues to review with team
- **FAIL**: Critical issues must be fixed (security, missing tests)
- **WAIVED**: Known issues accepted by team with documentation
### What Quinn Does During Review
1. **Analyzes code quality** and architecture patterns
2. **Actively refactors** code when safe to do so
3. **Validates test coverage** at appropriate levels
4. **Identifies risks** (security, performance, data)
5. **Checks NFRs** against standards
6. **Creates quality gate** with clear decision criteria
7. **Documents everything** for audit trail
## Commit Changes and Push