Simplify Code

Simplify and refactor $ARGUMENTS.

Simplification Principles

1. Single Responsibility - 1 function = 1 thing
2. Short Functions - Target under 20 lines
3. Shallow Nesting - Early return, depth ≤ 2
4. Clear Naming - Clear enough to not need comments
5. Type Hints Required - On all functions

Steps

1. Analyze Target Code

• Read the file(s) to understand current structure
• Identify complexity hotspots (deep nesting, long functions)
• List functions/classes to simplify