Refactor Code

Systematic approach to refactoring code safely — improve readability, cohesion, and maintainability without changing behavior.

Triggers

• Function > 50 lines
• File > 300 lines
• Duplicate code (3+ instances)
• Complex conditionals (> 3 levels deep)
• any types
• Hard to test or understand
• Vague naming and mixed responsibilities
• Dead abstractions, dead code, or misleading comments

Steps

1. Lock Behavior First