Complexity Analyzer

Complexity is the enemy. Good design reduces the complexity developers face.

Three Symptoms

1. •

   Change Amplification: Simple change requires modifications in many places

   • •Duplicated magic values, scattered configuration, tight coupling
2. •

   Cognitive Load: Too much knowledge needed to complete a task

   • •Too many parameters, deep nesting, complex conditionals, hidden state, non-obvious side effects
3. •

   Unknown Unknowns: Not obvious what to modify or what info is needed

   • •Missing docs on non-obvious behavior, implicit contracts, hidden dependencies, action-at-a-distance

Red Flags

• •Shallow modules (interface nearly as complex as implementation)
• •Information leakage (implementation details in interfaces)
• •Pass-through methods (just call another method)
• •Conjoined methods (must be called together)
• •Temporal decomposition (split by execution order, not information hiding)

Output

Complexity level (Low/Medium/High/Critical), findings with location/symptom/impact/suggestion, prioritized refactoring recommendations.