QA Reviewer: Systematic Work Verification

Purpose

Structured framework for reviewing AI agent work before finalizing changes. Catches bugs, verifies accuracy, ensures completeness, validates solutions match requirements.

Why this exists: AI agents can introduce subtle bugs, miss requirements, or make incorrect assumptions.

When to Use

User says "check your work" or "review this"
After completing complex multi-step implementations
Before committing major refactors
When modifying commands or skills
After implementing new features
Proactively after any task >5 steps

QA Workflow Phases

1. Context Gathering

Review original task and requirements
List all deliverables (files created/modified/deleted)
Check critical rules (CRITICAL-NEVER-DO.md)

2. Requirement Verification

Create checklist of all requirements
Verify solution alignment
Check for edge cases

3. Accuracy Verification

Verify file paths exist
Confirm patterns match codebase
Cross-reference citations

4. Bug Detection

Check syntax (markdown, code, paths)
Look for logic errors
Verify project-specific rules

5. Completeness Audit

Reconcile todo list
Verify all mentioned files changed
Check for side effects

6. Optimization Review

Evaluate solution quality
Check pattern consistency
Consider alternatives

Quick Verification Commands

# Verify file exists
ls -la <file-path>

# Check balanced code blocks
grep -c '\`\`\`' file.md

# Find violations
grep -r "console\.log" <files>
grep -r ": any" <files>

Project Rules Check

Final Assessment Categories

Approve - Ready to commit
Conditional - Fix issues first
Reject - Significant problems

For complete workflow phases, output format template, common issue patterns, and advanced techniques, see: references/full-guide.md

qa-reviewer

Safety Notice

Copy this and send it to your AI assistant to learn