Python Design and Modularity

Overview

Readability-first design with explicit module contracts. Keep control flow, data movement, and ownership boundaries visible so code stays maintainable and safe to change.

Treat these recommendations as preferred defaults. When a default conflicts with project constraints, suggest a better-fit alternative and call out tradeoffs and compensating controls (tests, observability, migration, rollback).

When to Use

• Restructuring modules, packages, or ownership boundaries
• Breaking apart god classes or deeply nested hierarchies
• Choosing between composition and inheritance
• Applying Functional Core / Imperative Shell separation
• Planning a refactor that touches multiple modules
• Reviewing code for readability or architectural clarity