Cognitive load is what matters
There are so many buzzwords and best practices out there, but let's focus on something more fundamental. What matters is the amount of confusion developers feel when going through the code.
Last document update: June 2026 . The logo image was taken from Reddit. This is a short version of the text. Toggle the switch to see a longer version. For AI agents | Chinese | Japanese | Spanish | Korean | Turkish Introduction There are so many buzzwords and best practices out there, but most of them have failed. They failed because they were imagined, not real. These ideas were based on aesthetics and subjective judgments. We need something more fundamental, something that can't be wrong. Sometimes we feel confusion going through the code. Confusion costs time and money. Confusion is caused
Explore this link on the map →saved by
- Amir
- Justin Wang
- Michelle Pan
- Kevin Wang
- Ratan Kaliani
- Freeman Jiang
- Aryan Naik
- Hamidah Oderinwale
- Maanav Khaitan
- Dron Hazra
- Sarah Pan
- Eden Chan
related reading
- GitHub - zakirullin/cognitive-load: 🧠 Cognitive load is what matters · GitHubgithub.com
- GitHub - zakirullin/cognitive-load: 🧠 Cognitive load is what matters · GitHubgithub.com
- The Grug Brained Developergrugbrain.dev
- Repeat yourself, do more than one thing, and... — programming is terribleprogrammingisterrible.com
- It's hard to write code for computers, but it's even harder to write code for humans · Erik Bernhardssonerikbern.com
- How Generative and Agentic AI Shift Concern from Technical Debt to Cognitive Debtmargaretstorey.com
- Time to Wall - by Julian Warszawski - Hundred Mondayshundredmondays.substack.com
- Thoughts on slowing the fuck downmariozechner.at
- Agentic Coding is a Trap | Lars Fayelarsfaye.com
- How Generative and Agentic AI Shift Concern from Technical Debt to Cognitive Debtsimonwillison.net
- fast | catherine juecatherinejue.com
- Coding Agents & Complexity Budgets | Lee Robinsonleerob.com