Skill: loop-runner

WHAT

Purpose và context

• 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.
• Trigger (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".
• Non-goals: not an LLM judge of "done"; not a place to tune guard values outside the config; no auto-invocation (disable-model-invocation: true).

Mental model

PROPOSE (workspace state) → VERIFY (shell exit code) → GUARDS (max_iter · budget_seconds · no_progress_k · escalate_after_iter) → REFLEXION (lesson line) → CRITIQUE → REVISE (quarantined adapter) → repeat. Everything except CRITIQUE/REVISE is deterministic.