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.
Installs
118
Repository
rheinmir/setup
GitHub Stars
1
First Seen
Jun 28, 2026
loop-runner — rheinmir/setup