Code Review
Purpose
Consistent checklist for effective, fair code reviews.
Core Principles
- •Focus: correctness, clarity, maintainability
- •Be specific & actionable
- •Prioritize risks & user impact
Rules
Correctness
- •Validate edge cases & error handling
- •Confirm data validation & security
Readability
- •Clear, consistent naming
- •Simple control flow > deeply nested logic
Tests
- •New behavior covered by tests
- •Tests deterministic & scoped
Examples
✅ "This can return null; add guard or update type" ❌ "Looks bad" (no actionable detail)
Edge Cases
- •Large changes: suggest splitting into smaller PRs
- •Performance-critical: ask for benchmarks
See COMMON.md.
Refs: Google review guide (2026-01-26)