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

1. 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.

2. Evaluate against plan and acceptance criteria — read the plan from the task body or spec file if available.

3. Categorise findings (use these exact labels):

   • Fix Now: trivial issues — fix immediately before accepting
   • Needs Spec: important gaps requiring planning — create a spec
   • Create Issues: large effort or nice-to-have — track as tasks

4. State accept or rework decision with rationale.

5. Note lessons for /groove-work-compound.

6. Append review notes to the task body.

7. Create stage task via /groove-utilities-task-create if tasks.backend != none (title YYYY-MM-DD, Review).

Constraints

• Read tasks.backend from .groove/index.md to determine backend
• Be thorough — 80% of compound loop value is here and in plan
• If rework: note specific gaps and link back to which plan step was missed or unclear
• If accept: still note what worked well and what could be improved next time
• Do not skip review even for small changes — capture something