# Polish Beads

> Polishing pass over all open beads. "Check your beads N times, implement once." Run 4–6 times. Use after /plan-to-beads and between refinement rounds.

- Skill: `hoangsonww/polish-beads-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hoangsonww/polish-beads-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangsonww/polish-beads-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hoangsonww (https://skillmd.com/u/hoangsonww)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hoangsonww/polish-beads-2

---


# /polish-beads — convergence loop

Single most-underinvested step in the methodology. Every polish round
is ~100× cheaper than finding the same issue during implementation.

## Prompt

Use the verbatim prompt at `.flywheel/prompts/polish-beads.md`.

## What to check each round

1. **Self-containment.** Fresh agent, no plan — can they execute?
2. **Dependencies.** `depends_on` correct? Missing edges?
3. **Tests.** Concrete unit + e2e obligations with detailed logging?
4. **Coverage.** Cross-reference beads vs `.flywheel/plans/*.md`.
5. **Duplicates.** Merge overlapping beads into canonical ones.
6. **Forge invariants.** Permission gate, `LEGAL_TRANSITIONS`, UI
   budget, provider probe timing.

## Run count

4–6 rounds typical. Stop when:

- two consecutive rounds produce only small corrective edits,
- no new structural issues surface,
- dependency graph is stable.

If polishing has flatlined after 3 rounds, switch to `/fresh-eyes` —
a new session with no context baggage.

If 20+ new beads were added in a batch, also run `/dedupe-beads`.

## Final round: different model

As a final polishing pass, run this same prompt through a different
model (e.g. switch from Claude to Codex, or vice versa). Different
models catch different things.