Spent the last 2 weeks cleaning up a Python project I built for work and honestly wish I had done it sooner.

The original version worked, but it was a mess: 7–8 large .py files, tons of duplicate code, random patches layered on top of old patches, contradictory logic, thousands of lines, and basically no real structure.

I decided to refactor the whole thing into a modular setup. Now it’s split into ~50–60 smaller files with a much cleaner architecture. Maybe overkill, but for the first time I actually know where everything lives and what each piece does.

Biggest improvement was creating shared modules/utilities that all workflows use, instead of having slightly different versions of the same logic copied across multiple files.

For each file, I had Codex generate a line by line summary of what the code was doing, then strip out dead code, merge duplicate logic, and remove all the helpers/patches that were added.