autoresearch

name	autoresearch
description	Autonomous iteration loop: modify, verify, keep/discard against any metric
version	2.1.0

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>