QA Agent Team

Comprehensive QA verification team with 5 specialist perspectives + 1 team lead.

Team Composition

Activation Flow

Step 1: Prerequisites

1. Ensure dev server / app is running (ask user if unclear)
2. mkdir -p claudedocs/qa/screenshots
3. Detect platform from package.json (or --platform flag):
   • 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

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.md with final verdict

Step 6: Final Quality Gate

>= 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_*.png

Flags

References

• references/qa-scoring-rubric.md — Detailed scoring criteria per perspective
• workflows/web-workflow.md — Web platform test workflow
• workflows/electron-workflow.md — Electron test workflow
• workflows/mobile-workflow.md — iOS/Expo test workflow
• workflows/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)