CONCEPT
The Comprehension Gap
The novel cognitive burden produced when AI generates code the builder evaluates without having written — the structural disconnection between output competence and the understanding of how the output works.
When a developer writes code by hand, she constructs a mental model of the code as she writes it — a model that includes not just what the code does but why it does it that way, what alternatives were considered, and what assumptions underlie the implementation. This mental model is the foundation of testing, debugging, and maintenance, because effective work on a system requires understanding its failure modes, boundary conditions, and embedded assumptions. When the AI generates the code, the builder may know what it does without knowing how it does it or why it does it that way. The understanding gap is invisible while the system works and becomes urgent the moment it fails — at three in the morning, under production pressure, with the builder trying to reconstruct a mental model the original act of building should have produced as a byproduct and instead bypassed.
In The You On AI Field Guide
The comprehension gap is the AI-era signature