tomevault-io Agent Code Review
Orchestrate parallel sub-agent reviews for comprehensive code analysis and actionable feedback.
When to Use
- Deep code review before merge
- Bug hunting and regression detection
- Getting alternative implementation perspectives
- Validating library/API usage correctness
Instructions
Step 1: Determine Review Scope
Identify what to review:
# Option A: Recent changes
git diff HEAD~1
# Option B: Staged changes
git diff --staged
# Option C: Specific commit range
git log --oneline -10 # then select range
# Option D: Current working state
git status
Step 2: Spawn Review Sub-Agents
Deploy parallel sub-agents with focused tasks:
| Sub-Agent | Task |
|---|---|
| Spec Reviewer | Check implementation against UPP-1.3.spec.md and compliance requirements |
| Standards Reviewer | Compare against existing provider patterns and org coding standards |
| Bug Hunter | Search for regressions, edge cases, error handling gaps |
| API Validator | Web search to verify API/library usage correctness |
Prompt each sub-agent with:
"Perform a comprehensive code review of [scope]. Investigate spec compliance, coding standards consistency, and validate any API/library usage against current documentation. Report findings as actionable items."
Step 3: Collect and Synthesize
Aggregate sub-agent reports into:
- Critical issues requiring immediate fix
- Recommendations for improvement
- Alternative approaches worth considering
- Regression risks with resolution plans
Output Format
# Code Review Report
## Files Reviewed
- `path/to/file1.ts`
- `path/to/file2.ts`
## Critical Issues 🔴
| File | Line | Issue | Fix |
|------|------|-------|-----|
## Recommendations 🟡
| File | Line | Suggestion | Rationale |
|------|------|------------|-----------|
## Alternative Perspectives 🔵
[Alternative implementation approaches from sub-agents]
## Regression Analysis
| Risk | Affected Area | Resolution Plan |
|------|---------------|-----------------|
## Action Items
- [ ] Fix: [critical item]
- [ ] Consider: [recommendation]
- [ ] Verify: [needs validation]
Notes
- Sub-agents should search the codebase for similar patterns before suggesting changes
- Always create resolution plans for identified regressions
- Validate external dependencies against their official documentation
Converted and distributed by TomeVault — claim your Tome and manage your conversions.