| name | qa-verification |
| description | Phase 3 of code review: run tests, verify behavior, check edge cases, confirm no regressions. |
QA Verification (Phase 3)
Verify the implementation actually works, not just that the code looks correct.
Verification Ladder
Work from narrow to broad:
- Run targeted tests for changed behavior.
- Check edge/error-path tests from the design document are covered.
- Run package/module test suite.
- Run typecheck/lint/build if present.
- Run full test suite before APPROVED.
If a full suite is too slow or unavailable, report: command not run, reason, risk, and narrower evidence collected.
Quality Checks
- Do tests verify behavior or just exercise code paths?
- Did any previously passing tests break (regressions)?
- Do error conditions produce correct results?
Browser Interaction Testing (Interactive Components)
For components with user interaction, QA verification includes browser-based testing via Chrome DevTools MCP or agent-browser:
Required Verifications
-
Click Navigation
- Click each interactive element
- Screenshot each resulting state
- Verify state matches Behavioral Matrix from design doc
-
Keyboard Navigation
- Tab into component, verify focus lands correctly
- ArrowLeft/Right through all items
- Verify focus ring visible on active element
- Tab out, verify exit to correct element
-
Mobile/Touch
- Resize to 375×667 (iPhone SE)
- Verify layout adapts (scroll vs stack)
- Test swipe gestures if applicable
-
Accessibility Audit
- Run
mcp_chrome_devtoo_lighthouse_audit with mode="snapshot"
- Verify Accessibility score ≥ 95 (ideally 100)
- Document any issues
Evidence Required
## Browser Interaction Results
- Click navigation: [PASS/FAIL with screenshot paths]
- Keyboard navigation: [PASS/FAIL with test sequence]
- Mobile layout: [PASS/FAIL at 375px]
- Lighthouse a11y: [score]
Output
PASS or FAIL with specific test results and evidence.
## QA Results
- Test suite: [X passed, Y failed, Z skipped]
- Edge case coverage: [list from design doc, each PASS/FAIL]
- Regressions: [none / list]
- Error path verification: [PASS/FAIL with evidence]