iteratelisted

# Iterate - Autonomous Improvement Loop Inspired by [Karpathy's autoresearch](https://github.com/karpathy/autoresearch): constrain scope, clarify success with one mechanical metric, loop autonomously. The agent modifies code, measures the result, keeps improvements, discards regressions, and repeats - until any stop condition fires or the user interrupts. The power is in the constraint. One metric. One scope. One loop. Git as memory. ## Preflight Before the loop starts, do the work that makes the loop effective. Don't skip steps - this discipline is what separates a productive overnight run from a flailing one. ### 1. Collect Config If provided inline, extract and proceed. If required fields are missing, ask once using `AskUserQuestion` with all missing fields batched together. | Field | Required | What it is | Example | |-------|----------|------------|---------| | **Goal** | Yes | What you're improving, in plain language | "Increase test coverage to 90%" | | **Scope** | Yes | File globs the agent may modify | `src/**/*.ts` | | **Verify** | Yes | Shell command that outputs the metric (a number) | `npm test -- --coverage \| grep "All files"` | | **Direction** | Yes | Is higher or lower better? | `higher` / `lower` | | **Guard** | No | Command that must always pass (prevents regressions) | `npm run typecheck` | | **Batch** | No | Changes per iteration. >1 enables bisect-on-regression. Default `1`. | `3` | | **Iterations** | No | Hard cap on iteration count. | `30` | | *