Cognitive Scaffold

Preparing your thinking workspace

arrow_back_ios_new
MENTAL MODEL · M9899

Abstraction Consistency Principle

Abstraction Consistency Principle
SystemsmediumSystems Theory
Included
account_tree

Updated 2026-08-15

Loading revision record…

INTRODUCTION

English translation pending.

CORE DEFINITION

The principle holds that each layer of a system should operate at a single, consistent level of abstraction, with its own vocabulary and contracts, and that mixing granularities within one layer creates confusion and coupling. It is a corollary of separation of concerns and single responsibility, and it explains why abstraction leaks are so costly: a leak forces a caller to know about a level it should not. The qualification is that consistency must serve comprehension rather than hierarchy for its own sake, since an intermediate layer with no distinct concept adds indirection without clarity.

SCAFFOLDING EFFECT

psychology

Reduce cognitive load

- Fix the level: state the abstraction level of the unit you are writing before adding anything. - Expose contracts: have callers depend on the layer's own vocabulary rather than its internals. - Audit the leaks: search for cross-layer names, such as database columns surfacing in business logic.

anchor

Anchor fast decisions

A reader builds a mental model from consistent cues, so when every element in a layer operates at the same granularity, one model explains the whole layer. Mixing levels breaks that model, because the reader must switch between registers and cannot predict where the next detail will appear. Coupling follows: code that reaches across levels depends on internals it does not own, so any change below propagates upward. Keeping levels consistent confines change to one layer, which is why the discipline pays off as maintenance rather than as elegance.

MINIMUM ACTION

In progress 0/1

Practice this model in one real situation:

Check to track your progress (stored locally)
Learning progress0%
account_treeGenealogyexpand_more
menu_bookReferencesexpand_more

Source support: Explicit

  • link
    en.wikipedia.orghttps://en.wikipedia.org/wiki/Abstraction_(computer_scienceZH · Explicit
    verified

RELATED MODELS

Related model

Wirth's Law

Wirth's law is an adage on computer performance which states that software is getting slower more rapidly than hardware is becoming faster.

arrow_forwardRelated model

Hyrum's Law

An application programming interface (API) is a connection between computers or between computer programs. It is a type of software interface, offering a service to other pieces of software. A documen

arrow_forwardRelated model

Coriolis Force

The Coriolis force is an inertial-force term needed to describe motion in a rotating reference frame, involving the cross product of frame angular velocity and relative object velocity.

arrow_forward