code-review
Installation
SKILL.md
Code Review
Review code changes against both engineering quality and specification intent, recording every actionable finding in workflow/<change-slug>/REVIEW.md.
Review Philosophy
- Net improvement over perfection: Approve changes that clearly improve overall code health and satisfy
workflow/<change-slug>/SPEC.md, even if minor stylistic preferences differ. - Evidence over opinion: Ground every finding in a concrete file path, line range or symbol, and explain why it matters.
- Zero silent passes: Do not approve or finish work while any
blockerormajorfinding remainsopen.
1. Load Workflow Context First
Before inspecting the diff, read the active workflow/<change-slug>/ artifacts:
workflow/<change-slug>/SPEC.md— Verify goals, non-goals, constraints, and acceptance criteria.workflow/<change-slug>/PLAN.md(andworkflow/<change-slug>/TASKS.md, if present) — Understand the intended technical approach and module scope.workflow/<change-slug>/REVIEW.md— Check prior review rounds so resolved items are not re-reported and open items are re-verified.
If workflow/<change-slug>/REVIEW.md does not exist yet, create it (using the spec-driven-workflow REVIEW.md template if installed).