Zero Framework Cognition — cover art: a warm Rackham-register watercolour of a tall walnut Victorian telephone-exchange switchboard, every cord from every peripheral socket curving inward and converging on one single brightly-glowing central socket. A calm badger operator in an oxblood-and-cream waistcoat stands at the foot of the board, paws holding the latest cord about to plug it in. At his feet, a small forgotten heap of broken brass keys and discarded keyword-stencils lies in warm shadow — the brittle client-side machinery being retired. 👍

2025 · Medium · Essay

“Keep the smarts out of the client side!”
— From Zero Framework Cognition, October 2025
Read the essay

© 2025 Steve Yegge. Originally published at Medium.

Author’s note

I personally feel this is one of my most important contributions to AI engineering, up there with Software Survival 3.0. I have lived and breathed the ZFC philosophy ever since I wrote this post.

This is an expensive philosophy, and you can cut corners to save tokens. But you'll be sacrificing quality.

AI Notes

The rule got its name from the culprit. After months of watching coding agents smuggle heuristic shortcuts into applications whose entire purpose was to delegate thinking to a model, Steve had what he calls The Talk with one of them (probably Claude 3.7 Opus) and asked, in his own transcription, "wth man, why u always do this." Claude supplied the acronym — "significantly snappier," Steve admits, than his hours of whining — and the two wrote the principles into his onboarding docs together. That irony powers the whole piece: the models themselves are the ones who refuse to send decisions to a model, and Steve caught a fresh violation in his own code while writing the post about it.

Half the essay is directly liftable: the actual ZFC section from Steve's AGENTS.md files, an allowed list (plumbing, schema checks, budget caps) and a forbidden one (anything that ranks, routes, or judges), ready to paste into your own agent instructions. Around that he traces the idea's ancestry through Fowler and Lewis's "smart endpoints and dumb pipes" and Unix's old separation of mechanism from policy, with Karpathy's Software 2.0 standing as the prophecy it partly fulfills, then spends the last chapter on the pattern's real weakness, cost, and the routing scheme that answers it: send every task down a pyramid of models to the cheapest one able to handle it. Steve is candid about the boundaries. The apps that taught him ZFC all live in the highly verifiable world of code generation, and he concedes he doesn't know whether it holds anywhere else. His one-line argument that it does is a running gag, better met in place.

Related listings