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