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

Run the project's verification commands to confirm no regressions:

# Python files
uv run ruff check --fix {file}
uv run ruff format {file}

# PowerShell files
pwsh -NoProfile -Command "Invoke-ScriptAnalyzer -Path '{file}' -Severity Warning,Error"

# General: run project-defined test/check commands
# Check pyproject.toml, package.json, or Makefile for test commands

Notes

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