Polish — Re-runnable Branch Quality Gate

Get a branch into reviewable shape, and re-run any time after a batch of changes. Polish composes the pr-reviewer agent (read-only review via the branch's open PR) with its own simplify engine, rules/simplify.md, over the branch diff. How review-loop and /create-pr call polish: references/callers.md.

Contents: Modes · Step 0 · Step 1 · Step 2 · Step 3 · Step 4 · Hard rules

Modes

Parse the first token of $ARGUMENTS. Everything else is a flag.

Mode	Trigger	What runs
full (default)	No mode token	Pass A (`review`), then Pass B (`simplify`) — this order is fixed.
`review`	First token `review`	Pass A only.
`simplify`	First token `simplify`	Pass B only. `simplify dry-run` reports without writing; `simplify <path>` scopes to a path.
`quick`	First token `quick`	Pass C only — light mechanical pass (comments, docstrings, `else` after `return`, local names); no pr-reviewer pass, no structural refactors.