← ClaudeAtlas

principle-bounded-loopslisted

Apply when writing any loop, retry, or watch cycle. Declare the cap with the loop and make hitting it a loud, terminal, reported outcome — never silent grinding. Size budgets are the output-side instance.
bostonaholic/team · ★ 11 · AI & Automation · score 73
Install: claude install-skill bostonaholic/team
# Bounded Loops Every loop carries a declared cap, and hitting the cap is a defined, loud, terminal outcome: halt and hand the work back with the full unresolved state. A loop with no declared end is its own failure mode. **Why:** A loop that cannot converge must not discover that by running forever. The cap converts "stuck" from an invisible state into a reported one, at a bounded and pre-agreed cost. **Pattern:** - Declare the bound with the loop: watch cycles, retries, poll budgets, helpers in flight. - Hitting the cap halts terminally: report everything unresolved. Never silently restart, extend, or soften the exit criteria to escape. - A retry budget is small and stated ("retry once, then halt loudly"). - A loop that ends on a verdict rather than a count is already bounded: the verdict is the bound. Declare that terminal condition, and then never supply a count the loop deliberately omits — the missing number is the design, not a gap for a reader to fill. The operator who can stop the run is the outer bound. Team's two review loops are this case: DESIGN ends on the reviewer's verdict, IMPLEMENT ends when no Blocking or Major finding is left, and neither takes a round cap. ## Size budgets The same rule bounds output. Artifacts and replies carry size targets — a ~200-line design, a ≤ 30-line helper reply, a byte-capped prompt. Over budget means restructure: drop whole units and name what you dropped. Never silent truncation.