Architecture

Change how the codebase is structured, typed, or measured for performance — not whether to build a feature, and not language-runtime validation.

Core Architectural Axioms (Always Active)

• Deep Modules: Small interface surface, substantial private behavior. Avoid shallow pass-through bags.
• Deletion Test: Candidate modules must pass the deletion test — removing or swapping a module should not cause cascading rewrites across unrelated consumers.
• Single Ownership: One fact, rule, or expansion algorithm has exactly one authoritative owner. Eliminate dual ownership between validate and execute, or between two adapters.
• Locality over Ceremony: Introduce seams only where they buy testability or phased migration. Wrong-layer domain surfaces fail locality even if deep internally.
• Wire vs Domain Boundary: Domain types enforce invariants at construction; boundary adapters map wire primitives inbound and outbound. Keep application logic out of serialization shells.

Pick branch

Never ask the user to pick a template when signals are clear. Load one or more when signals combine.