python-refactor

Refactoring complex Python code safely requires a structured approach using static analysis, tests, and maintainability metrics to transform tangled functions into clear, maintainable implementations without altering observable behavior. This Skill enforces regression-preventive checks using Ruff, Complexipy, and Radon.

Modernizing a legacy Python module with global state involves applying refactoring patterns like guard clauses, dependency injection, and OOP transformations. This Skill provides a 4-phase workflow—Analysis, Planning, Execution, and Validation—to incrementally improve testability and readability while preserving functionality.

Cyclomatic and cognitive complexity metrics measure how difficult Python code is to understand and maintain. By integrating with Complexipy and Radon, this Skill quantifies code complexity to identify tangled functions, guiding targeted refactoring efforts that yield clear, well-documented, and maintainable implementations.

Yes, this refactoring workflow is designed for medium-to-large Python codebases with legacy patterns, global state, or monolithic functions. It applies structured refactoring patterns incrementally, ensuring safety through validation steps that include static analysis, maintainability metrics, and documentation coverage.

Applying refactoring patterns like extract method and dictionary dispatch in Python involves using a structured library of transformations to progressively clean architectures. This Skill guides you through OOP transformations and domain modeling to replace complex logic with clear, maintainable code structures.

A 4-phase refactoring workflow—Analysis, Planning, Execution, and Validation—prevents behavioral changes and regressions that occur when directly modifying Python code. It enforces static analysis and test validation at each step, ensuring that improvements to readability and maintainability are traceable and safe.