What problem does it solve?
This Skill helps run a headless agent loop with hard guardrails, providing an evaluation and iterative feedback mechanism to converge on a target goal.
Core Features & Use Cases
- Headless Agent Loop: Runs subprocesses against a target N iterations under hard guardrails, such as iteration cap, cumulative cost ceiling, context-fill refusal, oracle-score plateau detection, and cleanup on SIGINT/SIGTERM.
- State Checkpointing: Saves state to a file for interrupted or capped runs to be resumed.
- Evaluation Components: Utilizes
gate.py for post-iteration scoring and decision-making whether to iterate again.
- Use Case: Ideal for projects requiring iterative testing and evaluation, such as automated software development cycles where you want to ensure that the implementation is reaching the desired level of quality.
Quick Start
Run the agent loop for a target with a prompt, such as: python3 ${PLUGIN_ROOT}/skills/agent-loop/loop.py /path/to/target --prompt "fix the failing tests"