loop-runner
Installation
SKILL.md
Skill: loop-runner
Purpose
Drive an autonomous fix loop that CANNOT run away. VERIFY is a shell command whose exit-code 0 means pass (pytest / tsc / a lint) — preferred over LLM self-judgment, because the agent cannot argue its way around a red exit code. The termination guards are MANDATORY and all deterministic.
When to use
- An agent loops edit-then-check repeatedly (fix failing tests, satisfy a typechecker/lint).
- You need a hard guarantee it stops: bounded iterations, bounded wall-clock, stop-on-stall, escalate.
- You want a replayable run-log + a reflexion lesson trail, without trusting the model to "decide it's done".
Build-now / adapt-later boundary
- DETERMINISTIC (built + tested now): control loop, all guards, state-hash progress detection,
run-log artifact, reflexion. →
harness/scripts/loop-runner.py - QUARANTINED adapter (
verified: false): the LLM critique/revise step + the tunable guard values. →harness/loop-runner.config.yaml(the ONE file you edit to adapt). The default revise step is a no-op / shell stub, so the whole loop runs and self-tests WITHOUT an LLM.