Cognitive Scaffold

Preparing your thinking workspace

arrow_back_ios_new
MENTAL MODEL · M2076

Hyrum's Law

Hyrum's Law
SystemsHigh supportComplexity Science
Included
account_tree

Version 1.0.0 · Updated 2026-07-30

CORE DEFINITION

“When an API has enough users, what you promise in the contract doesn't matter: all observable behaviors of your system (even bugs or side effects) will be depended on by some users.” -

SCAFFOLDING EFFECT

psychology

Reduce cognitive load

The curse of implicit dependencies. - This explains why reform is so difficult. You think you're just fixing a “bug,” only to find that this “bug” is not only regarded as a “feature” by employees but also becomes a core pillar of business processes. In complex systems, there is no “harmless change.” Any status quo (even a bad one) is the foundation on which some ecosystem survives.

anchor

Anchor fast decisions

Hyrum's Law: When an API has enough users, the behaviors you promise in the contract matter less than the behaviors that are actually depended on in practice—any observable output or side effect will be depended on by someone, and thus cannot be safely changed.

MINIMUM ACTION

In progress 0/4

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

RELATED MODELS

Related model

Grokking

A delayed-generalization phenomenon in machine learning: test performance can remain poor long after training data have been fitted, then improve substantially.

arrow_forwardRelated model

Panarchy

A framework describing how complex ecological and social systems evolve through adaptive cycles of exploitation, conservation, release, and reorganization at interacting scales.

arrow_forwardRelated model

Candlemakers' Petition

Bastiat’s fictional petition to block sunlight satirizes trade protectionism.

arrow_forward