Improve Codebase Maintainability

Find practical, low-risk opportunities to improve the codebase without changing behaviour.

The goal is not to redesign the whole system. The goal is to make the codebase easier to read, safer to change, easier to test, and less repetitive.

Focus on:

• Code quality and readability
• Overly complex or hard-to-follow code
• Duplicated logic across files
• Large files doing too many things
• Poor separation of concerns
• Repeated validation, mapping, parsing, formatting, or error-handling logic
• Brittle tests or missing tests around risky areas
• Refactors that improve locality and reduce cognitive load
• Interfaces that leak sequencing, invariants, or implementation details to callers

Avoid speculative architecture rewrites.