Requesting Code Review

Review your work systematically before declaring it complete.

Core principle: Review early, review often.

When to Request Review

Mandatory:

• After each task in implementation
• After completing major feature
• Before merge to main

Optional but valuable:

• When stuck (fresh perspective)
• Before refactoring (baseline check)
• After fixing complex bug

Self-Review Process

Step 1: Gather Context

# What changed?
git diff HEAD~1

# What files?
git diff --name-only HEAD~1

Step 2: Spec Compliance Check

• Does the implementation match requirements?
• Are all acceptance criteria met?
• Is the feature complete?

Step 3: Code Quality Check

• Is the code readable and well-named?
• Is there any duplication to extract?
• Are edge cases handled?
• Are error messages helpful?

Step 4: Test Quality Check

• Do tests cover the happy path?
• Do tests cover edge cases?
• Do tests cover error conditions?
• Are tests readable and maintainable?

Step 5: Final Verification

• All tests pass
• No lint errors
• No console errors/warnings
• Changes committed with descriptive message

Issue Severity

Common Mistakes

• Skipping review because "it's simple"
• Ignoring critical issues
• Proceeding with unfixed important issues
• Not running tests before review
• Reviewing only the happy path

Integration

Use after:

• Each task in executing-plans
• Each task in subagent-driven-development

Before:

• Creating pull request
• Merging to main branch