[{"data":1,"prerenderedAt":115},["ShallowReactive",2],{"content-cognitive-debt":3},{"id":4,"title":5,"articleTitleSource":6,"articleValid":7,"articleWarnings":8,"body":9,"comments":7,"date":100,"date_updated":8,"description":101,"extension":102,"icon":103,"image":104,"language":8,"meta":105,"navigation":7,"path":106,"publish-to":107,"readingTime":108,"seo":110,"stem":111,"titleEasterEgg":8,"titleLines":112,"topics":113,"translationKey":111,"__hash__":114},"content/cognitive-debt.md","Cognitive Debt","h1",true,null,{"type":10,"value":11,"toc":96},"minimark",[12,16,19,26,36,42,53,59,67,70,82,85,88],[13,14,15],"p",{},"Cognitive debt is the gap between the code and your understanding of it. As long as you write the code yourself, the debt barely accumulates: understanding comes along the way, line by line. But once someone else starts writing it — and today that someone is usually AI — the link between what's written and what's understood breaks. The code arrives finished, while the understanding has to be acquired through a separate effort. And the more code there is, the more of that effort it takes.",[13,17,18],{},"The good news is that you don't need to acquire all of it. Reading every line is a losing strategy by definition: it takes about as long as writing the whole thing yourself. Almost all understanding rests on just a few things — they cut cognitive debt the most, while everything else returns far less.",[13,20,21,25],{},[22,23,24],"strong",{},"Essence"," — the boundary of responsibility tells you more about the intent than a list of functions:",[27,28,29,33],"ul",{},[30,31,32],"li",{},"what the code is responsible for;",[30,34,35],{},"what it deliberately doesn't do.",[13,37,38,41],{},[22,39,40],{},"Boundaries"," — where the code ends and the rest of the system begins:",[27,43,44,47,50],{},[30,45,46],{},"what it talks to on the outside;",[30,48,49],{},"what it hides inside;",[30,51,52],{},"how it's meant to be extended.",[13,54,55,58],{},[22,56,57],{},"Contracts"," — what the code promises to whoever calls it:",[27,60,61,64],{},[30,62,63],{},"what it takes as input;",[30,65,66],{},"what it returns.",[13,68,69],{},"A short feedback loop with the agent helps you grasp all three:",[71,72,73,76,79],"ol",{},[30,74,75],{},"first, the agent describes the essence, boundaries, and contracts — its interpretation of the code;",[30,77,78],{},"then you freely explain, out loud and in your own words, everything you understood;",[30,80,81],{},"the agent replies again: it agrees, corrects you, and fills in what you missed.",[13,83,84],{},"A few rounds like this, and understanding comes together in minutes, not hours of reading. It works as a mini-exam where the agent is both examiner and cheat sheet: you don't read the code in full, but you understand what matters. That is control over cognitive debt at minimal cost.",[13,86,87],{},"P.S. This exercise is easy to wrap into a dedicated skill right inside the project and run from time to time — especially after large chunks of generated code.",[89,90],"file-artifact",{":expandable":91,"description":92,"filename":93,"icon":94,"name":95},"true","A reusable project skill for building understanding of unfamiliar code through a short feedback loop.","/cognitive-debt/SKILL.md","local:office-file-md","Cognitive Debt Check",{"title":97,"searchDepth":98,"depth":98,"links":99},"",4,[],"2026-06-02","What cognitive debt is, whether it is scary, and how to manage it.","md","streamline-ultimate-color:programming-user-chat","og-image.png",{},"/cognitive-debt","all",{"wordCount":109},344,{"title":5,"description":101},"cognitive-debt","1","AI, engineering","ItXZXsCi4ch2adxD_Zay-r8YHKwNCOqA3wkOAEsEtOg",1780404382766]