Refactor legacy code to clean architecture

Guides GPT/Claude to progressively refactor a spaghetti file into layered clean architecture.