Groove Work Review

This is the review step in a Git-based workflow system that evaluates your implementation branch against the original plan. It runs git diffs, checks your work against acceptance criteria, and forces you to categorize findings into "Fix Now," "Needs Spec," or "Create Issues" before making an accept or rework call. The discipline here is good: it appends review notes to your task body and captures lessons for the next planning cycle. You'd run this after finishing implementation work but before merging. The constraint that 80% of the compound loop's value lives in planning and review tells you exactly how the author thinks about iteration quality.

skills.sh installs: 545
GitHub stars: 6
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add andreadellacorte/groove --skill groove-work-review --agent claude-code

Installs into .claude/skills of the current project.

Files

groove-work-review

Outcome

The artifact is reviewed for correctness, quality, and fit to plan. Lessons are identified for the compound stage. A clear accept/rework decision is made with rationale. Review notes are captured in the task body.

Acceptance Criteria

Artifact is evaluated against the plan and acceptance criteria
Specific gaps or issues are identified (not vague "needs improvement")
Accept or rework decision is stated with rationale
Lessons are noted for /groove-work-compound
Review notes appended to stage task body
Stage task created in backend: YYYY-MM-DD, Review

Steps

Branch-diff analysis: determine the base branch (default: main; override with base: arg if provided). Run:
- git log --oneline <base>...HEAD — list commits on this branch
- git diff <base>...HEAD --stat — summarise changed files
- git diff <base>...HEAD — full diff (use as review input) Use this diff as the primary artifact to evaluate. If no commits beyond base exist, review working-tree changes instead.
Evaluate against plan and acceptance criteria — read the plan from the task body or spec file if available.