| name | qa-reviewer |
| description | Runs a structured multi-phase verification pass on completed AI agent work — catching bugs, missed requirements, and incorrect assumptions before changes are committed. Triggers on: "check your work", "review this", after complex multi-step implementations, before committing major refactors, or proactively after any task longer than five steps. |
| metadata | {"version":"1.0.1","tags":"quality-assurance, verification, code-review, accuracy, completeness"} |
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.
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 (agent instruction files —
AGENTS.md/CLAUDE.md, repo-level and global)
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
ls -la <file-path>
grep -c '```' file.md
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, load ${CLAUDE_SKILL_DIR}/references/full-guide.md when performing a comprehensive QA pass or when the task has more than three deliverables.
