← ClaudeAtlas

principle-deep-moduleslisted

Apply when decomposing a system, adding a module, or assigning parallel agent work. Wide at the system level, deep at the module level, shallow in directory nesting: each module hides substantial functionality behind a small public entry point, and agents coordinate through contracts, not shared internals.
justinramos101/ramstack · ★ 0 · DevOps & Infrastructure · score 67
Install: claude install-skill justinramos101/ramstack
# Deep Modules Build a wide system of deep modules. Each module encapsulates substantial functionality behind a small, stable interface. The system holds several independently owned modules that agents can work on in parallel. **Why:** Agents reason best within a bounded context: inputs, contract, outputs, without loading adjacent internals. Deep modules lower context requirements, constrain what a change can accidentally break, let multiple agents modify separate modules without editing shared internals, and make review a check against a contract. A shallow module exposes many functions, types, and implementation decisions relative to the value it provides, and every consumer inherits them. **The topology:** - Wide at the system level. Several independently understandable modules, not one giant deep module hiding the whole application. - Deep at the module level. A small public API over significant internal implementation. Depth is the ratio of functionality hidden to interface exposed. The interface-compression test in the **minimize-reader-load** principle skill is the arbiter, so a pass-through entry point that re-exports three functions is not depth. - Shallow in directory nesting. Deep conceptual modules, shallow paths. `src/ordering/domain/` is fine; `src/modules/business/order/core/domain/entities/internal/` is not. **The rules:** - One obvious public entry point per module. Internal accessibility does not imply architectural permission; callers never reach thro