vcautoresearch

# vc:autoresearch — Autonomous Optimization Loop > Constraint + Mechanical Metric + Fast Verification = Autonomous Improvement ## When to Use - Improve a measurable metric (test coverage, bundle size, ESLint errors, Lighthouse score, etc.) - Autonomous execution over N iterations without manual intervention - Git-tracked experiments where you want rollback on regression - Exploring a search space of code changes with consistent evaluation ## When NOT to Use | Situation | Better Tool | |-----------|-------------| | Subjective goals ("make it cleaner") | `execute-agent` with an approved plan | | Bug fixing with known root cause | `debugger` + `execute-agent` | | One-shot tasks, no repetition needed | `execute-agent` | | No mechanical metric to measure progress | normal RIPER flow instead of autoresearch | | Files outside a defined scope | manual approach | ## Configuration Format Parsed from user message. Missing required fields trigger a **batched** `AskUserQuestion`. ### Required | Field | Description | Example | |-------|-------------|---------| | `Goal` | Human description of what to improve | `"Increase test coverage in src/utils"` | | `Scope` | Glob pattern(s) for editable files | `"src/utils/**/*.ts"` | | `Verify` | Shell command that outputs **a single number** | `"npx jest --coverage --json \| jq '.coverageMap \| .. \| .s? \| to_entries \| map(.value) \| (map(select(.>0)) \| length) / length * 100' \| tail -1"` | ### Optional | Field | Default | Description ...