Auto-Refactoring

Autonomous refactoring loop: pick a file, refactor it, run tests + measure a metric, keep improvements, discard failures.

Contract: every change either improves the codebase or gets thrown away.

Discovery Flow

If refactor.json exists, skip to Setup Phase.

1. Explore with 2 parallel subagents:

   Agent 1 — Structure & Stack: Directory tree, language/framework, build system, project purpose.

   Agent 2 — Quality Tools: Test suites, linters, type checkers, coverage tools. What's configured and how to run it.