Decoupling via Interface¶
Interpose a stable interface between components so each can change without being exposed to the other's internals.
The Diagnostic Story¶
Symptom: A change in one part of the system automatically breaks something somewhere else, even though the two parts are not supposed to be that tightly linked. Teams, services, or suppliers know each other's internal details by accident — because direct connection exposed everything. Small internal updates require cross-team coordination. What should be a local improvement becomes a negotiation, a freeze, or a cascade of downstream fixes.
Pivot: Stop letting the parts interact through direct exposure to each other's internals. Define a stable interface — a contract, protocol, adapter, or service boundary — that specifies what can cross between them while hiding internal variation on each side. Indirection absorbs internal change; versioning makes interface evolution explicit and negotiated rather than accidental and breaking.
Resolution: Each side can change, upgrade, or be substituted behind its interface without automatically obligating the other side to change. Necessary exchange continues through a stable, explicit surface. Dependency remains, but it is narrow, documented, and governable rather than broad, tacit, and fragile.
Reach for this when you hear…¶
[software architecture] “Every time the schema team touches a table, three downstream services break — we need an API in front of that database before anyone else builds on it.”
[supply chain] “Our assemblers had to redesign the fixture every time the supplier changed their process — we should have locked down a dimensional interface spec and let them do whatever they want behind it.”
[organizational design] “The data science team is embedded in every product team's Slack and gets pulled into every meeting — we need a proper intake interface so they can do focused work instead of ad hoc triage.”
When This Archetype Applies¶
No catalog groundingNone of the structural conditions is currently represented by an accepted prime or domain-specific abstraction.
Diagnostic problem
Direct coupling exposes system parts to one another's internal structure, assumptions, volatility, or implementation details, allowing changes and failures to propagate too easily.
Show the applicability expression
Applicability expression1 distinct condition
groundedpartly groundedopen
1 condition, all required.
1Required in every casenumbered 1–1
These hold no matter which pattern applies.
Direct propagation exposure · open
Direct interaction allows changes, failures, assumptions, or implementation details to propagate across the connection.
This proposition-sized condition was conservatively reconstructed from the authored essence_one_line, compression_statement, components fields; the source file was not modified. In this condition set, the requirement is: Direct interaction allows changes, failures, assumptions, or implementation details to propagate across the connection.
Other requirements and context (1)
Why these sit outside the expression
Solution feasibility — it describes whether the intervention can work, not whether the diagnostic problem exists.
Solution feasibilityA stable interaction contract can be stated without exposing all internal structure.
This proposition-sized condition was conservatively reconstructed from the authored essence_one_line, compression_statement, components fields; the source file was not modified. In this archetype, the relevant feasibility condition is: A stable interaction contract can be stated without exposing all internal structure. It identifies something that must be possible or available for the intervention to be workable.
Coverage
0 of 1 conditions grounded · 1 open.
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 (8)
- Abstraction: Focus on core elements.
- Boundary: Defines system limits.
- Indirection: Introduces intermediary references.
- Information Hiding: Deliberately concealing internal facts behind a stable public surface to control dependencies.
- Interface: A bounded, rule-governed surface across which two systems exchange information or control while hiding their internals, letting each evolve independently behind a stable contract.
- Interoperability: Systems function together.
- Modularity: Breaks systems into smaller units.
- Translation Layer
Also references 7 related abstractions
- Change Management
- Complexity: Measures system intricacy.
- Composition: Arranges components into a cohesive whole.
- Coupling: Interdependence among subsystems.
- Function (Mapping): Relates inputs to outputs.
- Relation: Describes associations or dependencies.
- Representation: Model complex ideas.
Variants¶
Narrower or domain-specific specializations that share this archetype's core structure. Recognized variants are established; candidate variants are provisional.
Adapter-Mediated Decoupling · implementation variant · recognized
Reduce direct coupling by inserting an adapter or translation layer between incompatible or changing systems.
Conformal Anchor Function Core Isolation · implementation variant · recognized
Mechanically isolate a conformal anchor from a dimension-sensitive functional core so interface deformation does not distort the core operation.
Establish A Friction Hierarchy So A Sliding Outer · implementation variant · recognized
Establish a friction hierarchy so a sliding outer constraint moves relative to an implant while the implant stays registered to an inner carrier for controlled deployment or recapture.
Localize An Independent Hydraulic Loop And Pump On · implementation variant · recognized
Localize an independent hydraulic loop and pump on an attachment and accept only electrical power from the host.
Loosely Coupled Finish Layer With Interconnected Vent Drain Channels · multifunctional physical interface variant · recognized
Insert a loose profiled interlayer between an adhered finish and a sealed substrate, using alternating channels and cross-openings to vent and drain both interfaces while preventing shear transfer to the substrate.
Selective Multiphysics Interface Coupling · implementation variant · recognized
One interface positively transfers a required load or signal mode while materially interrupting a different unwanted physical transmission mode.
Crowding-Decoupled High-Loading Mixed State · high loading interface decoupling variant · recognized
Weaken nonessential coupling at crowded internal interfaces so a functional dispersed phase can reach high packing density without locking the composite.
Operator-Feel / Physical-Actuator Decoupling · simulated interface decoupling variant · recognized
Decouple the operator's feel simulator from the physical actuator and coordinate regenerative and hydraulic paths behind the simulated interface.
Acquisition–Deposition Stage Decoupling · stage rate decoupling variant · recognized
Keep material acquisition at a stable rate while a downstream buffer or transfer interface independently changes deposition trajectory and speed.
Editorial Notes¶
Problem Classification¶
Classification: Composition, Interface & Interoperability Failure → Leaky Contracts & Failed Substitutability
Problem kernel: component internals leak across an absent stable contract
Rationale: Both reviewers identify the same defect: without a stable representation-independent interface, implementation details leak across the boundary and force broad redesign when either component changes. Coupling topology is nearest when connection strength, direction, impedance, or an absent bridge is primary; here the components connect, but their contract fails to hide internals and support substitution.
Boundary considered: Composition, Interface & Interoperability Failure → Coupling, Topology & Transfer Mismatch
Why this classification prevailed: Leaky contracts expose undocumented internals and defeat independent replacement; coupling mismatch concerns whether viable parts are connected with the right path, direction, intensity, or impedance.
Review outcome: Reconciled after independent review; high confidence.