FrameworkSimon Willison

Agent Speed Creates Cognitive Debt

The product-builder skill underneath modern coding agents is not raw generation. It is preserving enough understanding to participate in the system after the agent moves fast.

Sources used3 references for this edition
  1. 01Digg on Geoffrey Litt quizzing himself on agent changes
  2. 02Simon Willison on “understand to participate”
  3. 03AI Engineer World’s Fair session listing
The read

The clearest July 2 signal came from Geoffrey Litt’s framing, echoed by Simon Willison: understand to participate. Digg surfaced Geoffrey’s practice of having coding agents quiz him on changes and building small “micro-worlds” to understand what happened. Simon’s notes sharpen the point with the phrase cognitive debt. The practical shift is that agent speed can now outpace human comprehension unless teams build review and explanation into the loop.

So what

Code that ships faster but leaves the team less able to reason about it is not durable leverage. The hidden cost shows up later in slower debugging, weaker review, fragile handoffs, and fear of touching agent-authored paths. Product builders need workflows that keep understanding compounding alongside output.

Use this

Add an understanding stage to agent-heavy coding work. Trigger: any change large enough that you would struggle to re-derive it from memory. Context: diff, touched systems, tests, and the agent’s rationale. Tools: agent-generated quiz questions, targeted walkthroughs, disposable repro apps or fixtures, and architecture notes. Verifier: a human can explain the change, predict failure modes, and modify it safely. Budget: cap change size before mandatory explanation. Artifacts: quiz answers, micro-world repro, and a short “why this works” note. Stop condition: the reviewer can participate in the next iteration without treating the diff as magic.

Put it to work 12 minutes

Evaluated context pack

Take one agent-authored change this week and ask the agent to produce five questions a reviewer should answer before approving it. If the team cannot answer them quickly, the change is under-explained.

Your turn

Use the task above. Record the result and anything you still need to check.

Check your work

Mark only what you have checked. You can save unfinished work.

Your draft stays in this browser. No account needed.

Keep Going