What's New
Optional Bounded Loop Count
You can now control how many iterations autoresearch runs using Claude Code's built-in /loop command:
# Run exactly 25 iterations, then stop and summarize
/loop 25 /autoresearch
Goal: Increase test coverage to 90%
Requires: Claude Code v1.0.32+ (the
/loopcommand was introduced in this version)
Two Loop Modes
| Mode | Usage | Behavior |
|---|---|---|
| Unbounded (default) | /autoresearch
| Loops forever until Ctrl+C
|
| Bounded (new) | /loop N /autoresearch
| Runs exactly N iterations, prints final summary |
When to Use Bounded Loops
| Scenario | Recommendation |
|---|---|
| Run overnight, review in morning | Unlimited (default) |
| Quick 30-min improvement session | /loop 10 /autoresearch
|
| Targeted fix with known scope | /loop 5 /autoresearch
|
| Exploratory — see if approach works | /loop 15 /autoresearch
|
| CI/CD pipeline integration | /loop N /autoresearch (set N based on time budget)
|
Bounded Mode Features
- Fixed iterations — Runs exactly N times through the loop
- Final summary — Prints baseline → current best, keeps/discards/crashes after completion
- Early completion — Stops and reports when goal is achieved before N iterations
- Smart exploitation — Prioritizes exploiting successes over exploration when <3 iterations remain
- Fully backward compatible — All existing rules still apply
Final Summary Format
=== Autoresearch Complete (25/25 iterations) ===
Baseline: 72.0% → Final: 89.3% (+17.3%)
Keeps: 12 | Discards: 11 | Crashes: 2
Best iteration: #18 — add tests for payment processing edge cases
Files Changed
| File | Change |
|---|---|
skills/autoresearch/SKILL.md
| v1.0.1: /loop section, bounded mode docs, updated pseudocode |
skills/autoresearch/references/autonomous-loop-protocol.md
| Unbounded/bounded modes, Phase 8 split, smart exploitation |
skills/autoresearch/references/results-logging.md
| Bounded mode summary reporting |
README.md
| Controlled Iterations section, version badge, updated FAQ |
Installation
# Clone and copy to your project
git clone https://github.com/uditgoenka/autoresearch.git
cp -r autoresearch/skills/autoresearch .claude/skills/autoresearch
# Or copy to global skills
cp -r autoresearch/skills/autoresearch ~/.claude/skills/autoresearchFull Changelog: v1.0.0...v1.0.1