The real distinction is always-loaded versus queried-on-demand. Wanting memory is correct; the error is answering it by injecting more text into every session instead of letting the AI agentAn AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.Full definition → search a store when it needs one.
The bloat had stopped working before anyone noticed. A 46KB memory index exceeded what the agent harnessThe scaffolding around a model that turns it into a working agent — the loop, the tools it can call, and the rules for when to stop.Full definition → would inject, so the back half was silently dropped each session — a file steering nothing while still costing tokenThe chunk of text a model reads and writes in — roughly three-quarters of a word — and the unit AI usage is billed in.Full definition →.
Standing instructions get injected at session start, which puts the practical ceiling around 200 lines per file. Past that, more text buys worse adherence rather than more knowledge.
Terms in this piece · Glossary
agent skill — A reusable instruction file that teaches an agent how to do one job well — the procedure, the tools, and what counts as done.
AI agent — An AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.
agent harness — The scaffolding around a model that turns it into a working agent — the loop, the tools it can call, and the rules for when to stop.
token — The chunk of text a model reads and writes in — roughly three-quarters of a word — and the unit AI usage is billed in.
Why it matters
Argues that agents should store learned lessons as pull requests to shared, code-reviewed agent skillA reusable instruction file that teaches an agent how to do one job well — the procedure, the tools, and what counts as done.Full definition → files instead of private memory — private memory accumulates noise and makes agents dumber over time, while reviewed skills stay sharp and auditable.
Key quotes
“A memory with no budget is not a brain, it is a landfill.”
“Hard limits on memory force an AI agent to distill what actually matters. Enforced scarcity is the mechanism that creates focused, useful long-term memory instead of bloated, useless context.”
aidecipher
“The default behavior of Claude Code is, when you start a session, it injects the full claude.md, and that is why we want to keep the claude.md ideally under 200 lines.”
Simon Scrapes
“the longer you let Claude's context clog up, the dumber it gets”
articleFilesystem-Based Memory for LLM Agents: Organization, Evolution, and SustainabilitySizhe Zhou, Sheldon Yu, Hui Wei, Junda Wu, Siru Ouyang, Yizhu Jiao, Shijia Pan, Julian McAuley, Yu Zhang, Tong Yu, Jiawei Han
postAgent Memory Architecture GuideAkshay 🚀
videoTurn 10,994 Notes Into Memory - Paul Iusztin, Decoding AI & Louis-François Bouchard, Towards AIAI Engineer