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 blocker or major finding remains open.

1. Load Workflow Context First

Before inspecting the diff, read the active workflow/<change-slug>/ artifacts:

  1. workflow/<change-slug>/SPEC.md — Verify goals, non-goals, constraints, and acceptance criteria.
  2. workflow/<change-slug>/PLAN.md (and workflow/<change-slug>/TASKS.md, if present) — Understand the intended technical approach and module scope.
  3. 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).

Installs
13
First Seen
9 days ago