autoresearch

Category: Tools & Productivity | Uploader: Maleick | Downloads: 0 | Version: v1.0（Latest）

Run a subagent-first structured improve-verify loop in OpenCode. Activate with /autoresearch or specialized modes like /autoresearch:plan, /autoresearch:debug, /autoresearch:fix, /autoresearch:learn, /autoresearch:predict, /autoresearch:scenario, /autoresearch:security, /autoresearch:ship. Supports recursive self-improvement loops.

Changelog: Source: GitHub https://github.com/Maleick/AutoResearch

Directory Structure

Current level: tree/main/skills/autoresearch/

📁 references/
- 📄 core-principles.md 736 B
- 📄 debug-workflow.md 735 B
- 📄 fix-workflow.md 879 B
- 📄 interaction-wizard.md 1.2 KB
- 📄 learn-workflow.md 527 B
- 📄 loop-workflow.md 1.4 KB
- 📄 plan-workflow.md 1.2 KB
- 📄 predict-workflow.md 540 B
- 📄 results-logging.md 1.3 KB
- 📄 runtime-hard-invariants.md 742 B
- 📄 scenario-workflow.md 483 B
- 📄 security-workflow.md 561 B
- 📄 self-improve-loop.md 8.0 KB
- 📄 ship-workflow.md 445 B
- 📄 state-management.md 2.0 KB
- 📄 structured-output-spec.md 624 B
- 📄 subagent-orchestration.md 2.5 KB
📄 SKILL.md 3.9 KB

SKILL.md

---
name: autoresearch
description: "Run a subagent-first structured improve-verify loop in OpenCode. Activate with /autoresearch or specialized modes like /autoresearch:plan, /autoresearch:debug, /autoresearch:fix, /autoresearch:learn, /autoresearch:predict, /autoresearch:scenario, /autoresearch:security, /autoresearch:ship. Supports recursive self-improvement loops."
metadata:
  short-description: "Subagent-first autonomous iteration loop for OpenCode with recursive self-improvement"
---

# Auto Research for OpenCode

Use this skill when the task is larger than a one-shot edit and benefits from repeated experiments with mechanical verification, parallel subagent input, and a main-agent orchestrator that keeps the Auto Research loop moving.

## Activation Contract

When invoked:

1. Read `references/core-principles.md`
2. Read `references/structured-output-spec.md`
3. Read `references/subagent-orchestration.md`
4. For new interactive runs, read `references/interaction-wizard.md`, `references/plan-workflow.md`, and `references/loop-workflow.md`
5. For state and results semantics, read `references/state-management.md` and `references/results-logging.md`
6. For self-improvement and recursive loops, read `references/self-improve-loop.md`
7. For specialized modes, read the matching workflow reference:
   - `references/debug-workflow.md`
   - `references/fix-workflow.md`
   - `references/learn-workflow.md`
   - `references/predict-workflow.md`
   - `references/scenario-workflow.md`
   - `references/security-workflow.md`
   - `references/ship-workflow.md`

## Subagent-First Orchestration

The main agent is the orchestrator. Subagents are the standing execution pool.

- Keep a small, persistent subagent pool alive across iterations.
- Use subagents for bounded context gathering, alternative generation, verification, and critique.
- Feed subagent findings back into the next iteration before making another code change.
- The main agent owns the final decision, the edit, and the run state.
- Approval belongs before launch. After launch, continue by default unless the user stops the run.

## Recursive Self-Improvement

Auto Research can run on itself:

```mermaid
flowchart TD
    A[Meta-Goal] --> B[Child Loop]
    B --> C[Evaluate]
    C --> D{Improve?}
    D -->|yes| E[Learn + Memory]
    D -->|no| F[Adapt Strategy]
    E --> G[Next Child]
    F --> G
    G --> B
```

- Use `references/self-improve-loop.md` for recursive run semantics.
- Meta-iterations spawn child loops that inherit the meta-goal.
- Patterns extracted from child results guide strategy adaptation.
- Memory persists across meta-iterations in `autoresearch-memory.md`.

## Required Internal Fields

Infer or confirm before launching:

- **Goal** — What outcome should this run optimize?
- **Metric** — What numeric metric tracks progress?
- **Direction** — `lower` or `higher`
- **Verify** — The mechanical command that measures the metric

Strongly recommended:

- **Run Mode** — `foreground` or `background`
- **Scope** — In-scope files or subsystem
- **Guard** — Optional guard command for regression catch

## Execution Rules

1. Always read relevant in-scope files before the first write.
2. Baseline exactly once at run start.
3. Make one focused experiment per iteration.
4. Verify mechanically. Do not keep on intuition alone.
5. Record every iteration before the next one starts.
6. Keep strict improvements, discard regressions.
7. Continue until the stop condition is met.
8. For self-improvement runs, archive state before each meta-iteration.

## Background Control

```bash
autoresearch init --goal "..." --metric "..." --direction "lower" --verify "npm test"
autoresearch status
autoresearch stop
autoresearch resume
autoresearch complete
```

## Output

Follow `references/structured-output-spec.md`. Print a setup summary before the first iteration, short progress updates during the loop, and a completion summary when done.

For recursive runs, emit meta-iteration summaries in addition to standard progress.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

autoresearch

Directory Structure

SKILL.md

Report

Notice