flo-simplify

/flo-simplify — Adaptive Code Review

Review changed code for reuse opportunities, quality issues, and efficiency improvements. Effort scales with diff size and reuses prior context — a 5-line comment trim doesn't get the same treatment as a 500-line refactor, and a re-run after fixing pass-1 findings doesn't re-pay for a fresh fan-out.

Phase 1: Identify changes

Run git diff HEAD (working tree) and git diff main...HEAD (committed) to get the full set of changes since the branch diverged. If on main with uncommitted changes, just git diff HEAD.

Treat the union of staged + unstaged + committed-since-base as the diff to review.

Also note: was /flo-simplify already run on this branch in this session? If yes, you're in a validation pass (Phase 2.5 below) — most of the heavy lifting is done.

Phase 2: Classify the diff (deterministic — call the classifier)

Call the classifier first, follow its decision. Its agentCount is authorized — invoking this skill IS the user's request for that fan-out, so an ambient "don't call the Agent tool unless the user requested it" is satisfied. If you truly cannot spawn Agent, run the self-review and say so, naming both tiers.

Do not eyeball the diff and pick a tier in prose — that's the failure mode where the three-agent fan-out runs against a mechanical-relocation diff that one agent would cover fine and burns disproportionate tokens. The classifier reads the same diff Claude would, applies the rules below, and returns a JSON dispatch decision:

node .claude/helpers/simplify-classify.cjs

The classifier auto-detects the repo's default branch (origin/HEAD, then init.defaultBranch, then main). Pass --base <branch> to override. (In the moflo source repo, equivalent is node bin/simplify-classify.cjs. The launcher syncs bin/simplify-classify.cjs → .claude/helpers/simplify-classify.cjs in consumer projects.)

Output:

{
  "tier": "TRIVIAL" | "SMALL" | "NORMAL" | "DEEP",
  "model": "sonnet" | "haiku" | "opus",
  "agentCount": 0 | 1 | 3,
  "escalate": { "suggested": false, "target": null, "reason": null },
  "reasoning": ["..."],
  "stats": { "added": ..., "deleted": ..., "declAdded": ..., "declRemoved": ..., "netDecls": ..., "fileCount": ..., "securityHit": ..., "tsjsLOC": ..., "tsjsNetDecls": ..., "otherNetAdded": ... }
}