refactor-method-complexity-reduce

Overview

This skill refactors methods with high cognitive complexity by systematically extracting focused helper methods and simplifying control flow. Given a target method and a complexity threshold, it analyzes sources of complexity such as nested conditionals, loops, and boolean expressions, then restructures the code to reduce cognitive load while preserving exact functionality.

Key Features

• Complexity Source Analysis - Identifies nested conditionals, if-else chains, switch statements, repeated code blocks, loops with conditions, and complex boolean expressions contributing to high cognitive complexity
• Focused Helper Extraction - Extracts validation logic into Validate* methods, type-specific processing into handler methods, and common operations into utility methods with single responsibilities
• Control Flow Simplification - Reduces nesting depth, replaces massive if-else chains with orchestrated calls, and applies guard clauses and early returns for cleaner flow
• Functionality Preservation - Maintains identical input/output behavior, all validation and error handling, exception types, error messages, and parameter passing
• Configurable Threshold - Accepts a target complexity threshold so the refactoring can be tailored to specific code quality standards

Who is this for?

Software developers and tech leads dealing with complex, hard-to-maintain methods flagged by static analysis tools like SonarQube or CodeClimate. Ideal for teams performing code quality improvements and refactoring sprints where reducing cognitive complexity is a measurable goal.