| name | qa-and-fix |
| description | Standalone QA investigation and fix workflow |
QA and Fix
/qa-and-fix - Standalone QA + fixes
Model Tiers
T1 = deep review rigor, T2 = balanced execution/fixes, T3 = quick triage only.
- Task tool mapping:
subagent_type="general"; if effort variants exist use T1=high, T2=medium, T3=low, else enforce via prompt depth/evidence.
Agents
- Orchestrator: Coordinate, Playwright fallback
- QA Agent: Distinguished QA Engineer (25+ yrs) - investigate, test, validate
- Fix Agent: Distinguished Engineer (25+ yrs) - root cause, fix
Flow
Phase 1: Setup
- Ask: "What should I QA first?" with choices:
- feature flow (recommended)
- specific file/module
- recent changes
- full project sweep
- Read README, arch docs
Phase 2: QA (delegated)
[T2:balanced] Spawn QA agent:
Persona: Distinguished QA Engineer (25+ yrs)
Scope: {user-defined}
Check: functional, code quality, integration, tests, docs, security/perf
Playwright (web): try MCP → fail? return NEEDS_PLAYWRIGHT + scenarios
Output: issues (CRITICAL/MEDIUM/LOW) w/ file:line, passed checks
- If NEEDS_PLAYWRIGHT → orchestrator executes, reports back
- Present report → "Proceed to fix now? (recommended: yes) [Y/n]"
Phase 3: Fix (delegated)
[T2:balanced] Spawn fix agent:
Persona: Distinguished Engineer (25+ yrs)
Issues: {from QA}
For each (CRITICAL→MEDIUM→LOW):
- Root cause → design fix → implement → verify
- Follow `AGENTS.md`/`agents.md` philosophy
Output: fixed, files modified, deferred, PLAYWRIGHT_VALIDATION if needed
- If Playwright validation → execute directly
- Loop max 3x if validation fails
Phase 4: Review
[T1:deep] Spawn two subagent_type="general" review tasks with personas: Distinguished Code Reviewer + Distinguished Architect → if CHANGES_NEEDED → fix agent → repeat
Phase 5: Output
- Save to
docs/hotfixes/{hotfix-id}/: qa-report.md, fix-report.md, review-summary.md
Responsibilities
| Task | Owner |
|---|
| User interaction | Primary session |
| QA investigation | QA Agent |
| Fix implementation | Fix Agent |
| Playwright testing | QA Agent (primary fallback) |
| Code review | Review Agents |