| name | Reviewing Code |
| description | Systematically evaluate code changes for security, correctness, performance, and spec alignment. Use when reviewing PRs, assessing code quality, or verifying implementation against requirements. |
Reviewing Code
Evaluate code changes across security, correctness, spec alignment, performance, and maintainability. Apply sequential or parallel review based on scope.
Quick Start
Sequential (small PRs, <5 files):
- Gather context from feature specs and acceptance criteria
- Review sequentially through focus areas
- Report findings by priority
- Recommend approval/revision/rework
Parallel (large PRs, >5 files):
- Identify independent review aspects (security, API, UI, data)
- Spawn specialist agents for each dimension
- Consolidate findings
- Report aggregate assessment
Context Gathering
Read documentation:
docs/feature-spec/F-##-*.md — Technical design and requirements
docs/user-stories/US-###-*.md — Acceptance criteria
docs/api-contracts.yaml — Expected API signatures
docs/data-plan.md — Event tracking requirements (if applicable)
docs/design-spec.md — UI/UX requirements (if applicable)
docs/system-design.md — Architecture patterns (if available)
docs/plans/<slug>/plan.md — Original implementation plan (if available)
Determine scope:
- Files changed and features affected (F-## IDs)
- Stories implemented (US-### IDs)
- API, database, or schema changes