polishing-branch git:20260913.b3aaa6aA

Immutable. This exact content never changes and is served at /api/v1/blob/9374dd9dd8a11ca6.

---
name: polishing-branch
description: Use when a tk branch is finished and should be brought to review quality end to end, or when asked to "polish", "finish", or "get this ready" with no narrower instruction. Runs the conformance and refactoring skills in alternation.
---

# Polishing a Branch

## Overview

Alternate `conforming-to-agents-md` and `refactoring-iteratively` until one full
cycle of both reports no changes. Refactors can introduce rule violations, and
conformance fixes can expose refactors, so neither skill alone reaches a fixed
point.

## The loop

Track cycles in `<scratchpad>/polish/cycles.md`. Every cycle:

1. Invoke `conforming-to-agents-md` with the Skill tool and follow it to its
   final report. Record its `Changes applied: N` line.
2. Invoke `refactoring-iteratively` with the Skill tool, no argument, and follow
   it to its final report. Record its `Changes applied: N` line.
3. If both lines read `Changes applied: 0`, stop. Otherwise start the next cycle.
4. After cycle 3, stop regardless and report which skill was still making changes.

Each invocation runs the full skill, including fresh reviewer sweeps. Do not
skip a skill because the previous cycle's run of it was clean; that is what the
stop condition in step 3 checks.

## Report

Cycles run, a table of changes applied per skill per cycle, the final test
result from the last skill run, and a `git diff --stat origin/main` of the tree.
Nothing is committed; say so.