John Salvatier’s essay starts with a deceptively simple object: basement stairs. From far away, stairs are just boards, brackets, and screws. Up close, they become angles, warped lumber, saw guides, pilot holes, screw lengths, load, fit, safety, and the nasty fact that every local mistake changes the next operation.
The core claim is that this is not a quirk of carpentry. Reality is detailed all the way down, and most of the important detail is invisible until you have paid the local tuition.
Simple Picture
ELI5: imagine trying to draw a map of your bedroom from memory. You know the bed, desk, chair, and door. Then someone asks where every outlet is, which floorboards creak, where dust collects, which drawer sticks, and which corner catches morning light. The room did not become more complicated. You became more responsible for seeing it.
The beginner experiences detail as friction. The expert experiences detail as obviousness. Both are misleading. The beginner thinks the task is hostile because every step reveals an unanticipated snag. The expert forgets that those snags had to be learned.
Invisible, Then Transparent
Salvatier’s most useful distinction is between details that are invisible and details that are transparent.
Before you have noticed a detail, it is not merely unknown. It is hard to aim attention at. You do not know what kind of thing to look for. The warped board, the screw that follows its old hole, the stair angle that looks fine but feels unsafe underfoot: none of these appear in the beginner’s mental inventory.
After you have noticed the detail enough times, it becomes transparent. You no longer experience yourself as applying knowledge. You simply see the situation correctly. This is expertise at its most dangerous: the learned detail disappears into perception, and the expert mistakes trained seeing for raw reality.
This explains the stable misery in the expert-novice impasse. The novice cannot see the missing detail. The expert cannot remember how non-obvious the detail is. Both think the other is failing morally: the novice sees pedantry, the expert sees blindness.
Frames Are Built From Details
A frame is not mostly made of explicit beliefs. It is made of what feels worth noticing.
The details you have not learned are invisible, so they cannot challenge the frame. The details you have learned are transparent, so they feel like reality itself rather than learned attention. This is why people become intellectually stuck while still feeling empirical, practical, and open-minded. Their perception has already preselected the world that their reasoning will later justify.
Predictive processing gives the mechanism: perception is not passive intake but active rendering. Priors decide what counts as signal before conscious judgment gets involved. Trapped priors are what happen when the top-down model eats the very evidence that could have corrected it.
The garden version: a frame is a trained attentional economy. It pays some details and starves others. Getting unstuck is not primarily changing opinions. It is changing what can become salient.
Why Everything Feels Fiddly
Programming feels uniquely fiddly because programmers repeatedly enter unfamiliar domains: new libraries, runtimes, deployment surfaces, product constraints, users, teams, and failure modes. But the fiddliness is not unique to programming. It is what reality feels like before your perception has cached the local details.
This matters for technical debt. Debt is not merely messy code. It is unlearned detail embedded in a system: undocumented assumptions, implicit invariants, production edge cases, weird user behavior, deployment folklore. The codebase resists change because it contains more reality than the simplified model in your head.
It also matters for doing vs specifying. A specification fails because it cannot cheaply transmit all the transparent details living in the builder’s perception. The person delegating says “stairs”; reality asks for rise, run, lumber quality, tool behavior, human balance, and screw geometry.
Contact Beats Abstraction
The lesson is not anti-abstraction. Abstraction is how humans survive detail. The failure mode is abstraction that has not earned the right to compress.
Appreciative models are the correct first move when you do not yet know which details matter. They let the situation become richer before you prune it. Delete before optimize applies only after contact has revealed what is load-bearing and what is decorative. Premature deletion is just ignorance with taste.
This is why navigating complexity requires preparedness for surprise. The map is not useless because reality is mystical. The map is limited because the territory contains consequential details whose relevance will not announce itself until you are close enough to trip over them.
Feynman’s flower is the gentler version of the same insight. Explanation does not subtract beauty. It multiplies visible surfaces. The more detail you can perceive, the more world there is.
The Humility Detail Forces
Detail humiliates fake mastery. It reveals that “I understand the concept” and “I can make contact with the object” are different achievements.
This is especially useful when encountering someone smart who seems wrong. The easy move is to identify the conclusion you reject. The harder move is to ask: what details are salient to them that are not salient to me? Their frame may be distorted, but it is probably not made of nothing. It may be built around details your own frame has filtered out.
This is not relativism. Some people are wrong because they are missing details. But if reality is more detailed than your model, then disagreement is often a perception problem before it is an argument problem. Feedback works only when the pipe can carry the relevant detail.
Common Misread
The dimwit take is “everything is complicated, so nobody knows anything.”
The midwit take is “experts know the details, so trust experts.”
The better take is that expertise is trained perception, not possession of reality. Experts see details novices miss, but they also become blind to the learning path that made those details visible. The disciplined move is double: respect local detail, and keep looking for the details your current frame cannot yet render.
Main Payoff
Getting closer to reality means becoming available to more detail without drowning in it. The goal is not to notice everything. That is impossible. The goal is to notice which previously invisible details change how you think, act, build, and judge.
Frames harden when invisible details stay invisible and transparent details masquerade as reality. They soften when you deliberately seek the details your current perception has no slot for: the material snag, the user’s confusion, the body’s felt resistance, the expert’s exasperation, the novice’s hidden premise, the tiny flower structure that turns a pretty object into a world.
If you want to stop being stuck, do not merely change your mind. Change what your mind can notice.
References:
- John Salvatier, Reality has a surprising amount of detail, 2017
- LessWrong linkpost, 2017
- Simon Harris, excerpted link note, 2023