QA Agent Team
Comprehensive QA verification team with 5 specialist perspectives + 1 team lead.
Team Composition
| Role | Model | Agent/Skill Base | Perspective |
|---|---|---|---|
| qa-lead | opus | quality-engineer | Orchestration, aggregation, final gate |
| visual-tester | opus | gui-phd-* | Layout, responsive, rendering |
| functional-tester | opus | feature-validator (enhanced) | User flows + Impact Propagation |
| hig-tester | opus | web-design-guidelines | Apple HIG, WCAG AA+ |
| edge-case-tester | opus | quality-engineer | Long text, 100+ records, overflow |
| ux-tester | opus | ph-quality-gate | Dark-on-dark, missing feedback, inconsistency |
Activation Flow
Step 1: Prerequisites
- Ensure dev server / app is running (ask user if unclear)
mkdir -p claudedocs/qa/screenshots- Detect platform from
package.json(or--platformflag):
- Has "electron" → Electron - Has expo / app.json → iOS/Expo - Has .xcodeproj / Package.swift macOS target → macOS - Default → Web
Step 2: Create Agent Team
Use TeamCreate tool with team_name "qa-team" and description "QA verification team".
Do NOT do QA work yourself. Only create the team and let teammates work.
Then spawn 6 teammates using the Task tool with team_name: "qa-team":
qa-lead (subagent_type: "general-purpose"):
- Read
~/.claude/agents/quality-engineer.md - Create task list with 8 tasks (see dependency graph below)
- Wait for all 5 reports, then aggregate into
claudedocs/qa/qa-summary.md - Apply Final Composite Gate from scoring rubric
visual-tester (subagent_type: "general-purpose"):
- Read
~/.claude/agents/gui-phd-web-electron.md(or gui-phd-mobile/gui-phd-macos per platform) - Execute RALPH protocol screenshot verification at 95% threshold
- Report to
claudedocs/qa/qa-visual-integrity.md
functional-tester (subagent_type: "general-purpose"):
- Read
~/.claude/agents/feature-validator.md - Execute 4-Phase Impact Propagation Protocol
- Report to
claudedocs/qa/qa-functional.md
hig-tester (subagent_type: "general-purpose"):
- Read CLAUDE.md Design Policies section
- Check Typography, Tap Areas, Colors, Spacing, Motion, Corner Radius
- Report to
claudedocs/qa/qa-hig-compliance.md
edge-case-tester (subagent_type: "general-purpose"):
- Read
~/.claude/agents/quality-engineer.md - Test empty/long text, 100+ records, boundary values, overflow
- Report to
claudedocs/qa/qa-edge-cases.md - blockedBy: functional-tester task
ux-tester (subagent_type: "general-purpose"):
- Apply PH Quality Gate Visual axis (V1-V5, /100)
- Report to
claudedocs/qa/qa-ux-sensibility.md - blockedBy: visual-tester task
Step 3: MCP Selection by Platform
| Platform | Primary MCP |
|---|---|
| Web | mcp__claude-in-chrome__* / mcp__plugin_playwright_playwright__* |
| Electron | /qa-electron skill (electron-playwright-cli based) |
| iOS/Expo | mcp__ios-simulator__* |
| macOS | mcp__mac-mcp-server__* |
Step 4: Enter Delegate Mode
After spawning all teammates, tell the user to press Shift+Tab to enter delegate mode. The lead should coordinate — YOU should not write any QA reports yourself.
Step 5: Monitor & Aggregate
- qa-lead waits for all 5 reports in
claudedocs/qa/ - Computes composite score using scoring rubric weights
- Generates
claudedocs/qa/qa-summary.mdwith final verdict
Step 6: Final Quality Gate
| Component | Weight | PASS Threshold |
|---|---|---|
| Visual | 25% | 95% Triple-Criteria |
| Functional | 30% | 95% pass rate, P0=0 |
| HIG | 15% | 80/100 composite |
| Edge Cases | 15% | 0 crash |
| UX Sensibility | 15% | PH Visual 75/100, critical=0 |
>= 85: PASS / 65-84: CONDITIONAL PASS / < 65: FAIL
Task Dependency Graph
Task 1: [qa-lead] Platform Detection & Test Plan
├── Task 2: [visual-tester] Visual Integrity (parallel)
├── Task 3: [functional-tester] Functional Correctness (parallel)
├── Task 4: [hig-tester] Apple HIG Compliance (parallel)
├── Task 5: [edge-case-tester] Edge Cases (blockedBy: 3)
├── Task 6: [ux-tester] UX Sensibility (blockedBy: 2)
├── Task 7: [qa-lead] Report Aggregation (blockedBy: 2,3,4,5,6)
└── Task 8: [qa-lead] Final Quality Gate (blockedBy: 7)Output Structure
claudedocs/qa/
├── qa-test-plan.md # Platform + test plan
├── qa-visual-integrity.md # Visual report
├── qa-functional.md # Functional report (with impact verification)
├── qa-hig-compliance.md # HIG report
├── qa-edge-cases.md # Edge case report
├── qa-ux-sensibility.md # UX sensibility report
├── qa-summary.md # Aggregated final verdict
└── screenshots/
├── visual_*.png
├── func_*.png / func_*_impact_*.png
├── hig_*.png
├── edge_*.png
└── ux_*.pngFlags
| Flag | Effect |
|---|---|
--platform <type> | Force platform (skip auto-detection) |
--skip <perspective> | Skip one or more perspectives |
--quick | Only visual + functional (3 teammates instead of 6) |
References
references/qa-scoring-rubric.md— Detailed scoring criteria per perspectiveworkflows/web-workflow.md— Web platform test workflowworkflows/electron-workflow.md— Electron test workflowworkflows/mobile-workflow.md— iOS/Expo test workflowworkflows/macos-workflow.md— macOS test workflow
Completion Criteria
QA session is complete when:
- All 5 individual reports exist with verdicts
- All reports have supporting screenshots
- Composite score calculated in qa-summary.md
- Final verdict rendered (PASS / CONDITIONAL PASS / FAIL)