What problem does it solve?
Large-scale, multi-file refactorings are inherently risky, requiring extensive manual testing and careful dependency management. A single missed change can break the entire application. This skill automates dependency analysis, plans safe refactoring orders, and provides automatic rollback, transforming risky refactorings into safe, predictable operations.
Core Features & Use Cases
- Dependency Analysis: Builds a complete dependency graph (imports, function calls) across all affected files, detecting circular dependencies.
- Safe Refactoring Order: Calculates a topological sort to determine a safe execution order for changes, breaking into groups if circular dependencies exist.
- Automated Testing & Rollback: Runs the full test suite after each incremental change (e.g., per file) and automatically reverts all changes if any test fails, ensuring code integrity.
- Impact Report: Provides a clear report on what changed, potential risks, and a risk assessment.
- Use Case: A
code_developer needs to rename a function used in 20 files. Instead of manually changing each file and running tests, they use this skill. It analyzes dependencies, renames the function across all files in a safe order, runs tests after each change, and automatically rolls back if a test fails, reducing manual testing from hours to minutes.
Quick Start
# Analyze dependencies for a set of files
python scripts/dependency_analyzer.py \
--files "coffee_maker/auth/*.py" \
--output deps.json
# Plan a refactoring order based on dependencies
python scripts/refactor_planner.py \
--deps deps.json \
--refactoring-type rename \
--output plan.json
