Simplify

3. Plan Refactoring

For each complexity issue:

• What change to make
• Why it improves readability
• Verify it doesn't break library usage

4. Execute Refactoring

Apply changes following these patterns:

Early Return:

# Before
def process(value):
    if value is not None:
        if value > 0:
            return do_something(value)
    return None

# After
def process(value):
    if value is None:
        return None
    if value <= 0:
        return None
    return do_something(value)

Extract Function:

# Before
def main():
    # 50 lines of mixed concerns
    ...

# After
def main():
    data = load_data()
    result = process_data(data)
    save_result(result)

5. Verify with Tests

uv run pytest -v

Notes

• Always preserve library features/constraints
• Web search for unclear points
• Don't change behavior (refactoring only)
• Run tests after each significant change