# autoresearch

This plugin runs unattended experiment loops: it edits one file, scores the result, keeps gains, and reverts failures. Use it when code has a measurable outcome.

- plugin · `type=plugin` · Claude Code · ★ 22
- Author: pjhoberman
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pjhoberman/autoresearch
- Updated: 2026-03-24
- HTML: https://affpapa.org/en/nevibecode/plugins/autoresearch

## What it does

autoresearch scans a project for tunable code, scoring logic, magic numbers, and prompt templates. The `/autoresearch:autoresearch-discover` skill ranks possible targets and suggests metrics. Once you choose a file, `/autoresearch:autoresearch path/to/file.py` reads it and asks how the result should be measured.

The main skill prepares an experiment harness with `instructions.md`, an evaluation script, a test-data template, and a launch prompt. The agent is limited to the selected file, keeps changes that improve the score, and rolls back failed attempts. The plugin also includes templates for the instruction, evaluation, and launch files, plus `references/lessons.md`.

A numeric metric is required, and noisy or non-deterministic evaluation can undermine the loop. The plugin targets Claude Code and works around a file that can be safely isolated for edits.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install autoresearch@claude-community
```

## When to use it
- scan a codebase for tunable candidates
- choose a numeric score for an experiment
- generate an evaluation harness for one file
- keep better variants and revert failed changes
- run repeated trials without manual intervention

## Example prompts
- Run `/autoresearch:autoresearch-discover` to find code that can be optimized.
- Set up experiments for `path/to/file.py` using a numeric metric.
- Create the evaluation harness and launch an unattended loop for this file.

## Similar
- [autoresearch-genealogy](https://affpapa.org/en/nevibecode/skills/autoresearch-genealogy.md) — skill · 1300 installs
- [codex-autoresearch-loop](https://affpapa.org/en/nevibecode/skills/codex-autoresearch-loop.md) — skill · 1200 installs
- [autoresearch-agent](https://affpapa.org/en/nevibecode/skills/autoresearch-agent.md) — skill · 589 installs
- [skill-autoresearch](https://affpapa.org/en/nevibecode/skills/skill-autoresearch.md) — skill · 322 installs
- [autoresearch-ai-plugin](https://affpapa.org/en/nevibecode/plugins/autoresearch-ai-plugin.md) — plugin · ★ 13
- [discernment-nudge](https://affpapa.org/en/nevibecode/plugins/discernment-nudge.md) — plugin · ★ 184013
- [academy-guide](https://affpapa.org/en/nevibecode/plugins/academy-guide.md) — plugin · ★ 184013
- [claude-api](https://affpapa.org/en/nevibecode/plugins/claude-api.md) — plugin · ★ 184013

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md