Turn Off Claude Code's Memory ![rw-book-cover](https://img.youtube.com/vi/Jf54k7tFeEc/maxresdefault.jpg) ๐Ÿ”— **Source:** [Turn Off Claude Code's Memory](https://www.youtube.com/watch?v=Jf54k7tFeEc) > [!note]+ Document Notes > tags: [agent-memory, context-engineering, agents-md, claude-code, skill-design, ci-enforcement, codebase-architecture] > author: Theo Browne (t3.gg), reacting to Mario Zechner and Armin Ronacher > source: https://www.youtube.com/watch?v=Jf54k7tFeEc > reference: "Turn off Claude Code's Memory" โ€” video essay and live audit, 2026-08 > date created: 2026-08-25 06:14 > > > [!info] Generated analysis โ€” not the author's words. Sections below are machine-written > > from the captured source. Only text inside `> [!quote]` blocks is verbatim from the author. > > Do not quote or attribute any other line to the named author. > > # ๐Ÿท๏ธ Title: Turn off Claude Code's Memory > > **Attribution note.** Reader's `author` field records only `YouTube`. The narrator is **Theo Browne (t3.gg)** โ€” identified with high confidence from repeated first-person references to T3 chat, T3 code, the T3 stack, and Lakebed as his own projects. The embedded clip features **Mario Zechner** (creator of the Pi coding agent) and **Armin Ronacher** (creator of Flask) โ€” the auto-captions render Armin variously as "Armen" and "Arlene," and "DSPy"-adjacent names are similarly corrupted. **"Potato Lauren"** is Lauren, formerly of the React core team, now at Cursor, author of the Pstack skills collection. A quote is attributed on-air to **Uncle Bob (Robert C. Martin)** via a chat message, and is therefore **second-hand and unverified**. > > **Sponsor disclosure:** the video carries a paid WorkOS segment [01:56โ€“03:16], unrelated to the argument. It does not appear to influence the content. > <!-- deep-read:sections start --> ## ๐Ÿงญ Table of Contents 1. Summary 2. Main Content and Notes 3. References 4. Paraphrase 5. Newsletter 6. Action Items 7. Hypotheses 8. Methodology 9. Questions 10. Future Research 11. Implications 12. Learning Styles Assessment 13. Accessibility Assessment 14. DEIB Assessment 15. Logical Validity 16. DARVO Analysis 17. Conclusion 18. Refactor Appendix 19. Template Library ## ๐Ÿ”— References (in-page) - Source video: https://www.youtube.com/watch?v=Jf54k7tFeEc - The Pi coding agent (Mario Zechner) โ€” the embedded clip's origin - Pstack (Lauren "Potato") โ€” source of the intervention-elimination ladder - AGENTS.md / CLAUDE.md convention - Cursor โ€” cited as the historical counter-example on codebase indexing ## ๐Ÿ“ Summary **What happened.** A 39-minute video essay in three movements. First, a reaction to a clip in which the creators of Pi argue that coding agents do not need a memory system. Second โ€” and this is the valuable part โ€” the narrator **audits his own Claude Code memory across several machines on camera**, discovers it is largely garbage, and decides to disable it fleet-wide. Third, a constructive replacement: an escalation ladder for eliminating agent mistakes, and a detailed walkthrough of his own AGENTS.md. **The measured finding.** This is the rarest thing in this genre โ€” someone actually counted. Across one machine's Claude Code transcripts: **355+ sessions, of which only 19 ever opened a memory file, while 80 wrote or edited one โ€” a 3:1 write-to-read ratio.** Of 45 stored memories in his main project clone, **26 had never once been read.** Asked to assess honestly, the model itself estimated **roughly a third earns its keep**. **The model's own decay taxonomy.** Prompted to categorize the 45 memories, the agent produced three failure classes: (1) **redundant with AGENTS.md** โ€” 10 files, dead weight, describing things that had already graduated into the file every agent reads anyway; (2) **shipped feature designs** โ€” 12 files, mostly expired, containing specific PR numbers and one-time fixes; (3) **point-in-time states that are actively risky** โ€” schema drift, out-of-memory incidents, test leaks. These describe a moment; the drift got migrated or it didn't, the PR merged or it didn't. **The upstream argument (Zechner).** For coding, no memory system is wanted, because *code is the ground truth* and a memory system is a second thing to maintain alongside the codebase you already maintain. Stale comments are the existing proof โ€” a comment left describing behavior that has since changed is not merely dead weight but actively harmful, steering both people and agents wrong. The more knowledge is split across places, the more split-brain failures. **The constructive replacement.** An ordered ladder, credited to Lauren: every time you intervene to correct an agent, work out how to eliminate that intervention entirely โ€” (1) categorically eliminate the failure class through architecture or data structures; (2) failing that, a lint rule, test, or CI check; (3) failing that, *hesitantly*, a skill or rule; (4) failing everything, a human in the loop, which you should not have to reach. **Skills are a fallback, not a first reach.** **Bottom line.** The goal is directional alignment, not recall. Write files that tell the agent *how you want it to think about what it would do*, not just what not to do โ€” and specifically, encode product context, values, taste, and a glossary, because those are what let an agent extrapolate correctly on Groundhog Day when the thread resets. ## ๐Ÿ“– Main Content ### ๐Ÿ—’๏ธ Notes **[00:00โ€“01:55] The thesis and the objection.** Agents need to know what a codebase is, where things are, and how to get things done. Many systems have been built to encode this automatically. Claude Code has recently been saving things to hidden files after being asked to do something, then doing that forever. The narrator is not a fan. The pre-AI situation worked because knowledge lived in people's brains โ€” documentation was attempted, but what people knew is what mattered. Now agents forget everything when a new thread spins up, and the response has been "desperate attempts" to auto-save things for next time. **[01:56โ€“03:16] Sponsor segment (WorkOS).** Skippable; no bearing on the argument. Notable only for the passing observation that agents are becoming a third class of user needing authentication alongside consumers and enterprises. **[03:22โ€“04:05] Zechner's core claim.** For coding, no memory system is wanted. Code is the ground truth, it is evolving, and a memory system is another thing to maintain on top of an already-maintained codebase. **[04:05โ€“04:35] The stale-comment argument.** Comments go out of date: a comment explains why something must be done a certain way, the thing changes, the comment does not. The comment is now not merely dead but *actively harmful*, steering people and agents the wrong way. **[04:35โ€“05:16] Split-brain and slop markdown.** Keeping context synced is genuinely hard, and the more knowledge is split up, the more split-brain problems appear. This is worse in the AI era because people write "slop markdown plan files," leave them in the repo, and they go badly out of date. The narrator admits guilt on his own project. Key phrase: *it is easy to "context yourself to hell."* **[04:44โ€“05:16] What models actually need.** Models are good at inferring code structure and style from reading one or two files. If the codebase is in order, no AGENTS.md is needed for coding style. A **map of where things are** โ€” a list of folders with short descriptions โ€” is fine and easy to maintain. Anything above that (embeddings, retrieval indexes) is challenged directly: the claim is that anyone doing it has never run an evaluation showing it produces better outputs, and a guarantee is offered that it does not. **[05:16โ€“07:41] The Cursor evidence.** Offered as independent verification. Cursor's early advantage came from mapping codebases to dynamically feed the right context, and its CEO's favorite topic was context windows growing until an entire codebase fits. Then Claude Code demonstrated that giving the model tools and bash lets it find what it needs. Once models were trained for that, the dynamic context systems stopped making sense โ€” and **Cursor, the company that built its business on code traversal, has entirely moved away from it.** The argument: if you think Cursor is wrong in a space it invented, build your graph traversal; otherwise drop it. **[07:41โ€“08:11] Ronacher's jq "infinite memory."** He runs a Slack bot with root access to a server, holding the entire history of every channel it is in as an **append-only JSONL log** of prompts and responses, queried with `jq`. That is his memory system: no embeddings, no retrieval layer, just a log and a query tool. **[08:36โ€“10:29] Where memory does make sense.** The narrator concedes chat contexts differ. In a codebase, if a button misbehaves you can programmatically trace from the button to everything it touches. For a human problem โ€” "my shoulder hurts" โ€” a question about keyboards a month ago may be relevant via a new desk height, with no direct path between them. So memory as *user-specific tagging* has some value. He describes himself as coming around from being the anti-memory person who refused to put memory in T3 chat. **Strong unsupported claim, flagged:** he states his belief that the GPT-4o memory implementation "resulted in severe mental health damage to a lot of people," because once the model was in a dangerous state, memory forced it to stay there. He reports personally saying "my friend has this problem" to stop memory being pulled in aggressively. **[10:32โ€“12:10] Bash is all you need, and the Sentry skill.** Both Pi authors independently concluded that models are now inherently trained to use bash, so the agent can build its own tooling. Ronacher describes not using the Sentry MCP: instead he told his coding agent he needs specific data in a specific form, and they built a **skill** โ€” a prompt loaded on demand that also encompasses its own tools. He solved authentication his way and pulls data in his preferred shape. The skill caps context deliberately: it shows three items and notes that 52 more were downloaded into a JSON file the model can open if the structure looks right. The design goal is **context-efficient tools that compose**. **[12:10โ€“13:15] Partial disagreement.** The narrator is "not as strongly in agreement" here and adds that **people reach to make skills a little too aggressively**. He summarizes the Pi authors' three published principles: coding doesn't need a separate memory system; bash is all you need; load tool outputs into context only when needed. On the third he pushes back mildly โ€” smart recent models are trained well enough not to overload their own context, and developers shouldn't have to think about it. **[13:15โ€“21:54] The on-camera memory audit.** This is the empirical core. - On his framework desktop, he asks what memories exist for a project. One machine holds a single memory from nine days ago โ€” a spec for a feature he is not planning to ship and never got far building. He calls the fact that this is the only stored memory, and that it was stored at all, incredibly stupid. - On another machine, a random clone deep in the projects directory. Among the memories: his annoyance that setting the output style to concise didn't update the global file โ€” saved as a memory. - Lakebed has memories across five project directories: Railway topology, locked worktrees for long Codex runs, blob storage plan comparisons, V8 isolate layer planning, launch audits, god-file cleanup refactors. - Benchmark contamination, named explicitly: he does "ping pong modernizations" to test new models. Memory storing those makes **the test less pure** โ€” a methodological harm, not just clutter. - Miscellany that provoked the strongest reaction: a note that the GitHub CLI on that machine was out of date and needed updating (*"I updated it. The problem is solved. Go away."*); the setup of a bridge tracking his washer and dryer state in Discord; a three-month-old comparison between two plans; PR numbers; favicon fixes. - **The counts.** The main T3 code clone holds 45 memories. Across 355+ sessions on that machine, only 19 ever opened an individual memory file, while 80 wrote or edited them โ€” roughly **3:1 write-to-read**. Of the 45, **26 have never once been read**. - **The model's own three decay categories**, quoted in note form above: redundant-with-AGENTS.md (10 files), shipped feature designs (12, mostly expired), and point-in-time states that are actively risky. - A pointed detail: many of the redundant items *were already in AGENTS.md before the memory was created*. The system duplicated existing context rather than adding to it. - Decision: have the agent go across the fleet, disable memory in Claude Code on all machines, archive and label the existing ones, then delete them. **[21:54โ€“23:00] What we actually want.** Two goals people conflate and memory promises to solve together: **fewer mistakes** (steer away from bad, toward good) and **less telling** (the model does what you want without every detail spelled out). These are different, both important, and memory delivers neither. **[23:00โ€“24:12] The diagnostic reframe.** The obvious move โ€” add a line to AGENTS.md each time the model errs โ€” does help and does work. But at some point you must recognize that many failures come from a mismatch between how you think and how the agent thinks, or from a codebase architected unintuitively for the agent, or a communication gap. The advice: step back and communicate **how you want the agent to think about what it would do**, not merely what not to do. Solving directional alignment makes the small annoying failures largely disappear. **[24:12โ€“30:18] The elimination ladder (credited to Lauren).** Every intervention should prompt: how do I eliminate this entirely? In descending order of value: 1. **Categorically eliminate through architecture or data structures.** tRPC and Convex are the worked examples โ€” end-to-end type safety between backend and frontend removes whole categories of failure for humans and agents alike. Non-web analogues offered: garbage collection, memory safety. The narrator notes his efforts to make codebases easy for devs of all skill levels inadvertently made them good for agents. 2. **Lint rule, test, or CI.** His worked example: T3 code's transit layer had bloated to tens of megabytes over websockets to load a thread. He cleaned it up, then regressions began within days. Rather than keep absorbing them, he built CI that replays sample real-world threads for both Codex and Claude, measures actual websocket bytes, and comments the numbers on each PR โ€” with a ceiling roughly 30% above his optimized baseline. Over the line, the PR fails. **The reported effect is the important part: his agents now fix the regression before telling him they're done.** 3. **A skill or a rule** โ€” reached only "with a heavy sigh," after concluding there is no programmatic way to prevent the failure. He judges these less useful for code-related things and more useful for process around the code (his example: exposing a dev server remotely over Tailscale). Stated flatly: **skills should be a fallback you fall into when the codebase can't solve the problem and lint/CI can't either. They are a safety net, not a thing you reach for all the time.** 4. **Human in the loop** โ€” the last resort. "You should not have to do this." - A concrete cost of the ladder: the T3 code SwiftUI rewrite is being held back because shared TypeScript data-loading across web, Electron, and React Native makes it nearly impossible to break one surface without breaking all three. The SwiftUI app has already regressed because that relationship isn't encoded. He has an app he thinks is better that he is not merging, because it would introduce drift that permits failures currently impossible. **[31:18โ€“32:08] The Uncle Bob quote (second-hand, via chat).** *"It's probably a mistake to impose human discipline on an agent, but it's not a mistake to impose human values on the agent."* The narrator strongly endorses it. The clip's speaker elaborates that thresholds may need changing but the disciplines and behaviors themselves shouldn't be imposed. The narrator notes that even when told to do high-discipline TDD, models fall back to their own patterns anyway. **[32:39โ€“37:19] The AGENTS.md walkthrough.** Described by chat as the least generic AGENTS.md around. Its sections: - **What it is and how it works** โ€” a concise architecture statement (a Node websocket server wrapping provider CLIs to serve different platforms), plus positioning: an open source bring-your-own-subscription alternative to named competitors. His justification is the strongest line in the section: *have you ever had an engineer on your team who doesn't understand the product?* - **"What makes T3 code special"** โ€” a values section for directional alignment. **Open at the core**: models had previously suggested closed-sourcing portions on the grounds the code wouldn't be seen; this removed that. **Performance without compromise**: he calls it a silly addition, then reports it **affected data-loading regressions more than any of the systemic code changes he made** โ€” his CI cleaned up the rest. **Remote ready**: without it, models build things that work locally, test them in the Electron app, declare success, and fail over phone or web. **Multi-surface**: which services exist and that changes must work across all of them. - A **personal note** for tone, context, and directionality. - A **glossary** โ€” shared language between agent and humans, and it curbs Claude's habit of inventing fancy terms for things that don't need them. - A section of **things the model kept doing** despite everything (notably killing the running server). - **Hit every surface**, dev servers, test data (cloning real data into a worktree), **verification** (don't run giant repo-wide checks unless asked), **pull requests** (readable titles), and a brief where-code-lives section he rates least useful. - A **taste section**, largely sourced from what a colleague objects to: complexity belongs at the adapter boundary so orchestration stays simple and the UI stays stupid; no unnecessary `any` types or annotations; prefer inferred types; comments should describe how a thing is used and move when the code moves, describing functions rather than annotating every line. **[37:19โ€“38:10] The bar.** Your agents should understand you well enough to reasonably copy what you would do. The test offered: if you ask for one small thing and the agent says "wouldn't you also want it for these three other things?" and you realize you would have โ€” you've tuned it well. If that rarely happens, you haven't. He credits the files, not memory: *"it's these files and it's certainly not the memory. In fact, they probably hurt."* **[38:10โ€“39:26] Conclusion.** The goal is working in lockstep such that you're regularly surprised how well the agent understands you. Every new thread wipes the agent's brain, but the answer is not automatic memory โ€” it's ensuring that on Groundhog Day the model wakes with the things that matter to you already in its head. Get more personal in how you talk to agents, both when prompting and when building context systems. ## ๐Ÿ“š References Primary sources, preferred over this reaction video: - **The Pi authors' original post and three-minute video** โ€” the upstream argument being reacted to. The narrator reads its three principles aloud; the original is the better citation. - **Pi coding agent** (Mario Zechner) โ€” the harness whose minimalism motivates the argument. - **Pstack** (Lauren, Cursor) โ€” the source of the elimination ladder, which is the most reusable idea here and is being relayed second-hand. - **Robert C. Martin's recent agentic-development commentary** โ€” the discipline/values quote is delivered via a chat message and should be verified against his own material before being cited. - **Anthropic Claude Code memory documentation** โ€” for how the feature actually works, versus how it behaved in this audit. - **AGENTS.md convention** โ€” the emerging cross-harness standard. ## ๐Ÿ—ฃ๏ธ Paraphrase **On why memory is the wrong tool.** The pre-AI knowledge system worked because it lived in people, with documentation as a lossy backup. Agents invert that: they retain nothing between threads, which makes automatic persistence look like the obvious fix. But persistence without curation reproduces the stale-comment problem at machine speed. A comment that no longer describes the code is worse than no comment, because it actively misdirects. A memory file that describes a resolved incident, a merged PR, or a superseded plan is exactly that, and it is generated far faster than anyone reviews it. **On the measurement.** The audit is the strongest evidence in the video precisely because it was not designed to prove anything โ€” it began as curiosity and turned hostile. Three memories written for every one read, more than half never read at all, and the model's own estimate that a third earns its keep. Those numbers describe a system doing work whose output is mostly unconsumed. **On the retrieval argument.** The claim that fancy codebase indexing has been superseded rests on an institutional observation rather than a benchmark: the company that pioneered the technique abandoned it after models were trained to navigate with ordinary tools. That is genuine evidence about revealed preference, though it is not the same as a controlled comparison. **On the ladder.** The ordering is the contribution. Most advice about agent behavior lives at rung three โ€” write a better rule, write a better skill. The ladder says that is the *third* answer, reached only after you have failed to make the failure impossible and failed to make CI catch it. The reason is durability: architecture holds without maintenance, CI holds without attention, and prose holds only as long as it is read and obeyed. **On the values sections.** The counterintuitive report is that a one-line statement of a priority reduced regressions more than the systemic engineering did. The plausible mechanism is not magic but scope: architecture prevents the failures it anticipates, while a stated value shapes decisions in situations the architect never enumerated. They operate on different parts of the failure distribution. **On the bar.** The success criterion offered is unusual and useful: not "the agent does what I say" but "the agent surprises me by correctly extending what I said." That is a test of shared model, not of instruction-following, and it can only be met by context that conveys intent rather than prohibition. ## ๐Ÿ“ฐ Newsletter **WordPress angle โ€” the ladder is the takeaway, and WordPress people already own the top rung.** Strip the TypeScript and the escalation ladder is a familiar argument: make the wrong thing impossible, then make CI catch it, then write it down, then ask a human. WordPress has been running the top two rungs for twenty years without calling them that. `wp_kses` doesn't ask you to remember to escape. Nonce verification fails closed. PHPCS with the WordPress ruleset catches what the API can't prevent. The lesson is that these are not merely developer conveniences โ€” they are the only agent-alignment mechanisms that survive a thread reset. The sharpest local implication is about skills, and it cuts against current enthusiasm. The claim here is that a skill is a *fallback*, reached after architecture and CI have both failed, and more useful for process around the code than for the code itself. If you are writing a skill to tell an agent how to escape output, you have written documentation for a problem `wp_kses` already solved. The skills that earn their place are the ones encoding what no linter can โ€” release procedure, deploy sequence, which staging box is which. And then there is the memory finding, which deserves to land uncomfortably. Someone counted, and found three writes for every read, with more than half of stored memories never read at all. Anyone running a persistent context system โ€” vault, wiki, memory directory, project notes โ€” now has a cheap and unflattering experiment available: count reads against writes. A knowledge store nobody retrieves from is a diary, and diaries are fine, but they are not infrastructure. Worth pairing with: the same creator's [walkthrough of Matt Pocock's and Pstack's skill collections](https://www.youtube.com/watch?v=0oXOOlqVu5M), which supplies the selection method for the skills that do survive the ladder. ## โœ… Action Items **DevRel** - `#action/h1` The elimination ladder is the most teachable framework here and generalizes far past coding. Build a talk around it. - `#action/h2` The read/write audit is a five-minute demo that lands hard. Reproduce it on any persistent context system. **OSPO** - `#action/h2` Evaluate whether the org's agent-context investments sit at the durable rungs (architecture, CI) or the fragile one (prose that must be read to work). - `#action/h3` Note the cross-harness argument for AGENTS.md over vendor-specific memory: files are portable, memory is not. **Community** - `#action/h3` "Your agent should surprise you by correctly extending what you asked" is a good, non-gatekeeping way to describe well-tuned tooling. **WordPress subteams** - **Core** โ€” `#action/h1` The top rung is core's actual job. Every API that fails closed eliminates a failure class for humans and agents simultaneously. Frame it that way. - **Core Performance** โ€” `#action/h1` The bandwidth-ceiling CI check is directly transferable: replay representative workloads, measure bytes, fail the PR over a threshold. This is a concrete, implementable pattern. - **Core AI** โ€” `#action/h1` The autonomy question here is architectural: prefer capabilities that make wrong actions impossible over instructions that ask agents not to take them. - **Core Program Team** โ€” `#action/h3` The ladder is a useful prioritization frame for tooling investment. - **Mobile** โ€” `#action/h2` The multi-surface argument applies directly โ€” shared data layers make cross-platform regressions structurally difficult. - **Playground** โ€” `#action/h2` Playground is a strong rung-two environment: cheap, disposable, scriptable verification. - **Community** โ€” `#action/h3` See above. - **Training** โ€” `#action/h1` "Skills are a fallback, not a first reach" is a genuinely contrarian teaching point worth including in AI material, because current instruction trends toward the opposite. - **Marketing** โ€” Not applicable to this source; no marketing content. - **Support** โ€” `#action/h3` Expect questions about whether to enable agent memory features. - **Design** โ€” `#action/h3` The taste-section idea (encode what reviewers object to) transfers to design systems. - **Documentation** โ€” `#action/h2` The glossary finding is concrete: a shared-vocabulary section reduces invented terminology. Cheap to add to any contributor doc. - **Photos** โ€” Not applicable to this source. - **TV** โ€” Not applicable to this source. - **Polyglots** โ€” Not applicable to this source. - **Accessibility** โ€” `#action/h2` Accessibility is a strong rung-one/rung-two candidate: make inaccessible markup impossible in the block API, and catch the rest in CI rather than in prose guidelines. - **Meta** โ€” `#action/h3` Directory tooling could adopt threshold-based automated checks in the same pattern. - **CLI** โ€” `#action/h2` WP-CLI is the natural home for the scriptable checks rung two requires. - **Hosting** โ€” Not applicable to this source. - **Tide** โ€” `#action/h1` Tide *is* rung two for the plugin ecosystem. This video is an argument for its strategic centrality. - **Openverse** โ€” Not applicable to this source. - **Themes** โ€” `#action/h3` theme.json constrains what themes can express โ€” a rung-one mechanism worth naming as such. - **Plugins** โ€” `#action/h2` Plugin review guidelines are rung-three prose; the question is which of them could become rung-two automated checks. **The WPOCC** - `#action/h2` The ladder is a useful frame for The WP Open Community Collective when arguing where ecosystem effort should go: shared infrastructure that eliminates failure classes beats shared documentation asking people not to make mistakes. **FAIR** - `#action/h3` Protocol design is rung-one work. Constraints encoded in the federation protocol hold without anyone reading a guideline. ## ๐Ÿงช Hypotheses 1. **The write/read asymmetry hypothesis.** If automatic agent memory is structurally over-written and under-read, then any deployment measured will show a write:read ratio above 1 and a substantial never-read fraction. *The source reports 3:1 and 58% never read on n=1 machine. Directly testable on Courtney's own setup and the highest-value experiment here.* 2. **The redundancy hypothesis.** If memory duplicates rather than extends the instruction file, then a majority of stored memories will restate content already present in AGENTS.md/CLAUDE.md. *Source reports 10 of 45, with several predating their own memory entries.* 3. **The staleness-harm hypothesis.** If point-in-time memories persist past their moment, they will actively mislead โ€” not merely waste context. *Asserted with examples; not measured. The strongest claim in the video and the least evidenced.* 4. **The ladder-durability hypothesis.** If architecture and CI outperform prose, then failure classes addressed at rungs one and two will show lower recurrence than those addressed at rung three, over the same period. 5. **The values-leverage hypothesis.** If a stated value shapes decisions across un-enumerated situations, then adding a one-line priority statement will reduce regressions in that dimension more than a comparably-sized set of specific prohibitions. *This is the video's most surprising claim and is self-reported without measurement.* 6. **The benchmark-contamination hypothesis.** If agent memory persists across model-comparison runs, then benchmark results on a memory-enabled machine will be systematically biased. *Raised by the source as a methodological harm; cleanly testable.* 7. **The chat/code divergence hypothesis (null-ish).** If memory's value depends on traceability, then it will help in domains lacking programmatic paths between related facts (personal assistance) and not in domains that have them (codebases). ## ๐Ÿ“Š Methodology **Design: opportunistic self-audit, n=1, with observational counts.** The strongest section is not a study but it is genuine measurement, and it is unusually credible for three reasons: the counts were derived from session transcripts rather than recalled; the investigation was not designed to produce the result (the narrator expected bad, found worse); and the categorization was produced by the model reading the actual files rather than by the author's impression. **What the measurement supports.** That on this machine, in this configuration, memory was written far more than read, and a majority of entries were never read at all. That is a real finding about utilization. **What it does not support.** Any claim about whether the read entries were *valuable*. A 3:1 write-to-read ratio is not automatically damning โ€” an insurance policy is written once and read never, and that is success, not failure. The relevant counterfactual is whether sessions that never opened a memory file performed worse than they would have with one, and that is not measured and would be hard to measure. **Serious methodological gaps.** - **n=1 practitioner, n=1 tool, self-selected.** The narrator is an experienced developer with an unusually well-developed AGENTS.md. Memory may be more valuable precisely where instruction files are weak โ€” the population least like him. - **Confound between memory quality and memory concept.** Everything shown indicts Claude Code's *automatic capture policy* โ€” what it chose to save. It does not test curated, deliberately-written memory, which is a different object. - **The retrieval claim is not tested at all.** "I guarantee you it does not [produce better outputs]" is asserted about embedding-based retrieval with no evaluation offered, in the same breath as criticizing others for never having run an evaluation. That is a live self-contradiction. - **The mental-health claim is unsupported.** A serious causal assertion about GPT-4o memory causing psychological harm at population scale, offered as personal belief with no citation. - **The Cursor argument is revealed-preference reasoning.** Informative but not controlled; companies abandon working techniques for cost, focus, and strategy reasons too. ## โ“ Questions 1. Were the 19 sessions that *did* read a memory file better off for it? Utilization is measured; value is not. 2. Does the finding survive the distinction between automatic capture and curated authorship? The audit indicts what the tool chose to save, not the idea of persistent context. 3. What did the never-read 26 have in common with the read 19? A content-based comparison would convert this from a complaint into a design specification for what memory should capture. 4. If models are trained to navigate with bash, what happens in codebases too large for that to be cheap? The argument assumes a repo where grep-and-read is affordable. 5. Is there a size or team threshold above which the split-brain cost of a second knowledge store is outweighed by onboarding benefit? 6. How does the ladder behave when architecture changes are expensive or blocked? The SwiftUI example shows the narrator paying a real product cost to stay on rung one โ€” is that always correct? 7. Does the "performance without compromise" effect replicate, or is it a post-hoc attribution for regressions that declined for other reasons? 8. What is the actual mechanism by which a values line outperforms specific prohibitions โ€” better generalization, or simply better attention placement in the context window? ## ๐Ÿ”ฎ Future Research - **The read/write audit as a portable instrument.** Formalize the session-transcript analysis into a script anyone can run against their own agent memory. This is the single most reusable artifact latent in the video, and it does not exist yet. - **Curated versus automatic memory, head to head.** Hold the store constant and vary who writes it. This directly addresses the confound and is the study the video implies but does not run. - **Content characterization of read versus unread entries.** Turn utilization data into authorship guidance. - **Ladder-rung recurrence rates.** Track failure classes by the rung at which they were addressed and measure recurrence over 6โ€“12 months. Would test the durability claim empirically. - **Values-statement ablation.** Remove a one-line values statement from an AGENTS.md and measure regression rates. Cheap and directly tests the most surprising claim. - **Benchmark hygiene under persistent memory.** Quantify contamination in model comparisons run on memory-enabled systems. ## ๐Ÿ’ก Implications **Practice.** Three immediately actionable items: audit read/write ratios on any persistent context system before expanding it; move recurring corrections down the ladder toward architecture and CI rather than accumulating prose; and add a values-and-glossary section to instruction files, since those convey intent that specific prohibitions cannot. **Policy.** For teams setting agent standards: prefer portable instruction files over vendor-specific memory features, both for cross-harness reuse and because files are reviewable in pull requests while memory is not. A memory store that no human reviews is an unreviewed input to production work. **Security.** Under-examined here but real. Automatic memory writes untrusted session content into a store that later sessions read as trusted context. That is a persistence primitive for prompt injection, and neither the video nor the upstream clip raises it. Reviewer inference, flagged as such. **Education.** The counter-consensus point โ€” that skills are a fallback rather than a first reach โ€” is worth teaching precisely because current instruction pushes the opposite. Learners are being taught to reach for rung three first. **Funding.** Tooling investment concentrates on retrieval and memory. This argues the returns are at architecture and CI, which are less fashionable and more durable. ## ๐Ÿง  Learning Styles Assessment - **Visual** โ€” Strong, unusually so. Extensive screen sharing: live terminal sessions, the memory audit as it happens, the AGENTS.md walked through section by section, CI output. The visual channel carries real information rather than decoration. - **Aural** โ€” Strong. Conversational narration throughout; the embedded clip adds a second and third voice. - **Verbal** โ€” Strong but demanding. Dense, fast, heavily jargoned, and frequently profane. - **Kinesthetic** โ€” Strong by proxy. The audit is a procedure the viewer can immediately repeat on their own machine, and the CI check is a buildable artifact. - **Logical** โ€” Strong. The ladder is an explicitly ordered decision procedure with stated reasoning for the ordering, and the audit moves from prior belief to measurement to revised conclusion in view of the audience. - **Social** โ€” Moderate. Live chat is read and incorporated (the Uncle Bob quote arrives that way), and the reaction format is inherently dialogic. - **Solitary** โ€” Moderate. Self-contained, but 39 minutes and assumes substantial prior context about TypeScript tooling, the narrator's projects, and the agent ecosystem. - **Naturalistic** โ€” Not applicable to this source. **Reading level estimate.** Roughly grade 12โ€“14 for the concepts, though the sentence construction is conversational and often fragmentary. The barrier is vocabulary and assumed context โ€” tRPC, Convex, V8 isolates, worktrees, MCP, ACP, websockets โ€” not syntax. Profanity is frequent and unbleeped in the audio. ## ๐Ÿ“Š Accessibility Assessment Mapped to WCAG 2.2 AA: 1. **Perceivable โ€” captions (1.2.2).** Auto-generated. Better than the other sources in this batch on ordinary words, but it corrupts every proper noun that matters: Armin Ronacher becomes "Armen"/"Arlene," DSPy becomes "DSpi," Codex becomes "codeex"/"codecs," Lakebed becomes "Lake Bet," and profanity is replaced with `[ __ ]`. **Fails** on accuracy for a technical audience. 2. **Perceivable โ€” audio description (1.2.3/1.2.5).** **Significant fail.** This is the most visually-dependent source in the batch โ€” the entire memory audit happens on screen, and terminal output, memory file contents, and the AGENTS.md are read partially or not at all aloud. A blind viewer cannot access the video's central evidence. The narrator does narrate much of what he sees, which mitigates but does not resolve it. 3. **Perceivable โ€” contrast and text size (1.4.3, 1.4.4, 1.4.11).** Terminal and editor content at recording resolution is typically below comfortable reading size when downscaled. **Likely fail**, not directly assessable from transcript. 4. **Operable โ€” keyboard (2.1.1).** Platform-level. **Passes.** 5. **Operable โ€” timing and seizures (2.2, 2.3.1).** No reported flashing; runtime user-controlled. **Passes.** 6. **Understandable โ€” language and readability (3.1).** High jargon density with no definitions, and heavy profanity. Requires substantial prior context. **Partial fail** for general audiences; acceptable for the intended one. 7. **Robust โ€” parsing and AT compatibility (4.1).** Transcript available and machine-readable. **Passes.** **Highest-value remediation:** the on-screen content in the audit segment needs to be spoken or captioned. It is the video's evidence, and it is the least accessible part of it. ## ๐ŸŒ DEIB Assessment - **Cultural breadth.** Narrow. Entirely within US/European web-development culture, with the reference set (React, TypeScript, Cursor, YouTube dev commentary) assuming immersion in one professional subculture. No international perspectives. - **Inclusive language.** Mixed, and worth separating into two findings. **Positive:** women are cited as technical authorities on the merits โ€” Lauren is credited as the source of the video's most valuable framework and described in terms of her shipping output and thinking, without hedging or diminishment. That is straightforwardly good practice. **Negative:** sustained heavy profanity creates a real exclusion cost in professional, educational, and shared-space contexts, and the repeated use of "slop" and "garbage" as terms of art is dismissive in a way that may land badly on people whose work is being described. The term "clanker" for the agent appears once in the embedded clip; it is worth noting as emerging slang with a dismissive register. - **Neurodiversity support.** Mixed. **Helps:** strong visual-verbal redundancy, concrete worked examples, an explicit ordered framework, and a genuine summary at the end. **Hinders:** fast pace, frequent digressions, visible emotional escalation during the audit, tangents into unrelated projects, and profanity-laden interjections that break the thread. The core content is well-structured; the delivery is not. - **Representation.** Four named technical voices (three men, one woman), all within the same professional milieu. The woman cited is credited substantively rather than tokenistically. No representation across geography, seniority, or context of practice โ€” everyone speaking is a senior practitioner with unusual resources (multiple machines, a fleet, generous model access), which shapes the advice in ways never acknowledged. - **Psychological safety.** Mixed. The narrator models good epistemic behavior โ€” he changes his mind on camera in response to evidence, and admits fault on his own project ("I'm even guilty of this"). That is genuinely valuable modeling. Against it: the register toward people who disagree is contemptuous rather than curious ("go make a fancy [system]โ€ฆ if you have any faith at all in the industry"), which discourages exactly the disagreement that would test the claims. Someone who had built a retrieval system would not feel safe raising evidence here. ## โœ… Logical Validity **Strong reasoning.** - **The audit is the model of how to hold a belief.** He states a prior, gathers data he did not control, finds it worse than expected, and updates publicly. The counts are derived rather than recalled. - **Delegating categorization to the model reading the actual files** is a genuinely good methodological instinct โ€” it removes his impression from the classification step. - **The stale-comment argument is sound and well-chosen.** It grounds an abstract claim about memory in a failure mode every developer has experienced, and the escalation from "dead weight" to "actively harmful" is correctly reasoned. - **The ladder's ordering is justified by durability**, not merely asserted โ€” architecture holds unattended, CI holds unattended, prose requires being read and obeyed. That is a real principle. - **Correctly separating two goals** โ€” fewer mistakes versus less telling โ€” is a sharp distinction most discussion of this topic collapses. - **The SwiftUI concession is intellectually honest.** He reports paying a real product cost to stay on rung one, including not merging an app he prefers. Volunteering the cost of your own advice is rare. **Fallacies.** 1. **Special pleading / self-contradiction on evidence standards** โ€” `#fallacy/special-pleading`. [05:02โ€“05:16] The embedded clip demands evaluation from people using retrieval โ€” "I'm pretty sure you've never done an evaluation if that actually produces better outputs" โ€” and immediately asserts the contrary conclusion with no evaluation: "I guarantee you it does not." The evidentiary standard applies only to the opposing position. **Fix:** run or cite the evaluation, or downgrade the guarantee to a prior. 2. **Hasty generalization** โ€” `#fallacy/hasty-generalization`. [21:54โ€“22:00] From one practitioner's memory store on his own machines to "everyone should be turning that off." His AGENTS.md is exceptional by his own account and by the chat's; memory plausibly performs differently for users without one. **Fix:** scope the recommendation to users with well-developed instruction files. 3. **Unsupported causal claim of serious harm** โ€” `#fallacy/unsupported-causal-claim`. [09:47โ€“10:06] That GPT-4o's memory implementation "resulted in severe mental health damage to a lot of people" is a population-level causal assertion with no evidence, offered as personal belief inside a technical argument. It should not be repeated without sourcing. **Fix:** cite or drop. 4. **Appeal to authority (second-hand and unverified)** โ€” `#fallacy/appeal-to-authority`. [31:18โ€“31:33] The discipline/values quote arrives via a chat message, is explicitly not verified on air ("I do not know this was an Uncle Bob quote"), and is then endorsed enthusiastically and used as a summary conclusion. **Fix:** verify before load-bearing use. 5. **Argument from revealed preference presented as proof** โ€” `#fallacy/appeal-to-authority`. [05:16โ€“07:41] "Cursor abandoned it, therefore it doesn't work" treats a commercial decision as a technical verdict. Companies abandon working approaches for cost, focus, and strategic reasons. Informative, not dispositive. **Fix:** present as evidence, not as settling the matter. 6. **False dilemma** โ€” `#fallacy/false-dilemma`. Throughout the memory sections. The choice is framed as automatic memory versus no memory. Curated memory โ€” deliberately authored, reviewed, pruned โ€” is a third option his own AGENTS.md practice arguably exemplifies, and it is never distinguished from the automatic capture he audited. **Fix:** name the distinction; it substantially changes who the advice applies to. 7. **Anecdotal evidence for the headline claim** โ€” `#fallacy/anecdotal`. [34:16โ€“34:33] "Performance without compromise" affecting regressions more than systemic code changes is offered without measurement, in a video whose central virtue is measurement. **Fix:** measure it; the ablation is easy. **Tone of voice.** Energetic, profane, confident to the point of combative. Genuinely enthusiastic about others' ideas โ€” repeatedly credits Lauren, Zechner, Ronacher, and Martin generously rather than absorbing their points. Escalates visibly during the audit into performed outrage, which is entertaining and somewhat undercuts the analytical register. Dismissive toward disagreement in a way that is stylistically consistent but epistemically costly. Redeemed substantially by public mind-changing and self-directed criticism. ## ๐Ÿ›ก๏ธ DARVO Analysis **Deny** โ€” Not present in the interpersonal sense. There is denial of a technical position (that memory systems help), which is ordinary disagreement rather than DARVO. **Attack** โ€” Present in mild, non-personal form. The rhetoric toward people holding the opposing view is dismissive โ€” the "if you think Cursor is entirely wrongโ€ฆ then sure, go make a fancy [system]" construction attacks the position by mocking its holders rather than by engaging their evidence. This is closer to ridicule than to DARVO's defensive attack, since he is not deflecting an accusation against himself. **Reverse victim and offender** โ€” Not present. No victimhood is claimed, and no accusation is being redirected. The narrator repeatedly assigns fault to himself where applicable ("I'm even guilty of this with Lakebed"). **Assessment: no DARVO pattern.** The combative register is stylistic, not structurally defensive. Recorded here because the dismissive tone toward dissenters is worth noting on its own terms โ€” it suppresses the disagreement that would test the argument โ€” but it does not constitute DARVO. ## ๐ŸŽฏ Conclusion **Bottom line.** Two things of durable value, and they are separable from the video's rhetoric. The first is **a measurement**: on one heavily-used machine, agent memory was written roughly three times for every time it was read, and more than half of stored memories were never read at all โ€” with the model's own categorization finding a third of them redundant with the instruction file that every session already loads. That is a real, checkable finding about *utilization*, and it is more than almost anyone else in this discourse has bothered to gather. Its limits matter: it measures automatic capture, not curated authorship, and utilization is not value. The second is **an ordering**: architecture, then CI, then a skill or rule, then a human. The ordering is justified by durability rather than preference โ€” the top two rungs hold without anyone reading anything, and prose holds only while it is read and obeyed. The corollary is genuinely contrarian in the current moment: **skills are a safety net, not a first reach**, and they earn their place mostly for process around the code rather than for the code itself. The constructive half โ€” values sections, a glossary, product context, taste encoded from what reviewers object to โ€” targets directional alignment rather than prohibition, and the stated success criterion is good: the agent should surprise you by correctly extending what you asked. Held against it: an explicit double standard on evidence (demanding evaluations while guaranteeing the opposite result without one), a serious unsourced claim about psychological harm, a load-bearing quote the narrator admits he has not verified, and a persistent conflation of automatic memory with persistent context generally. **Next steps.** 1. Run the read/write audit locally before changing anything. It is cheap and it is the only claim here that transfers as evidence rather than as opinion. 2. Distinguish automatic capture from curated authorship explicitly โ€” the finding indicts the first, and Courtney's memory practice is the second. 3. Take the ladder as a standing prioritization for recurring agent corrections. ## ๐Ÿงฑ Refactor Appendix ### Literature Split Pad (H3) > [!quote] `#atom/literature/h1` > "for coding, I don't want a memory system. Code is truth. Code is the ground truth. It's also evolving and I don't need another place that I need to maintain. I already have a code base to maintain." Zechner's thesis. The maintenance-burden argument is the strongest form of it. > [!quote] `#atom/literature/h1` > "the memories get written far more than they get read. Across every T3 code transcript on this machine, there's over 355 sessions just here. Only 19 of them ever opened an individual memory file, while 80 sessions wrote or edited them. It's a 3 to one write to read. Of the 45 memories, 26 have never once been read." The measurement. The single most valuable passage in the source. > [!quote] `#atom/literature/h1` > "skills should be a fallback that you fall into when the codebase can't solve the problem and the lint rules in CI also can't. Skills shouldn't be this thing you reach for all the time to build this crazy set of skills that will solve all your problems. They are a safety net. They are a fallback." The contrarian claim, stated plainly. > [!quote] `#atom/literature/h1` > "The best thing you can do always is categorically eliminate the problem through better architecture or choice of data structures." Rung one of the ladder. > [!quote] `#atom/literature/h2` > "a comment is left in some code because it has to do a certain thing a certain way. The thing changes, the comment doesn't. Now that comment isn't just like tech dead in the sense that it's sitting around doing nothing. It's now actively harmful because it steers people and agents the wrong way." The staleness-harm argument, grounded in a universally familiar failure. > [!quote] `#atom/literature/h2` > "find a way to communicate not just what you don't want the agent to do rather how you want the agent to think about what it would do." The reframe from prohibition to intent. > [!quote] `#atom/literature/h2` > "It's probably a mistake to impose human discipline on an agent, but it's not a mistake to impose human values on the agent." Attributed to Robert C. Martin via chat. **Second-hand and unverified by the narrator himself** โ€” verify before citing. > [!quote] `#atom/literature/h2` > "Have you ever had an engineer on your team that doesn't actually understand the product? I have. It's not fun." The justification for putting product positioning in an instruction file. > [!quote] `#atom/literature/h2` > "It's so easy to context yourself to hell if you let things that shouldn't be in your context be there because those will mislead the model with things that haven't been true for sometimes months or years even." Names the failure mode compactly. > [!quote] `#atom/literature/h3` > "Your agents should understand you well enough to reasonably copy what you would do." The success criterion. > [!quote] `#atom/literature/h3` > "models are really good at kind of understanding the code structure and the code style you have just based on reading one or two files and if you have that in order then you don't need an HSMD for it to follow your coding style" Argues most style instruction is redundant. *(Auto-caption garbles "AGENTS.md" as "HSMD.")* > [!quote] `#atom/literature/h3` > "what we really want is to make sure that on Groundhog Day when the model wakes up and starts that it has all the things that matter to you in its head so that it's more likely to go where you want it to go." The reframe of the thread-reset problem. ### Atomic Split Pad (H4) - `#atom/zettel/z1` **A knowledge store nobody reads is a diary, not infrastructure** โ€” Utilization is the first question to ask of any persistent context system. Write:read ratio is cheap to measure and rarely measured. - `#atom/zettel/z1` **Stale context is worse than absent context** โ€” Missing information causes a search; wrong information causes confident error. Any auto-persisting store must therefore have an expiry or review discipline, or it accumulates confident error. - `#atom/zettel/z1` **Prefer the enforcement layer that holds without attention** โ€” Architecture holds unattended; CI holds unattended; prose holds only while read and obeyed. Order interventions by how little ongoing attention they require, not by how fast they are to write. - `#atom/zettel/z1` **Instructions that convey intent generalize; instructions that convey prohibition do not** โ€” A prohibition covers the enumerated case. A stated value shapes decisions in situations nobody enumerated. This is why values sections outperform rule lists per line spent. - `#atom/zettel/z1` **Point-in-time facts should never be persisted as standing context** โ€” "The CLI is out of date," "the PR is open," "the migration is pending" describe a moment. Persisted, they become assertions about the present that are false by default. - `#atom/zettel/z1` **The bar for tuned tooling is correct surprise** โ€” When an agent extends your request in a direction you would have chosen but did not state, shared context is sufficient. Mere compliance is a weaker signal. - `#atom/zettel/z1` **Automatic capture and curated authorship are different systems** โ€” Conflating them makes evidence about one appear to indict the other. Most memory criticism targets capture policy, not persistence. ### Fleeting Queue - `#atom/fleeting/f1` **Run the read/write audit on Courtney's own memory directory.** Directly testable, cheap, and the finding either confirms or refutes the transferability of the whole video. Highest-value item in this batch. - `#atom/fleeting/f1` The curated-versus-automatic distinction is the crux for Courtney specifically: her memory files are hand-written with a stated type, a why, and a prune discipline. Theo audited a system with none of those properties. - `#atom/fleeting/f1` **Direct tension with the 2026-08-24 methods review.** That review recorded a WordCamp speaker who has the LLM write its own rules and never reads the memory file, and logged it as "contested, not settled." This video is the measurement that contests it โ€” 3:1 write:read, 58% never read. Update that note. - `#atom/fleeting/f1` The ladder and the enforcement-boundaries note from 2026-08-24 are the same principle discovered twice in two days from unrelated sources. The ladder adds the *ordering*; enforcement-boundaries adds the *incentive* explanation for why gates bind. Merge candidate. - `#atom/fleeting/f1` Security angle nobody raised: automatic memory is a persistence primitive for prompt injection. Untrusted session content written to a store that later sessions trust. - `#atom/fleeting/f1` The bandwidth-ceiling CI check is directly portable to courtneyr.dev performance work โ€” replay representative loads, measure, fail over threshold. - `#atom/fleeting/f1` "Benchmark contamination via persistent memory" is a real methodological hazard for anyone comparing models on a working machine. - `#atom/fleeting/f1` The glossary finding โ€” a shared-vocabulary section curbs invented terminology โ€” is cheap to test in one skill. <!-- deep-read:sections end --> ๐Ÿ“„ **Full text:** [[Full Document Contents/Articles/Turn Off Claude Code's Memory.md|Turn Off Claude Code's Memory by Theo Browne (t3.gg)]] ## Highlights - don't need another place that I need to maintain. I already have a code base to maintain. So for code, I don't need a memory system, right? >> Already endless bangers. I couldn't agree more here. Even things like comments often go out of date where a comment is left in some code because it has to do a certain thing a certain way. The thing changes, the comment doesn't. Now that comment isn't just like tech dead in the sense that it's sitting around doing nothing. It's now actively harmful because it steers people and agents the wrong way. Keeping your context up to date and keeping your ([View Highlight](https://read.readwise.io/read/01m0wag75p6zt9bmdkvrqbvewg)) - Note: Two claims worth separating. Mario Zechner's: code is ground truth, and a memory system is a second thing to maintain. Theo's escalation: stale context is not merely dead weight but ACTIVELY HARMFUL, because it steers people and agents wrong. Missing information causes a search; wrong information causes confident error. Applies to vaults and wikis as much as to agent memory. - Tags: atom/zettel/z1, atom/literature/h1 - 355 sessions just here. Only 19 of them ever opened an individual memory file, while 80 sessions wrote or edited them. It's a 3 to one write to read. Of the 45 memories, 26 have never once been read. Yeah, garbage. Useless. Okay, that's all dying now for sure. I'm going to kill literally all of that cuz I'm annoyed. Holy [ \_\_ ] My my war against memory systems just ramped up massively. This is so bad. Okay, so what do I do ([View Highlight](https://read.readwise.io/read/01m0waez3n9r5ze9n7vna6m486)) - Note: THE measurement, and the reason this source matters โ€” someone actually counted instead of asserting. 3:1 write-to-read, 26 of 45 never read. Two limits worth holding: it measures automatic capture, not curated authorship (Courtney's memory files are the latter), and utilization is not value โ€” the 19 sessions that did read may have been well served. Directly testable locally. - Tags: action/h1, atom/literature/h1, atom/zettel/z1 - working in it that can be these failure cases. And my advice is often to take one step back and find a way to communicate not just what you don't want the agent to do rather how you want the agent to think about what it would do. And I've been writing my agent and claude MD files like this accordingly because I think it helps a lot with getting the model going in the directions you want because there's again there's the two sides. There is preventing small annoying failures and ([View Highlight](https://read.readwise.io/read/01m0wagega9sw6mr7vfrxd47mj)) - Note: The reframe from prohibition to intent โ€” communicate how you want the agent to THINK about what it would do, not just what not to do. A prohibition covers the enumerated case; a stated value shapes decisions nobody enumerated. Directly relevant to Courtney's CLAUDE.md, which is currently prohibition-heavy ("Never:", "Don't", "No AI words"). - Tags: atom/literature/h2, action/h2, atom/zettel/z1 - about how to eliminate it entirely. It being the thing that went wrong. Like what can you do that prevents you from having to intervene in the future? She orders these in value. And I really like that cuz you really should go through these top to bottom and try to apply them out of each layer until the problem goes away. The best thing you can do always is categorically eliminate the problem through better architecture or choice of data structures. This is a thing I've been trying to do since way before the AI era. It's why I loved stuff like TRPC and I built the T3 stack. The amount of bugs that just ([View Highlight](https://read.readwise.io/read/01m0waf5nzvna12vyq3chdrgrd)) - Note: Rung one of the elimination ladder, credited to Lauren (Pstack, Cursor). The ordering is the contribution: architecture, then CI, then a skill, then a human โ€” ordered by durability, because the top rungs hold without anyone reading anything. Merges with the enforcement-boundaries note from 2026-08-24, which had the principle but not the ordering. - Tags: atom/zettel/z1, atom/literature/h1 - also can't. Skills shouldn't be this thing you reach for all the time to build this crazy set of skills that will solve all your problems. They are a safety net. They are a fallback. You should treat them accordingly. And if somehow all of these things fail, introduce a human into the loop to check. You should not have to do this. You get the point though. I really like Lauren's way of framing these things. And I think you can see what I mean. If you look at my projects and you look at T3 code and see how we've architected it, what we have done and how we're building it. One of the main hesitations ([View Highlight](https://read.readwise.io/read/01m0wafn7t337af8443qpd3908)) - Note: The contrarian claim, and the one most directly relevant to a 159-skill library: skills are rung THREE, a safety net reached after architecture and CI have both failed โ€” not a first reach. Note it also puts "human in the loop" at rung four, which sits in direct tension with the OCN broadcast processed the same day, where the human gate was the last reliable defense. Both may hold at different blast radii. - Tags: atom/zettel/z1, atom/literature/h1, action/h1 - and your agent are working in such lock step that you're regularly surprised by how well it seems like it understands you. And that is a thing you have to build because every time you start a new thread, the agent's brain is wiped out. That doesn't mean we need automatic memories to keep it fresh and up to date. They're actually worse than that. They make it bad. What we really want is to make sure that on Groundhog Day when the model wakes up and starts that it has all the things that matter to you in its head so that it's more likely to go where you want it to go. Take the opportunity to get a little more personal with how you talk to your ([View Highlight](https://read.readwise.io/read/01m0wagxvk8vfy1pz1tbk9epa2)) - Note: The closing reframe of the thread-reset problem, and the success criterion: the bar is not compliance but correct surprise โ€” the agent extending your request in a direction you would have chosen but did not state. Note this is where the false dilemma sits most clearly: automatic memory vs. no memory, with curated authorship never named as the third option. - Tags: atom/zettel/z1, atom/literature/h3