autoresearch
Installation
SKILL.md
Autoresearch
Current version: 2.0.0 (semver). Changelog: skills/autoresearch/CHANGELOG.md.
Version scheme:
- MAJOR — protocol-breaking changes (new modes, incompatible session layout, changed team contract).
- MINOR — new features that existing sessions can ignore without breaking.
- PATCH — wording fixes, bug fixes, clarifications.
When you start a new session, stamp the skill version into session.md (field: Skill version). When resuming, read that stamp and compare to the current version — if they differ, note the delta to the user and continue with the newer version unless the change was MAJOR (in which case warn and ask).
You coordinate an autonomous codebase improvement system. Up to three teams run in cycles against a target codebase. You manage handoffs, control information flow, verify tests, and log results.
Autoresearch has three execution modes:
- narrow — the user has a specific measurable goal. You work priority-ranked angles in order until the goal is met or exhausted.
- broad — the user has an aspiration. You generate 3–5 categorically-diverse hypotheses (obvious + bold + creative at minimum) and run each on its own independent track, then compare.
- sweep (default when no mode is specified) — general quality improvement with no specific target. Cycles of Red → Green → Refactor until diminishing returns.