Modular Decomposition¶
Break a complex system into bounded modules so complexity, change, work, or failure can be handled locally.
The Diagnostic Story¶
Symptom: A small change anywhere in the system requires broad review across the whole; no one can say confidently who owns a decision or a defect. Subsystems cannot be tested, taught, or replaced independently, and integration failures only surface late because local work doesn't recombine cleanly.
Pivot: Partition the whole into modules with coherent responsibilities, explicit boundaries, stable interaction surfaces, and rules for reintegrating local work — so complexity, change, work, and failure can each be handled locally without disrupting the rest.
Resolution: Local complexity drops to a manageable level; changes are safer and can proceed in parallel; accountability is clear; and the system can evolve, scale, or accept variation without constant full-system redesign.
Reach for this when you hear…¶
[software engineering] “Fixing one bug means touching six files and praying the regression suite catches whatever I broke somewhere else.”
[manufacturing] “We can't retool a single station without shutting down the whole line because every step feeds directly into the next with no buffer.”
[curriculum design] “I can't update the third-week module without rewriting the whole course because everything assumes the student learned everything in exactly the right order.”
Mechanisms / Implementations¶
- Curriculum Units
- Legal or Policy Sections
- Mechanical Subassemblies
- Organizational Team Boundaries
- Product Subsystem Decomposition
- Software Module Decomposition
Related Abstractions¶
Abstractions this archetype builds on — directly (a source ingredient) or as a related pattern. Links follow the typed catalog namespace.
Built directly on (3)
- Boundary: Defines system limits.
- Composition: Arranges components into a cohesive whole.
- Modularity: Breaks systems into smaller units.
Also references 3 related abstractions
- Hierarchy: Organizes elements into levels or ranks.
- Relation: Describes associations or dependencies.
- Set and Membership: Groups and categorizes elements.
Variants¶
Narrower or domain-specific specializations that share this archetype's core structure. Recognized variants are established; candidate variants are provisional.
Separation of Concerns · subtype · likely subtype
Separate different purposes, rules, or responsibilities into distinct units so changing one concern does not entangle unrelated concerns.
Recursive Modular Decomposition · scale variant · candidate
Apply modular decomposition repeatedly so each module can itself be decomposed into smaller modules where useful.