Skip to content

Interface Mismatch

Origin domain
Engineering & Design
Subdomain
systems architecture → Engineering & Design
Also from
Computer Science & Software Engineering, Biology & Ecology, Organizational & Management Science
Aliases
Architectural Mismatch, Interface Contract Mismatch, Seam Mismatch, Boundary Contract Mismatch
Related primes
Interface, Compatibility, Interoperability, Dependency

Core Idea

Interface mismatch is the failure pattern in which two systems that can each work on their own cannot compose because the contract exposed by one side does not satisfy the contract required by the other. The mismatch is localized at a required exchange seam: an output has the wrong type, unit, timing, tolerance, protocol, authority, or completeness for the receiver. The limiting case is a handoff that must exist but has never been designed.

The diagnostic value lies in relocating blame. The producer and receiver may each be locally competent; improving either one's internal performance need not repair the joint result. The defect lives in the relation between their contracts.

Broad Use

  • Software: an API returns a valid payload whose schema or units differ from what a client expects.
  • Physical systems: two sound components use incompatible connectors, tolerances, voltage levels, or impedance.
  • Biology: a signal is produced but the target lacks a compatible receptor or transport pathway.
  • Organizations: one team delivers evidence, authority, or work products in a form the receiving team cannot absorb.
  • Institutions: jurisdictions, classifications, or approval rules leave a required transfer without a recognized path.

Clarity

Interface mismatch is narrower than incompatibility in general. The entities must need to compose through a designated seam, and the failure must be traceable to a gap between what one side offers and the other requires. It is not an interface itself, nor does it require either side to be globally defective.

Manages Complexity

The abstraction replaces an open-ended search for weak components with a contract comparison: identify the producer, receiver, offered contract, required contract, and the smallest unsatisfied clause. Repair can then target the producer, the receiver, the shared contract, or an adapter at the seam.

Abstract Reasoning

The key move is counterfactual localization. If both systems remain functional when separated but fail when joined, inspect the interface before redesigning their interiors. The mismatch also predicts reciprocal blame: each side can truthfully claim conformance to its own local specification while the composition still fails.

Knowledge Transfer

The adapter pattern in software, a mechanical coupling, a receptor pathway, and an organizational handoff all solve the same structural problem: translate, renegotiate, or standardize the seam so the offered contract satisfies the required one.

Example

A pilot team produces a favorable evaluation and a polished demonstration. The operating organization requires a budget owner, procurement vehicle, support model, and accountable receiver before it can adopt anything. Both systems work locally, but the pilot's output contract does not satisfy the absorber's input contract. Running a better pilot leaves the mismatch untouched.

Relationships to Other Abstractions

Local relationship map for Interface MismatchParents appear above the current abstraction, mutual partners to the right, and children below. Node labels state whether each abstraction is prime or domain-specific; colors identify relation types.Interface MismatchPRIMEPrime abstraction: Interface — is part ofInterfacePRIMEDomain-specific abstraction: Ecosystem Mismatch — is a kind ofEcosystemMismatchDOMAINDomain-specific abstraction: Pilot Purgatory — is a kind ofPilot PurgatoryDOMAINDomain-specific abstraction: Refused Bequest — is a kind ofRefused BequestDOMAINDomain-specific abstraction: Resource-Typing Mismatch — is a kind ofResource-TypingMismatchDOMAINDomain-specific abstraction: Responsive-Layout Breakage — is a kind ofResponsive-Layo…DOMAINPrime abstraction: Shared-Interface Constraint Conflict — is a kind ofShared-Interfac…PRIME

Current abstraction Interface Mismatch Prime

Parents (1) — more general patterns this builds on

  • Interface Mismatch is part of Interface Prime

    A rule-governed exchange surface is the internal locus at which an interface mismatch's offered and required contracts fail to align.

Children (6) — more specific cases that build on this

  • Ecosystem Mismatch Domain-specific is a kind of Interface Mismatch

    Ecosystem Mismatch is the deployment-context species of Interface Mismatch, where an artifact's operating contract is not met by its surrounding complement system.

  • Pilot Purgatory Domain-specific is a kind of Interface Mismatch

    Pilot Purgatory is the organizational interface mismatch in which a demonstration system's outputs do not satisfy the absorber system's adoption contract.

  • Refused Bequest Domain-specific is a kind of Interface Mismatch

    Refused Bequest is the object-oriented interface mismatch in which a subtype's offered behavior fails the supertype contract clients are entitled to require.

  • Resource-Typing Mismatch Domain-specific is a kind of Interface Mismatch

    Resource-Typing Mismatch is the incident-command interface mismatch in which a requisition's offered class label fails the receiving task's capability contract.

  • Responsive-Layout Breakage Domain-specific is a kind of Interface Mismatch

    Responsive-Layout Breakage is the UI interface mismatch in which a rendered layout's offered spatial contract fails the transformed viewing context's requirements.

Hierarchy path (1) — routes to 1 parentless root

Not to Be Confused With

  • Interface is the rule-governed exchange surface; interface mismatch is a failure localized at that surface.
  • Compatibility is the positive condition under which entities compose without breakage; interface mismatch explains a specific failure of that condition.
  • Interoperability requires active coordinated function across systems; an interface mismatch can arise in a single handoff before interoperability is even attempted.
  • Dependency says one element relies on another; interface mismatch says the required reliance fails specifically because the exchange contracts do not align.

Notes

(New prime surfaced by repeated domain-source references to a missing structural parent; queued for cross-model editorial harmonization.)