autoresearch

Iteratively improves a task until a bounded stop condition using JSON evaluator feedback.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Leap0920/Clean-Portfolio --skill autoresearch-leap0920
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/Leap0920/Clean-Portfolio/tree/main/%25USERPROFILE%25/.openclaude/plugins/cache/omc/oh-my-claudecode/4.14.0/skills/autoresearch
Command: npx skills add https://github.com/Leap0920/Clean-Portfolio --skill autoresearch-leap0920

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Autoresearch solves the problem of getting consistent, evaluator-guided improvements without manually running repeated experiments and tracking results.

Core Features & Use Cases

  • Stateful single-mission improvement loop: Runs one mission at a time and iterates through non-passing outcomes until a bounded stop condition is met.
  • Strict evaluator contract: Requires evaluator output as JSON with a boolean pass (and optional numeric score) so decisions are machine-checkable.
  • Durable decision and evaluation artifacts: Persists per-iteration evaluation JSON and markdown decision logs under .omc/autoresearch/ for auditability and reuse.
  • Stop only with explicit bounds: Continues past failures and stops only when max-runtime (or another explicit terminal condition) is reached.

Quick Start

Run deep-interview with --autoresearch to generate an evaluator for your single mission, then call autoresearch with your mission directory and a max runtime budget.

Frequently Asked Questions about autoresearch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate iterative code refinement until a specific pass condition is met?▼

Iterative code refinement is automated by running a stateful mission loop that continues past non-passing iterations until a bounded max-runtime stop condition is reached. It persists machine-readable evaluation JSON and markdown decision logs for each attempt to ensure strict evaluator-guided improvements.

What format does the evaluator output need to be for automated experiment logging?▼

The evaluator output must be a JSON object containing a boolean `pass` field and an optional numeric `score`. This strict JSON contract ensures decisions are machine-checkable and allows the improvement loop to persist accurate evaluation logs.

How do I run stateful specification tuning with strict pass/fail enforcement?▼

Stateful specification tuning is run by executing a single mission directory with an explicit max runtime budget. The loop evaluates each iteration against a JSON contract, halting only when the evaluator passes or the bounded max-runtime stop condition triggers.

Can I use cron integration to schedule repeated experiment evaluation?▼

Yes, cron integration can be used to schedule repeated experiment evaluation. The loop persists per-iteration evaluation JSON and markdown decision logs under `.omc/autoresearch/`, allowing scheduled runs to maintain auditability and reuse prior state artifacts.

Why does my iterative improvement loop keep running past failed evaluations?▼

An iterative improvement loop continues running past failed evaluations because it is designed to stop only when max-runtime or another explicit terminal condition is reached. It enforces continuous refinement until the bounded stop behavior triggers a halt.