Python Refactor

Transform complex Python into clear, maintainable code while preserving correctness. Phased workflow with safety-by-design and continuous validation. For deep references (anti-patterns, OOP principles, cognitive complexity, regression prevention), see the references/ directory.

When to invoke

• Explicit "human", "readable", "maintainable", "clean", or "refactor" request
• Code review flags comprehension or maintainability issues
• Legacy code modernization
• Onboarding / educational contexts
• Complexity metrics exceed thresholds
• Red flags: file > 500 lines with scattered functions and global state, multiple global statements, no clear module/class organization, configuration mixed with business logic

Do NOT invoke when

• Code is performance-critical and profiling shows perf optimization is needed first
• Code is scheduled for deletion or replacement
• External dependencies require upstream contributions instead
• User explicitly requested perf optimization over readability