ask-python-refactor

<naming> Variables: descriptive nouns (user_count not n) Functions: verb + object (calculate_total not calc) Classes: entity nouns (OrderProcessor not OP) </naming>

• Duplicated code → extract to shared function
• Long parameter lists → group into dataclass
• Deep nesting → use early returns/guard clauses
• Magic numbers → replace with named constants </code_smells>

<patterns> ## Dispatch Tables ```python # Before: long if/elif chains # After: handlers = {'a': process_a, 'b': process_b} handler = handlers.get(data.type, process_default) return handler(data) ```

Type Hints

</patterns> <workflow> 1. Ensure tests exist 2. Make small changes, verify each step 3. Run tests after every change 4. Commit frequently 5. Review diff before finalizing </workflow>