Refactor Code Safely

Simplify code by reducing complexity while preserving exact behavior, making it easier to read, understand, modify, and debug.

Drive development with tests by writing a failing test before implementing code, and reproduce bugs with tests before fixing them.

Enforces running verification commands and confirming output before claiming work is complete, fixed, or passing, to prevent false success claims.

Finds and safely removes dead code across a codebase: unreachable paths, unused exports, functions, variables, CSS selectors, dependencies, env vars, and commented-out blocks. Builds an import graph, verifies no dynamic references, and runs build and tests after cleanup.

Delivers a small, bounded code change through inspection, a mini-plan, implementation, testing, review, and adversarial verification. Use for bug fixes, configuration changes, and features expected to touch no more than five files.

Analyzes a completed phase diff for high-confidence behavior-preserving simplifications and applies only explicitly approved proposals, reducing duplication, dead code, needless complexity, or avoidable inefficiency.

Refactors production code with test coverage using a TDD workflow that applies approved refactorings one at a time, gates each on passing tests, and commits or reverts accordingly.

Reviews a codebase for structural smells and refactors them with provable safety, using micro commits and green-bar discipline.

Refactors duplicated code by extracting helper methods, shared abstractions, or reusable structures, with automated testing and commits after each extraction.