What problem does it solve? Multi-file refactors often fail because changes are made ad hoc without understanding dependencies, leading to broken builds and risky rollbacks. This Skill enforces an investigate-first workflow that produces a concrete, sequenced plan and waits for your confirmation before touching any code. ## Core Features & Use Cases - Investigation Before Editing: Searches the codebase, reads implementations, tests, and configs to ground the plan in the actual repository state. - Structured Phased Plan: Outputs affected files with dependency mapping, ordered phases (types first, then implementations, callers, tests, cleanup), per-phase verification steps, and rollback procedures. - Confirmation Gate: Stops after presenting the plan and asks for approval before implementing, preventing unreviewed large-scale changes. - Use Case: You need to rename a core service interface used across 30 files. The Skill maps every caller, sequences the change safely, defines verification commands per phase, and only proceeds after you approve. ## Quick Start Ask the AI to plan a refactor of the authentication module across the codebase and wait for the proposed plan before approving implementation.
