Code Review

Purpose

This skill performs a structured, project-aware code review. It evaluates changes against the project's existing conventions, the requirements that motivated the change, and general software quality principles — producing actionable, severity-tiered feedback rather than a wall of comments.

If the change originated from a plans/<name>/tasks.md task, the review also validates that the implementation satisfies the task's acceptance criteria, traces back to the correct PRD requirements, and conforms to the plan's design.md and ADRs when they exist.

In the development lifecycle, this skill is the quality step of the build pipeline — run it per task or per phase during tasks-to-code, and always before release-checklist (which hard-blocks on unresolved 🔴 Blocking findings in review.md).

Inputs

The skill accepts any of the following:

• A diff — pasted or referenced (e.g., git diff main...feature-branch)
• A list of changed files — "review the changes in src/auth/ and tests/auth.test.ts"
• A branch or PR description — with enough context to identify what changed and why
• A task reference — "review the implementation of task 2.3" (reads plans/<name>/tasks.md for acceptance criteria)