refactor-with-docs

What problem does it solve?

This skill enables teams to perform controlled, single-module refactors with a clear research-and-validate loop, reducing regression risk and improving code health.

Core Features & Use Cases

• Research-driven: perform fresh research before edits.
• Atomic edits: modify only a single mutable file per cycle.
• Coherence review and evaluation: automated checks and guardrails to approve or revert changes.
• Use Case: when a module shows degraded health or architectural drift, run a repeatable refactor loop to improve cohesion while preserving behavior.

Quick Start

Operate the refactor loop on a given target by reading refactor/$ARGUMENTS, then execute the full cycle from research to evaluation for a single mutable file.