What problem does it solve?
Autonomous iterative experimentation to improve a single, measurable development metric (for example test coverage, bundle size, lint error counts, or build time) without manual trial-and-error, preserving a complete git history for analysis and rollback.
Core Features & Use Cases
- Iterative optimization loop: Run N sequential iterations where each iteration makes one atomic change, commits it, verifies a numeric metric, and decides to keep or revert based on configurable thresholds.
- Guarded safety checks: Optional guard commands prevent regressions by making guard-scoped files read-only and triggering rework or reversion when guards fail.
- Logging and analysis: Records a TSV
loop-results.tsv with iteration, commit, metric, delta, and decision to enable pattern recognition and strategy pivots.
- Use Cases: Increase unit test coverage in a module, reduce main bundle size, eliminate ESLint errors in a directory, or iteratively lower build time while preserving test/guard invariants.
Quick Start
Run ck:autoresearch by providing a Goal, a Scope glob, and a Verify command that prints a single numeric value so the loop can iteratively improve that metric.