Traits to Services: Refactoring for Testability (and for Agents)

How extracting six PHP traits into service classes with contracts created clean boundaries — and why clear boundaries help AI agents more than documentation.