refactor-review

Installation
SKILL.md

🔎 Refactor Review (New Changes Only)

Where this fits

This is stage 5 of a seven-stage workflow:

  1. architect-deep-dive — resolves the design
  2. agent-brief — turns it into the plan the rest builds from
  3. acceptance-tests — the plan's criteria as failing black-box tests
  4. tdd — builds it red-green until the acceptance tests pass
  5. refactor-review (this skill) — cleans the structure once behavior is verified
  6. devils-advocate — hunts evidence for every defect
  7. tyr-verdict — adjudicates the findings and enforces the fixes

This stage runs on a GREEN suite and keeps it GREEN. Reviews target new changes only, and refactorings are behavior-preserving — no new features, no bug fixes mixed in.

Requires: python3 (the ledger checker in scripts/ledger.py) and git (to read the change from the brief's Base or the merge-base, and for the save-point commit after each refactoring). If either is missing, skip the check that needs it and say so in your closing lines.

Reference files

Installs
5
First Seen
Oct 24, 2026