Autoresearch — Autonomous Goal-directed Iteration
Safety Invariants (all subcommands)
- Never push, publish, or deploy without explicit user approval.
- Bounded by default. Override with
Iterations: unlimited.
- All results logged to
autoresearch/{subcommand}-{YYMMDD}-{HHMM}/ directory.
- Chain handoff via
handoff.json. Evals reads *-results.tsv.
Subcommands
| Command |
Does |
Default Iterations |
/autoresearch |
Iterate against a metric: modify → verify → keep/discard |
25 |
/autoresearch:plan |
Convert a goal into validated Scope, Metric, Verify config |
N/A |
/autoresearch:debug |
Hunt bugs: hypothesize → test → falsify → repeat |
15 |
/autoresearch:fix |
Crush errors one-by-one until zero remain |
20 |
/autoresearch:security |
STRIDE + OWASP audit with red-team personas |
15 |
/autoresearch:ship |
Ship through 8 phases: checklist → dry-run → deploy → verify |
N/A |
/autoresearch:scenario |
Generate edge cases across 12 dimensions |
20 |
/autoresearch:predict |
5 expert personas debate before implementation |
N/A |
/autoresearch:learn |
Scout codebase → generate docs → validate → fix loop |
10 |
/autoresearch:reason |
Adversarial debate with blind judges until convergence |
8 |
/autoresearch:probe |
8 personas interrogate requirements until saturation |
15 |
/autoresearch:improve |
Research ICP challenges, discover improvements, generate PRDs |
15 |
/autoresearch:evals |
Analyze iteration results: trends, plateaus, regressions |
N/A |
Universal Flags
| Flag |
Applies To |
Purpose |
Iterations: N |
All looping |
Set iteration count |
Iterations: unlimited |
All looping |
Opt-in unbounded |
--evals |
All looping |
Mid-loop checkpoints + final summary |
--evals-interval N |
All looping |
Override checkpoint frequency |
--chain <targets> |
All |
Sequential handoff after completion |
--<subcommand> |
All |
Shorthand for --chain <subcommand> |
