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.