Principle of Least Surprise / Clever Abstractions
Kind: tension
Record: tension:clever-abstractions-principle-of-least-surprise
Canonical: Schema
"principle-of-least-surprise" (contracts-core layer) is traded against "Clever Abstractions" (contracts-core layer) — a principle cannot be scope-separated from a quality, metric, or cost it competes with; resolve by measuring "Clever Abstractions" and choosing an explicit operating point.
Listed in Tensions, after Intent-Revealing Interface / Concise Naming and before Database Normalization / Read Performance.