polish-new
Pre-Release Polish
A review is finished when a review of its own fixes warrants no further edits -
not when the fixes are written, not when checks pass. Evidence beats judgment: a
finding that cannot be reproduced from its own citations does not survive. The
fix pass is where the next round's defects come from, so it gets reviewed like
any other code. Findings live in files, not in this conversation - context can
be compacted away mid-run; if you are resuming after a compaction or
interruption, re-read ledger.md and the saved agent reports before continuing.
They are the source of truth, not the summary.
A base ref may be passed as an argument; Phase 2 uses it for scope.
Phase 0: Orient
Work in the repository under review - it may be a worktree, not the current directory. Establish state there: