<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:googleplay="http://www.google.com/schemas/play-podcasts/1.0"><channel><title><![CDATA[Claude Code for Non-Coders]]></title><description><![CDATA[A newsletter focused on sharing information about using Claude Code and other AI agents for non-coders and non-coding use cases.]]></description><link>https://claudecodefornoncoders.substack.com</link><image><url>https://substackcdn.com/image/fetch/$s_!fnHc!,w_256,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F554aa08c-eb5b-4608-8bf6-37c64e03a6c7_1024x1024.png</url><title>Claude Code for Non-Coders</title><link>https://claudecodefornoncoders.substack.com</link></image><generator>Substack</generator><lastBuildDate>Fri, 03 Jul 2026 06:29:13 GMT</lastBuildDate><atom:link href="https://claudecodefornoncoders.substack.com/feed" rel="self" type="application/rss+xml"/><copyright><![CDATA[Daniel Williams]]></copyright><language><![CDATA[en]]></language><webMaster><![CDATA[claudecodefornoncoders@substack.com]]></webMaster><itunes:owner><itunes:email><![CDATA[claudecodefornoncoders@substack.com]]></itunes:email><itunes:name><![CDATA[Daniel Williams]]></itunes:name></itunes:owner><itunes:author><![CDATA[Daniel Williams]]></itunes:author><googleplay:owner><![CDATA[claudecodefornoncoders@substack.com]]></googleplay:owner><googleplay:email><![CDATA[claudecodefornoncoders@substack.com]]></googleplay:email><googleplay:author><![CDATA[Daniel Williams]]></googleplay:author><itunes:block><![CDATA[Yes]]></itunes:block><item><title><![CDATA[Don’t Switch AI Tools Every Week. Learn the One You Have.]]></title><description><![CDATA[Anthropic just raised the limits. If you still hit the wall daily, it&#8217;s your CLAUDE.md: missing, or so bloated it burns tokens every turn.]]></description><link>https://claudecodefornoncoders.substack.com/p/dont-switch-ai-tools-every-week-learn</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/dont-switch-ai-tools-every-week-learn</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Thu, 02 Jul 2026 12:15:03 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!atbR!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="callout-block" data-callout="true"><p>&#128075; Welcome! I&#8217;m Daniel Williams. I write Claude Code for Non-Coders for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8221;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8220;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><div><hr></div><p><strong>Join 34,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!atbR!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!atbR!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!atbR!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!atbR!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!atbR!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!atbR!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/f0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:129783,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/204209320?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!atbR!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!atbR!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!atbR!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!atbR!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff0496b25-4805-446e-8a65-dc0072f07766_1920x1080.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p><em>Thursday &#183; the setup habit that keeps you the operator, not the one paying for the model&#8217;s bad memory.</em></p><p><strong>tl;dr:</strong> If you hit your usage limit frequently, the cause is almost never the price. It is your setup, and specifically one file: the <code>CLAUDE.md</code> that the agent reads on every turn. Most people are running with no <code>CLAUDE.md</code> at all, or with one that has bloated into a wall of text that burns tokens and buries the few instructions that matter. A lean version of that file, plus a couple of habits, is the difference, and it works the same whether you use Claude Code or Cowork. I have not hit a limit since November.</p><p>A friend texted me last week that she is done with Claude. It interrupts her work every day by hitting her usage limit, and she is about to move everything to Gemini. She is not the only one; I have heard the same complaint more than once lately, each time from a sharp person who is not doing anything obviously wrong.</p><p>Before you cancel anything, look at what Anthropic just did: they made the limits more generous, not less. In May, they doubled the short five-hour window on every paid plan and removed the peak-hour throttle that used to quietly cut your quota in half during busy stretches. A week later, they added another 50% to the weekly cap, a bump that runs through mid-July. If your wall got higher and you are still slamming into it every single day, the wall is not the problem. Something on your side is spending the budget faster than it should.</p><p>The first thing to understand is that it is one budget. The same allowance is shared across Cowork, the chat app, and Claude Code. Burn tokens carelessly in one, and you lose capacity in all of them. So the question is not &#8220;how do I get more limit.&#8221; It is &#8220;what is quietly emptying the tank,&#8221; and for most people the answer is the file that is supposed to prevent exactly that.</p><p>In Claude Code and Cowork, the <code>CLAUDE.md</code> file is a plain-text file that sits in your project, is read into the agent&#8217;s memory at the start of the work, and is referenced as it goes. This is true whether you work in Claude Code from a terminal or in Cowork without ever touching a command line: both read that same file, and setting it up well pays off identically in either, so nothing here depends on which one you use. It is where you tell the agent what this project is, how you like things done, and what to leave alone, so it stops guessing and stops asking. It is the single highest-leverage thing in your setup, which is also why it is the single most common thing people get wrong, in two opposite directions.</p><p>The first way is to have no <code>CLAUDE.md</code> at all. This is where my friend was. With nothing to orient it, the agent re-derives your project from scratch every session: it reads files it has read before, re-explains its own reasoning, asks you things you already answered last week, and rebuilds context you could have simply handed it. Every one of those moves costs tokens out of the shared budget, and you pay that cost again every time you start. It feels like the tool is being inefficient. It is, but you are the one who left it blindfolded.</p><p>The second way is the one almost nobody warns you about, and it is worse because it looks responsible. You add a <code>CLAUDE.md</code>. It helps, so you keep adding to it. Every preference, every past mistake, every edge case, every &#8220;make sure you always&#8221; gets pasted in until the file is a thousand lines of accumulated rules. Here is the trap: that file is loaded on every turn. A bloated <code>CLAUDE.md</code> is not a one-time setup cost. It is a tax you pay on every message you send, forever. And it does a second kind of damage that has nothing to do with tokens. When the handful of instructions that actually matter are buried in hundreds that rarely apply, the model&#8217;s attention spreads thin, and the important ones get missed, the same way the middle of a long document is where things quietly fall through. The file you built to make the agent reliable is now making it both expensive and unreliable.</p><p>I know this one because I did it to myself. The project file for this newsletter grew, as they all do, into a wall of voice rules, structural notes, and reminders, and it rode along with every request, whether the task needed it or not. So I cut it down. I shrank it to a short index that says what the project is and points to the few things that matter, and I moved the detailed material into separate documents that the agent only opens when the work actually calls for them. The instructions did not disappear; they just stopped being loaded when they were not needed. The file went from something I paid for on every single request to something so lean I stopped noticing the cost.</p><p>That is the whole fix, and the rule of thumb is simple: a good <code>CLAUDE.md</code> is a short index, not a warehouse. Put in the things that are true on every task, what the project is, the handful of commands or conventions you rely on, the clear &#8220;do not do this&#8221; lines, and leave out everything that is only true some of the time. The detail does not have to live in your head or in the agent&#8217;s memory every turn; it can live in other files the agent loads on demand. Lean and pointed beats long and complete, every time, because the agent reads the lean one on every turn, and you want every turn to be cheap.</p><p>You do not even have to read the file yourself to find out which problem you have. The agent can check for you. Open your project in Claude Code or Cowork and paste this:</p><div class="highlighted_code_block" data-attrs="{&quot;language&quot;:&quot;markdown&quot;,&quot;nodeId&quot;:null}" data-component-name="HighlightedCodeBlockToDOM"><pre class="shiki"><code class="language-markdown">Check my CLAUDE.md setup for this project. I don't write code, so explain in plain 
language.

1. Look for a CLAUDE.md in this project, including any in subfolders.

2. Tell me what you find: none, one, or several, and roughly how long each one is.

3. Give me a plain read: is it missing, about right, or bloated, meaning a long wall 
of rules that loads on every single turn?

Don't change anything yet. Just tell me where I stand.</code></pre></div><p>That is the diagnosis, and most of the time, it is the whole reveal. Neither having no <code>CLAUDE.md</code> nor having a thousand-line one is right. Once you know where you stand, the first pass is safe to do yourself, and the agent can do it for you. Paste this:</p><p>Now help me improve my CLAUDE.md. I don&#8217;t write code, so explain each step in plain language, show me the change before you make it, and don&#8217;t touch any file until I say go. </p><div class="highlighted_code_block" data-attrs="{&quot;language&quot;:&quot;markdown&quot;,&quot;nodeId&quot;:null}" data-component-name="HighlightedCodeBlockToDOM"><pre class="shiki"><code class="language-markdown">Now help me improve my CLAUDE.md. I don't write code, so explain each step in
plain language, show me the change before you make it, and don't touch any
file until I say go.

1. If I don&#8217;t have a CLAUDE.md, draft a short one: what this project is, the few 
commands or conventions that are true on every task, and any clear &#8220;don&#8217;t do this&#8221; 
lines. Keep it to about a screen. 

2. If mine is bloated, propose a trimmed version: a short index that keeps only what&#8217;s 
true on every task, and move the rest (detailed rules, style notes, anything only 
sometimes relevant) into separate files the agent opens only when the work calls for 
them. Nothing gets deleted, only relocated.

3. If mine is about right, tell me the one or two lines to tighten, and leave the rest 
alone. 

4. Show me a before-and-after, say in plain language what you moved and why, and keep a 
copy of the original so I can undo it. Then wait for my go.</code></pre></div><p>That gets you to a lean, pointed file, which is most of the win: the agent reads a short index on every turn instead of a wall of rules. The deeper move, where each rule should actually live across your whole account, a single project, and individual folders, so the right guidance loads only when it is relevant, is what next Tuesday&#8217;s paid lesson takes apart, and it teaches that whole config layer by putting it to work in a real build: an agent that captures your work wins and turns them into your next performance review, <em>Build the Agent That Tracks Your Wins and Gets You Promoted</em>. This Thursday gets your file lean. Tuesday builds the full architecture into something you will use every week.</p><p>A few habits sit alongside the file and matter almost as much. Start fresh with brief sessions instead of dragging a giant old conversation forward, because a long history is its own bloated context you reload with every message. Use the right model for the job: I still reach for Gemini on the work it is genuinely better at, like parsing an image, a first pass at research, or a quick factual question, and I keep Claude for my primary and agentic work, where the details have to be right, and I have watched it catch errors other models confidently shipped. None of that is about using the tool less. It is about not making it carry weight it does not need to carry.</p><p>The limits will keep moving. They went up this spring, and they will change again, and none of that is yours to control. Your architecture setup is. Before you switch tools over a wall you hit every day, find out which one the wall actually is, the tool or your setup, and then go fix the file.</p><p>And this is bigger than Claude versus Gemini. There is a newer model or a shinier tool every few weeks, and the temptation, the moment yours frustrates you, is to jump. But every one of these tools rewards the same thing: learning how it actually works and setting it up to work for you. Switch before you have done that, and you do not escape the problem. You carry it to a tool you understand even less and rebuild it there from zero. The people who get the most out of AI are almost never the ones with the newest tool. They are the ones who learned the architecture of the tool they already have. The file is the smallest, fastest example of that; the habit is the whole game.</p><p>The discipline of deciding what your agent should know up front and encoding it where it belongs, rather than re-explaining it every session, is the same discipline that separates people who operate these tools from people who are operated by them. Configuration is the part of the stack you actually own; the paid deep dive on that is <a href="https://claudecodefornoncoders.substack.com/p/stop-treating-mcp-as-tools-its-your">Stop Treating MCP as Tools. It&#8217;s Your Architecture.</a> New here? Start with the map: <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">Start Here: The Claude Architecture</a>.</p><p>So before you switch, which will cost you a month of relearning, run that check first. The wall you keep hitting is almost never the one they sell you. It is the one you built, and it is the one you can fix.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:&quot;button-wrapper&quot;}" data-component-name="ButtonCreateButton"><a class="button primary button-wrapper" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p><p>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</p><div><hr></div><p><a href="https://claudecodefornoncoders.substack.com/">Claude Code for Non-Coders</a> publishes on Tuesdays and Thursdays. If you found this useful, share it with someone who&#8217;s about to rage-quit a tool over a wall they built themselves.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/p/dont-switch-ai-tools-every-week-learn?utm_source=substack&utm_medium=email&utm_content=share&action=share&quot;,&quot;text&quot;:&quot;Share&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/p/dont-switch-ai-tools-every-week-learn?utm_source=substack&utm_medium=email&utm_content=share&action=share"><span>Share</span></a></p>]]></content:encoded></item><item><title><![CDATA[Build a Household Agent You’d Actually Trust This Weekend]]></title><description><![CDATA[Everyone points AI at the enterprise. The build that actually pays off is the one running your own home, and whether you can trust it comes down to five decisions.]]></description><link>https://claudecodefornoncoders.substack.com/p/build-a-household-agent-youd-actually</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/build-a-household-agent-youd-actually</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Mon, 29 Jun 2026 23:47:27 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!78rN!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="callout-block" data-callout="true"><p>&#128075; Welcome! I&#8217;m Daniel Williams. I write <em>Claude Code for Non-Coders</em> for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8221;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8220;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><div><hr></div><p><strong>Join 34,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><div><hr></div><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!78rN!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!78rN!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png 424w, https://substackcdn.com/image/fetch/$s_!78rN!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png 848w, https://substackcdn.com/image/fetch/$s_!78rN!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png 1272w, https://substackcdn.com/image/fetch/$s_!78rN!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!78rN!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/e4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:971,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:137901,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/204196720?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!78rN!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png 424w, https://substackcdn.com/image/fetch/$s_!78rN!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png 848w, https://substackcdn.com/image/fetch/$s_!78rN!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png 1272w, https://substackcdn.com/image/fetch/$s_!78rN!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe4f5c575-9779-40eb-86d0-8419bc68a94b_1800x1200.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p><em>Architecture Series &#183; Domain 2 &#183; Capstone &#183; Household Operations Agent</em></p><p>The money and attention in AI are focused on the enterprise. Copilots for the sales team, agents for the support queue, six-figure contracts for systems nobody on the floor quite trusts yet. Meanwhile, the highest-value thing you can build with these same tools is sitting in your own house, and almost nobody is building it. Not because it&#8217;s hard. Because it&#8217;s unglamorous: the furnace filter that&#8217;s been overdue for three months, the subscription that quietly renewed for another year, the recurring tasks nobody is tracking until something lapses. This weekend, I built an agent that runs all of that locally on my own machine. The point of this lesson is that you can build one too, by the end of this one.</p><p>The harder part isn&#8217;t building it. A flashy version takes an afternoon. The harder part is building one you would actually trust with the job, and that is the whole difference between a demo and a tool you rely on. That difference comes down to five decisions, the same five this domain has spent five lessons on. This is the Domain 2 capstone: the lessons, wired into one thing you can run.</p><p><em>This is a paid Architecture lesson. The full build, the five decisions, and the paste-in prompt to build your own are below for subscribers.</em></p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:&quot;button-wrapper&quot;}" data-component-name="ButtonCreateButton"><a class="button primary button-wrapper" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p>
      <p>
          <a href="https://claudecodefornoncoders.substack.com/p/build-a-household-agent-youd-actually">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Your Family Health Agent: The Whole Build]]></title><description><![CDATA[The database, the skills, the Telegram bridge, the one script that keeps it alive, and a prompt you can paste into Claude Code to stand up your own this weekend.]]></description><link>https://claudecodefornoncoders.substack.com/p/your-family-health-agent-the-whole</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/your-family-health-agent-the-whole</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Thu, 25 Jun 2026 12:15:56 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!v9vi!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="callout-block" data-callout="true"><p>&#128075; Welcome! I&#8217;m Daniel Williams. I write Claude Code for Non-Coders for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8221;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8220;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><p><em>Thursday &#183; the build, part two of pointing this at what matters.</em></p><blockquote><p><strong>tl;dr:</strong> Last week, I <a href="https://claudecodefornoncoders.substack.com/p/i-built-my-family-an-agentic-health?r=3ve08">described the health agent</a> my family has run for six months. Enough of you asked for the build, so here it is: one SQLite file, a few skills, an MCP bridge to Telegram, and a small web app. None of it is exotic. I put a clean starter on GitHub you can clone, or there&#8217;s a prompt at the end you can paste into Claude Code to build your own from scratch this weekend, plus the one unglamorous fix that&#8217;s the actual difference between a clever demo and something a family uses for half a year.</p></blockquote><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!v9vi!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!v9vi!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!v9vi!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!v9vi!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!v9vi!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!v9vi!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:138254,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202641847?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!v9vi!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!v9vi!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!v9vi!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!v9vi!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F11b8724a-ad6d-425d-8f3c-0d0079e5e616_1920x1080.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>When I described <a href="https://claudecodefornoncoders.substack.com/p/i-built-my-family-an-agentic-health">the health agent my family runs</a> last week, I said I&#8217;d walk the full build in a follow-up. The comments made it clear what most of you wanted, and it wasn&#8217;t a treatise on architecture. It was the parts list and the wiring, for your own families, not your jobs. So that&#8217;s what this is.</p><p>Here&#8217;s the part I want to get across before any of the pieces: the build is not the hard part. I put the first working version together over a weekend. The hard part was a design decision I got wrong at first and had to correct, and the one boring script almost nobody writes about. The components themselves are simple and the same four every time.</p><p>At the center is one record. A single SQLite file, which is just a database that lives as one file on your own machine, no server to rent and no account to create. A short schema file defines the tables: who the users are, and then a table for each thing you actually track. In our case, that&#8217;s blood pressure and weight, sleep, workouts, and a log of medications, symptoms, and any reactions. Yours will be different, and that&#8217;s the point: you define the record around what your family needs, not around what some product decided to measure. Everything else in the system is either a way to put data into that file or a way to look at what&#8217;s in it.</p><p>The skills are the routines that the agent already knows how to run. In Claude Code, a skill is just a short instruction file you drop in a folder, written in plain English, and from then on, the agent has it on tap. I keep three, and walking through them shows how little of this is actually code.</p><p>The first delivers the day&#8217;s workout. I message the agent, and it pulls that day&#8217;s plan from the database, looks up what I actually lifted last time, applies the progression, and sends back the session already adjusted: if last week&#8217;s reps held on a compound lift, the weight goes up about five pounds; if a set broke down, it holds me there instead of pushing. My wife trains on a different rule, a three-week cycle with a deload week built in, and the same skill knows to treat her plan differently from mine. Then it sends a second message right behind the first: a pre-filled logging sheet, one line per exercise with today&#8217;s target already entered, ready for me to edit.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!3Q64!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!3Q64!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png 424w, https://substackcdn.com/image/fetch/$s_!3Q64!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png 848w, https://substackcdn.com/image/fetch/$s_!3Q64!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png 1272w, https://substackcdn.com/image/fetch/$s_!3Q64!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!3Q64!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png" width="716" height="1012" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/dcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1012,&quot;width&quot;:716,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:279159,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202641847?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!3Q64!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png 424w, https://substackcdn.com/image/fetch/$s_!3Q64!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png 848w, https://substackcdn.com/image/fetch/$s_!3Q64!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png 1272w, https://substackcdn.com/image/fetch/$s_!3Q64!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fdcfa7046-b1a7-493a-9353-862758c1c8d1_716x1012.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>The whole loop on one screen: I ask, it sends the day&#8217;s workout with each lift&#8217;s last weight next to today&#8217;s target, and I reply with what I actually did.</em></figcaption></figure></div><p>The second skill closes that loop. After the workout, I send back what I actually did in shorthand, a line like &#8220;115# 5 5 5 5 felt strong&#8221; and a cardio line at the end. The skill reads it, matches each line to the right exercise, and files every set into the database, the weights, the reps, and the note about going heavier next time. Then it writes back a recap so I can confirm it caught everything. I never open a form. I type one message between sets, and the record updates itself.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!AiJN!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!AiJN!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png 424w, https://substackcdn.com/image/fetch/$s_!AiJN!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png 848w, https://substackcdn.com/image/fetch/$s_!AiJN!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png 1272w, https://substackcdn.com/image/fetch/$s_!AiJN!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!AiJN!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png" width="716" height="912" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/a31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:912,&quot;width&quot;:716,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:238173,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202641847?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!AiJN!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png 424w, https://substackcdn.com/image/fetch/$s_!AiJN!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png 848w, https://substackcdn.com/image/fetch/$s_!AiJN!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png 1272w, https://substackcdn.com/image/fetch/$s_!AiJN!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa31fd9eb-d562-47d1-a2ff-3518ee873632_716x912.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>It doesn&#8217;t just store the numbers. It confirms the progression it applied, asks about the set I missed, and notes the lift I added off-plan.</em></figcaption></figure></div><p>The third scores sleep data. I send the night&#8217;s numbers, when I went down, when I woke, the total, and the sleep stages if my watch caught them, and the skill logs them against a six-week plan that walks my target bedtime earlier in stages. It works out which phase I&#8217;m in, whether I hit that night&#8217;s target, and sends back the summary, plus how many of the last seven nights I&#8217;ve actually hit. The seven-night number is the one that changed my behavior, because a single bad night is easy to wave off, and a three-out-of-seven week is not.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!DnZU!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!DnZU!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png 424w, https://substackcdn.com/image/fetch/$s_!DnZU!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png 848w, https://substackcdn.com/image/fetch/$s_!DnZU!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png 1272w, https://substackcdn.com/image/fetch/$s_!DnZU!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!DnZU!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png" width="708" height="966" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:966,&quot;width&quot;:708,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:247785,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202641847?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!DnZU!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png 424w, https://substackcdn.com/image/fetch/$s_!DnZU!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png 848w, https://substackcdn.com/image/fetch/$s_!DnZU!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png 1272w, https://substackcdn.com/image/fetch/$s_!DnZU!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0211b458-e7cf-4169-8032-6e9b6881534d_708x966.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption">It stores the sleep data. It compares it to the existing data, identifying any trends or deviations from the target, and notes where I can improve.</figcaption></figure></div><p>None of these runs longer than a page of plain English. You are not programming; you are writing down, once, the thing you would otherwise re-explain every morning, and handing it to something that runs it the same way every time.</p><p>The bridge is what lets the agent reach beyond the chat window. The database is easy because it&#8217;s a local file that the agent can read and write directly. The piece people miss is messaging: I want to log from the gym or a hotel, not from my laptop. That&#8217;s an MCP, a small plugin that connects Claude Code to an outside service, in this case, Telegram. With it installed, the agent can read and send Telegram messages, so my phone becomes the way in.</p><p>And then two front doors, because capture and review are different jobs, and I stopped trying to make one surface do both. Telegram, plus Claude Channels, so I can reach the agent from anywhere, is the door I use all day: I talk, and it logs. The web app is the other door, a small Python server that reads the same file and draws the charts, the one I open when I want to sit down and actually look at a trend. The app didn&#8217;t disappear when the agent arrived; its job just got smaller and clearer. One record, a few skills, one bridge, two front doors. That&#8217;s the whole machine.</p><p>The design decision I got wrong was thinking the app could be everything. I built the web UI first, with its forms and charts, and it was good at showing and terrible at capturing. Logging meant stopping, opening it, and typing into fields, and that friction is exactly where the data quietly went stale. The fix wasn&#8217;t a better app. It was matching the interface to the job: talk to capture, sit down to see. The moment logging became a sentence I could fire off between sets, the record stopped having holes. If you take one thing from this build, take that, because it&#8217;s the part that decides whether you&#8217;re still using the thing in six months.</p><p>Which brings me to the least glamorous and most important part of the whole write-up, because no course teaches it, and it&#8217;s a real reason mine is still running. It&#8217;s a few lines in my shell startup file that kill any stale messaging-plugin processes whenever I open a new terminal. Without it, an old session hangs around and quietly swallows incoming messages, and you don&#8217;t notice until you realize the agent stopped answering your phone two days ago. It isn&#8217;t interesting. It&#8217;s the difference between a weekend demo and infrastructure your family relies on. Build the fun part first, then spend the extra hour making it durable.</p><p>One line I won&#8217;t move on, same as last time: the agent does not diagnose and does not treat. It keeps the record honest and organized, so the people with the medical training have something real to work from. The doctors do the medical work. The agent&#8217;s whole job is to make sure a good appointment runs on good information, which is the thing most families walk in without.</p><p>There are two ways to start, and you type neither one in by hand. You direct an agent, which is the whole premise of this newsletter. The fast way: I put a clean starter on GitHub at <a href="https://github.com/danieleugenewilliams/health-fitness-agent">github.com/danieleugenewilliams/health-fitness-agent</a>. It&#8217;s the skeleton, the schema, the web app, and the three skills, with every bit of my family&#8217;s data stripped out; the database and personal files are git-ignored and never leave your machine. Clone it, open it in Claude Code, and tell the agent to walk you through the Telegram setup and adjust the tables to what your family tracks.</p><p>The build-your-own way, if you&#8217;d rather shape the record around your family from the first table, is to open Claude Code in an empty folder and paste this. It points the agent at the same repo for guidance, then has it build a version customized to you:</p><pre><code><code>You're helping me build a private health record for my family. Everything
stays local on my machine; no accounts, no cloud. I don't write code, so
explain each step in plain language and stop when you need input from me.

Use this repo as your reference for how the pieces fit together, but build
mine customized to my family rather than copying it as-is:
https://github.com/danieleugenewilliams/health-fitness-agent

1. Ask me who the users are and what each person wants to track. Then design
   the SQLite database and schema around that. Treat the repo's tables as a
   menu (workouts, sleep, blood pressure, weight, medications, symptoms) and
   add, drop, or rename tables so they fit my family. Run it to create the DB.
2. Build the small Python web app (server.py) the way the repo does: a local
   dashboard with charts on localhost:8000, reading and writing that same
   database, keeping the last 30 backups automatically.
3. Set up the skills as slash commands in ~/.claude/commands/, based on the
   repo's versions: one that sends a daily workout with progressive overload,
   one that logs a shorthand reply, one that scores a sleep note. Adapt them
   to our names and routines.
4. Install the Telegram MCP so I can message the agent from my phone. Walk me
   through creating the bot, and ask me for each person's Telegram chat ID
   rather than assuming any.

Go one step at a time. Don't move on until I confirm.</code></code></pre><p>The structure is the same whether you track blood pressure or blood sugar or a toddler&#8217;s feeding schedule; tell the agent what your family actually tracks and let it shape the tables around that. When it&#8217;s running, harden it with one more paste:</p><pre><code><code>Make this durable. Add one thing to my shell startup file (~/.zshrc): a
hook that kills any stale Telegram-plugin processes when I open a new
terminal, so old sessions don't silently swallow messages. Show me the
exact lines and explain what they do.</code></code></pre><p>That&#8217;s the build. A file, a few skills, a bridge, two doors, and an hour of unglamorous hardening. If you want the operating discipline underneath it, the reliability habits that keep an agent honest when it&#8217;s touching something that matters, that&#8217;s what the <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">Architecture track</a> is for. But you don&#8217;t need it to start this weekend.</p><p>I asked last time what you&#8217;d build for the people you love, and the answers in the comments were better than anything I&#8217;d have guessed. So I&#8217;ll ask the more practical version now: if you build this, what&#8217;s the first table you&#8217;re going to make, the thing your family keeps losing track of? Tell me, and tell me how it goes. I read all of them.</p><p>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</p><div><hr></div><p><a href="https://claudecodefornoncoders.substack.com/">Claude Code for Non-Coders</a> publishes on Tuesdays and Thursdays. If you found this useful, share it with someone who&#8217;s trying to build something for their own family.</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Claude Code for Non-Coders is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[Don’t Read Every File in Your Project. Search Instead.]]></title><description><![CDATA[Claude Code threw out its own vector index because searching beat reading. Precision over brute force, with the built-in tools you already have.]]></description><link>https://claudecodefornoncoders.substack.com/p/dont-read-every-file-in-your-project</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/dont-read-every-file-in-your-project</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Tue, 23 Jun 2026 12:15:23 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!55T6!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="callout-block" data-callout="true"><p>&#128075; Welcome! I&#8217;m Daniel Williams. I write <em>Claude Code for Non-Coders</em> for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8221;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8220;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><div><hr></div><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><div><hr></div><p><em>Architecture Series &#183; Domain 2 &#183; Lesson 2.5 &#183; Built-in Tools (Grep, Glob, Edit)</em></p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!55T6!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!55T6!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png 424w, https://substackcdn.com/image/fetch/$s_!55T6!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png 848w, https://substackcdn.com/image/fetch/$s_!55T6!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png 1272w, https://substackcdn.com/image/fetch/$s_!55T6!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!55T6!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/abbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:971,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:120246,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/203176489?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!55T6!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png 424w, https://substackcdn.com/image/fetch/$s_!55T6!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png 848w, https://substackcdn.com/image/fetch/$s_!55T6!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png 1272w, https://substackcdn.com/image/fetch/$s_!55T6!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fabbf02e1-d143-4bd2-b1f5-e539e639a409_1800x1200.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>When your coding agent flails on an unfamiliar codebase, every instinct says to give it more: a bigger context window, a vector index, a few more files pasted into the prompt. The most widely used coding agent in the world was built on the opposite instinct. Anthropic put RAG and a local vector database into early versions of Claude Code, tested it, and tore it out. <a href="https://news.ycombinator.com/item?id=43164253">Boris Cherny, who created Claude Code, said so plainly</a>: &#8220;We found pretty quickly that agentic search generally works better.&#8221; A colleague in the same thread added that it &#8220;outperformed [it] by a lot, and this was surprising.&#8221; The tool millions of engineers now use to understand code does not read the codebase. It searches for it.</p><p>That is the spine of this whole domain, and it arrives at the layer you already have. Each Domain 2 lesson has covered one part of how your agent uses tools: <a href="https://claudecodefornoncoders.substack.com/p/your-agent-picks-the-wrong-tool-its">how it picks the right one</a>, <a href="https://claudecodefornoncoders.substack.com/p/your-agent-hallucinated-a-recovery">what it does when one fails</a>, <a href="https://claudecodefornoncoders.substack.com/p/ai-prices-are-going-up-your-architecture">how many it should have</a>, and <a href="https://claudecodefornoncoders.substack.com/p/stop-treating-mcp-as-tools-its-your">which servers you connect to</a>. This week is about the tools that ship before you connect anything, the ones most builders treat as beginner plumbing and use wrong: Grep, Glob, Read, Write, Edit. Used with precision, they are how an agent finds the one thing that matters without drowning in everything that doesn&#8217;t. Used carelessly, they are how your context window and your invoice both blow up.</p><p><em>This is a paid Architecture lesson. The full lesson, with the research behind it and the operator habits, is below for paid subscribers.</em></p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:&quot;button-wrapper&quot;}" data-component-name="ButtonCreateButton"><a class="button primary button-wrapper" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p>
      <p>
          <a href="https://claudecodefornoncoders.substack.com/p/dont-read-every-file-in-your-project">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Weekend Dispatch — June 20, 2026: Three Forces Run Your AI. None Is the Model.]]></title><description><![CDATA[Meta trained agents on its own workers. Open weights crossed the frontier but won&#8217;t run on your laptop. The war went to the model nobody trusts.]]></description><link>https://claudecodefornoncoders.substack.com/p/weekend-dispatch-june-20-2026-three</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/weekend-dispatch-june-20-2026-three</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Sat, 20 Jun 2026 12:15:29 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!KB3u!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!KB3u!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!KB3u!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png 424w, https://substackcdn.com/image/fetch/$s_!KB3u!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png 848w, https://substackcdn.com/image/fetch/$s_!KB3u!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png 1272w, https://substackcdn.com/image/fetch/$s_!KB3u!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!KB3u!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:971,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:160224,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202655073?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!KB3u!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png 424w, https://substackcdn.com/image/fetch/$s_!KB3u!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png 848w, https://substackcdn.com/image/fetch/$s_!KB3u!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png 1272w, https://substackcdn.com/image/fetch/$s_!KB3u!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ea6be8b-e881-41e4-87fe-9702262f0f2e_1920x1280.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>You became the training data</h2><p>Meta spent this spring capturing how its employees work, down to the keystroke. The program, the Model Capability Initiative, recorded mouse movements, clicks, keystrokes, and periodic snapshots of employees&#8217; screens, all to train AI agents to perform computer tasks the way its people do (<a href="https://fortune.com/2026/04/21/meta-will-start-tracking-employees-screens-and-keystrokes-to-train-ai/">Fortune</a>). The workers were not using the tool. They were the raw material for it. After weeks of backlash, Meta scaled the program back, adding a 30-minute pause button and a way to request an exemption, though by then some employees had reported the monitoring chewed through a month of home internet in a matter of days (<a href="https://www.platformer.news/meta-mci-monitoring-layoffs-knowledge-work/">Platformer</a>, <a href="https://www.hrgrapevine.com/us/content/article/2026-06-01-meta-faces-employee-backlash-over-ai-tracking-tool-as-privacy-concerns-grow">HR Grapevine</a>).</p><p>You know the rule from a decade of free apps: if you aren&#8217;t paying for the product, you are the product. The workplace version is worse. Here, the employee is paid for salaried hours and is still the product. The tool arrives as a perk; the worker feeds it simply by doing the job in front of it, and the agent it trains gets pointed back to that same job. The model isn&#8217;t doing the controlling. The employer is: it sets the timeline, chooses the purpose, and owns the recording. If you are a senior professional wondering how an agent learned the shape of your work, the answer is increasingly that someone watched a person do it and trained on the tape. The model is downstream. The decision to harvest the work and to aim the result back at the worker is upstream. That is the part to watch.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!cQa-!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!cQa-!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!cQa-!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!cQa-!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!cQa-!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!cQa-!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:81048,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202655073?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!cQa-!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!cQa-!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!cQa-!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!cQa-!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F722015d5-72cd-4936-b5f0-b5ae36b6ad58_1920x1080.png 1456w" sizes="100vw"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Open weights crossed the frontier. You still can&#8217;t run them.</h2><p>The open models caught up this month. MiniMax M3, released June 1, edged GPT-5.5 on SWE-bench Pro at 59%, with a one-million-token context window and native multimodal input (<a href="https://www.techtimes.com/articles/317532/20260601/minimax-m3-open-weight-coding-model-frontier-claims-unverified-benchmarks.htm">TechTimes</a>). Zhipu&#8217;s GLM-5.2 followed under an MIT license. On the benchmarks that track real work, the gap between open and closed has narrowed to single digits (<a href="https://www.etftrends.com/artificial-intelligence-content-hub/open-source-ai-models-are-eating-frontier-where-value-goes/">ETF Trends</a>).</p><p>The catch is that &#8220;open&#8221; no longer means &#8220;yours.&#8221; MiniMax M3 is a 428-billion-parameter model; GLM-5.2 is 744 billion (<a href="https://artificialanalysis.ai/models/minimax-m3">Artificial Analysis</a>, <a href="https://www.marktechpost.com/2026/06/14/z-ai-launches-glm-5-2-with-a-usable-1m-token-context-two-thinking-effort-levels-and-no-benchmarks-at-launch/">MarkTechPost</a>). Both are mixture-of-experts designs that fire only a slice of those weights per token, 23 billion for M3 and roughly 40 billion for GLM, but you still have to hold the entire model in memory to run it at all. You can download the weights for free, but you still cannot run them on your laptop or on most common machines. So the thing that actually gates your access isn&#8217;t the license, and it isn&#8217;t even the price of a GPU, which keeps falling. It&#8217;s whether you know how to stand the model up: how to shard it across hardware, quantize it without wrecking its quality, serve it, and keep it serving. That is infrastructure knowledge, and most people who cheer the open-weight headlines don&#8217;t have it. Sovereignty via open models is real, but it belongs to the operator who can do the work, not the one who can find the download link. The controller in this story is your own skill, and it is the one controller on this list you can actually acquire. That is the whole project of the paid <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">Architecture series</a>, and the <a href="https://claudecodefornoncoders.substack.com/p/stop-treating-mcp-as-tools-its-your">most recent lesson</a> makes the same move one layer down: your MCP setup isn&#8217;t a box of tools, it&#8217;s your architecture. Open weights are a promise you cannot collect on until you learn how: the model is free, and the skill to run it is the price. I&#8217;ll take that build apart in a few weeks.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!9NY1!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!9NY1!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!9NY1!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!9NY1!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!9NY1!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!9NY1!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/ed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:111452,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202655073?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!9NY1!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!9NY1!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!9NY1!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!9NY1!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fed2ed954-5a39-4ce4-90cb-e5b2b675acef_1920x1080.png 1456w" sizes="100vw"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><div><hr></div><h2>Grok said yes. Anthropic said no.</h2><p>The starkest version arrived in a courtroom filing. The Pentagon&#8217;s AI chief stated under oath that Elon Musk&#8217;s Grok was used throughout the Iran war, helping direct more than 2,000 munitions to 2,000 targets in 96 hours as part of Palantir&#8217;s Maven Smart Systems (<a href="https://thehill.com/policy/technology/5928204-pentagon-musk-grok-chatbot-iran-strikes/">The Hill</a>, <a href="https://thedebrief.org/grok-goes-to-war-pentagon-reveals-musks-ai-chatbot-launched-missiles-in-u-s-war-with-iran/">The Debrief</a>). Investigators believe AI-assisted targeting was likely behind a strike on an Iranian girls&#8217; school that killed roughly 175 people, most of them children. Grok is the model serious operators trust least, and it was handed the highest-stakes job there is. That was not a verdict on its capability. Which model goes to war is decided by which company will say yes to the state, and this week showed both sides of that bargain.</p><p>Grok said yes and got the contract. Anthropic said no. It refused to let the military use its models for unfettered weaponry and surveillance, and for that, it was made the first US company branded a &#8220;supply chain risk,&#8221; had federal agencies ordered off its models, and this month watched the government pull Fable 5 and Mythos 5 from every customer worldwide (<a href="https://www.inquirer.com/news/nation-world/anthropic-trump-administration-pentagon-fable-mythos-deny-foreign-access-amodei-lutnick-20260614.html">Inquirer</a>). Anthropic is now suing; the Lutnick letter threatening criminal penalties is public, and the legal basis is looking shaky (<a href="https://www.bloomberg.com/news/articles/2026-06-16/read-the-lutnick-letter-that-led-anthropic-to-disable-mythos">Bloomberg</a>, <a href="https://gizmodo.com/feds-legal-basis-for-ban-on-anthropics-most-powerful-models-looks-increasingly-shaky-2000773192">Gizmodo</a>). The Grok disclosure, fittingly, came out through the environmental lawsuit over xAI&#8217;s Colossus data center in Memphis, the same facility I noted last week runs the compute under Claude.</p><p>So here is the controller most operators never price in. The model you trust most can be switched off worldwide by a letter from one official. The model you trust least can be sent to war. Neither outcome was decided by a benchmark; both were decided by which lab complied. Two weeks ago I argued you <a href="https://claudecodefornoncoders.substack.com/p/china-didnt-wait-for-permission-to?r=3ve08">don&#8217;t have sovereign AI, only a single-layer bet</a>. This is the layer beneath all the others: a government deciding which model is allowed to exist at all.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!pvlP!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!pvlP!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!pvlP!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!pvlP!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!pvlP!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!pvlP!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:111061,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202655073?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!pvlP!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!pvlP!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!pvlP!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!pvlP!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F5ecf9962-27c2-4e66-b80d-017039c2f863_1920x1080.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><div><hr></div><p><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);">The knowledge you acquire in how to architect AI systems, not just the software and models, but increasingly, also hardware, will set you apart. Start with the map: </span><strong><a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The Claude Architecture Series</a></strong><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);">.</span></p><p><em>Claude Code for Non-Coders publishes Tuesdays and Thursdays. Weekend Dispatch covers the week&#8217;s biggest AI developments through a builder&#8217;s lens.</em></p><div><hr></div><p><em>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</em></p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p>]]></content:encoded></item><item><title><![CDATA[I Built My Family an Agentic Health Record. You Can Too.]]></title><description><![CDATA[You forget most of what your doctor tells you. I built my family a system that remembers, over a weekend, and it put us in the best shape of our lives.]]></description><link>https://claudecodefornoncoders.substack.com/p/i-built-my-family-an-agentic-health</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/i-built-my-family-an-agentic-health</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Thu, 18 Jun 2026 12:15:25 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!66Z8!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<blockquote><p>&#128075; Welcome! I&#8217;m Daniel Williams. I write Claude Code for Non-Coders for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8221;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8220;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><div><hr></div><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></blockquote><p><strong>tl;dr:</strong> I built my family a health system that tracks our training, our sleep, and the medications, symptoms, and reactions that matter, then made it something we just talk to over Telegram. The payoff wasn&#8217;t convenience. It was the best shape of our adult lives, and walking into our doctors&#8217; offices as informed partners instead of guessing.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!66Z8!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!66Z8!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!66Z8!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!66Z8!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!66Z8!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!66Z8!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/a74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:154157,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202372301?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!66Z8!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!66Z8!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!66Z8!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!66Z8!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa74f900d-03b5-4f3e-9be6-eae238926235_1920x1080.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p></p><p>It&#8217;s a little before seven, and my phone buzzes. Not an email. A message from an agent I built, with the day&#8217;s workout for my wife and me, the weights nudged up from last week. I send back what I actually did. I log my morning blood pressure, and that I took my medication. My wife logs hers. We note one of our sons&#8217; medications for the day. None of it takes longer than it takes for the coffee to brew.</p><p>That routine has run for about six months. It saves time, but that isn&#8217;t why it matters. It matters because it gave us something no one ever actually hands a family: a clear, continuous record of our own health, and the consistency to act on it.</p><p>The reason we got serious is that we were sitting across the breakfast table. We have two sons, nine and seven, and they get bigger and stronger every week. We wrestle and train jiu-jitsu, we race, we spend whole days outside doing things that demand something of a body. I want to keep up with them for a long time. My wife and I are in the best shape of our adult lives right now, and it isn&#8217;t because we found a magic program. It&#8217;s because we finally stayed consistent, and the agent made consistency automatic instead of something I kept restarting.</p><p>On that side, it behaves like a patient trainer. It holds the plan, adds five pounds to a lift when last week&#8217;s reps held, eases off when they didn&#8217;t, and keeps me on a six-week sleep schedule I would never hold on my own. Sleep turned out to matter as much as the lifting. None of these is a hard idea. Doing them every day for months, without a system catching the gaps, is the part that almost everyone fails at. We stopped failing it.</p><p>The quieter half of the record is the one that matters most. For one of my sons and me, we track medications, symptoms, and any reactions in one place. When we sit down with my wellness doctor or with his pediatrician, we don&#8217;t reconstruct the last two months from memory. We bring the record.</p><p>That sounds small until you see how the rest of it goes. Patients forget somewhere between 40 and 80 percent of what a doctor tells them, often before they reach the parking lot, and recall only about half of the decisions made in the room (<a href="https://www.aarp.org/health/healthy-living/doctor-patient-study-2018/">AARP</a>). It isn&#8217;t a discipline problem; it&#8217;s how memory works under stress. And the visits keep getting shorter: 68 percent of patients say their appointments feel rushed (<a href="https://www.partnermd.com/blog/the-state-of-primary-care-in-2025-survey-findings-on-wait-times-rushed-visits-and-preventive-care">PartnerMD</a>), while the actual management of anything ongoing happens in the weeks between visits, when no one is taking notes. The record is how we stopped losing those weeks.</p><p>A few weeks ago, the agent (I call it &#8220;Othellobot&#8221;) did something a logbook never would. It flagged that my blood pressure had climbed well above my usual range and, without being asked, connected it to a stretch of poor sleep stacked on a stressful week. That is not a diagnosis. It is the kind of pattern I would have felt vaguely and then half-described to my doctor months later. Seeing it written down changed what I did that week and gave my doctor something concrete to work with.</p><p>I want to be precise about what the agent does and does not do here, because the line matters. It does not diagnose anything. It does not treat anything. The medication and the doctors do the medical work, and I would never hand that to a model. What the agent does is humbler, and it turns out to be rare: it keeps the data honest and organized so the people with the medical training have something real to work from. A good appointment runs on good information. Most families walk in without it. We stopped having to.</p><p>The part other builders will recognize is how the interface evolved, because I got it wrong at first. I started with an app. I built a local tool with a web UI, charts, and a database underneath, all of it. It works, and I still use it: it&#8217;s where I go to view the charts, scan for trends, or fix a record by hand. What it was bad at was capture. Logging meant stopping what I was doing, opening the app, and typing into forms, and that friction is where the data quietly went stale.</p><p>The change came when I stopped asking the app to be everything and let the agent take the part the app was worst at. Skills for the routines I run often: an MCP so it can access the data; Telegram and Claude Channels so I can message it from my phone, from the gym, from the kitchen, from a hotel on a work trip. Now I capture by talking. I tell it what happened, or ask what the last month looked like, and it logs, updates, analyzes, and answers. The app didn&#8217;t die; its job got smaller and clearer. The agent is for capturing and asking from anywhere; the app is for sitting down and seeing. The lesson, if there is one, is to match the interface to the job rather than forcing a single surface to do both.</p><p>If you want the shape of it, the pieces fit like this, and I'll walk through the full build in a follow-up. At the center is one small database, a single file that holds everything: the workouts, the readings, the sleep, the medication log. Everything else is a way in or a way to look. The skills are short, named routines the agent already knows: one delivers the day's workout with the progressive overload already worked out; another reads my shorthand reply and files it; a third scores a sleep note against the plan. An MCP is the bridge that lets the agent actually reach things, the database and Telegram itself, rather than just talk about them. Channels and Telegram are how I reach the agent from anywhere. And the web app reads that same file, so what I capture by talking shows up in the charts I sit down to read. One record, a few skills, one bridge, two front doors. That's the whole machine, and none of it is exotic.</p><p>Pull back, and the story is bigger than my household. A good personal trainer runs $50 to $100 an hour; add a nutritionist, a sleep coach, and someone to keep the whole record straight, and you are past what most families spend on anything but the mortgage. A personalized, always-available picture of your health, consistent enough to actually change it, has simply never been something most people could afford. The industry sees the gap now: 2026 is the year health systems and startups race to sell you an AI health companion, with firms like BCG reporting that consumers are ready and most executives expect it to pay off (<a href="https://www.bcg.com/publications/2026/consumers-are-ready-for-ai-health-care-are-systems">BCG</a>). The difference is that you don&#8217;t have to wait for their version, rent it month-to-month, or hand your family&#8217;s most private data to a company to get it. The cost of building your own just fell to about an evening of work for someone who knows how. That is what it looks like, in concrete terms, when the cost of expertise collapses. Not a chatbot you subscribe to. A parent at a kitchen table, building the thing a care coordinator used to provide.</p><p>I have spent a lot of this newsletter on keeping your skills valuable as the work changes, and I still believe that is the foundation. But it was never the point. The point is what you do with the room it buys you. For me, so far, it has been staying strong enough to wrestle my boys for as many years as they will let me, and showing up to our appointments with something better than a guess. If you can build, the most interesting question is not how to defend your career with it. It is what you would build for the people you love. I would genuinely like to hear what that is for you.</p><div class="callout-block" data-callout="true"><p>If you&#8217;re interested in seeing the details of how I built Othellobot, like this post or drop a comment. I&#8217;ll share the setup, custom scripts, and database in an upcoming post.</p><p>I walk through the <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">Claude Architecture skills</a> needed to build real solutions like this one every Tuesday. Become a <a href="https://claudecodefornoncoders.substack.com/subscribe">paid member</a> to get full access.</p></div><p>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</p><div><hr></div><p><a href="https://claudecodefornoncoders.substack.com/">Claude Code for Non-Coders</a> publishes on <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">Tuesdays</a> and Thursdays. If you found this useful, share it with someone who&#8217;s trying to understand why their agent does what it does.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p>]]></content:encoded></item><item><title><![CDATA[Stop Treating MCP as Tools. It’s Your Architecture.]]></title><description><![CDATA[You pick MCP servers for what they do. Whether your credentials leak, your context drains, and your agent wastes tokens is decided by how you wire them in.]]></description><link>https://claudecodefornoncoders.substack.com/p/stop-treating-mcp-as-tools-its-your</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/stop-treating-mcp-as-tools-its-your</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Tue, 16 Jun 2026 12:15:24 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!OBQe!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="callout-block" data-callout="true"><p>&#128075; Welcome! I&#8217;m Daniel Williams. I write <em>Claude Code for Non-Coders</em> for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8221;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8220;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><p><em>Architecture Series &#183; Domain 2 &#183; Lesson 2.4 &#183; MCP Server Integration</em></p><p><strong>tl;dr</strong> You didn&#8217;t write the GitHub MCP server, but you wrote the config that connects it, and that config is the architecture layer where your scoping, credential, and surface decisions get enforced or quietly leak. Four decisions live there: whether to build or connect, where the config lives, what the model is allowed to call, and how the server talks to your agent. Treating any of them as plumbing is how credentials end up in your Git history, and how read-only data drains your token budget. This is Lesson 2.4 of the <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">Claude Architecture series</a>.</p><div><hr></div><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!OBQe!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!OBQe!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png 424w, https://substackcdn.com/image/fetch/$s_!OBQe!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png 848w, https://substackcdn.com/image/fetch/$s_!OBQe!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png 1272w, https://substackcdn.com/image/fetch/$s_!OBQe!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!OBQe!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png" width="1456" height="971" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:971,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:120034,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202272122?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!OBQe!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png 424w, https://substackcdn.com/image/fetch/$s_!OBQe!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png 848w, https://substackcdn.com/image/fetch/$s_!OBQe!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png 1272w, https://substackcdn.com/image/fetch/$s_!OBQe!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F13355253-dc91-4629-a943-77a7f35b4a1f_1800x1200.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>On June 30, the HTTP+SSE transport that a generation of remote MCP servers were built on goes dark, fifteen months after the protocol spec deprecated it. None of those servers changed. The people who connected them all have to. This is the lesson Domain 2 has been pointing to since L2.1: the agent reliability you keep wishing for is sitting in the surfaces you wrote and can edit, and this week the surface is the integration config that most builders paste in without reading.</p><p>When I look at how most people wire these servers up, the pattern is the same: the server is fine, the config is the liability. Credentials sitting in a version-controlled file. Read-only data exposed as tools, billing the context window on every turn. A transport line that&#8217;s about to break. The full lesson below walks through the four decisions that live in that config, why each one is an architecture decision rather than a setup decision, and what getting them wrong costs you as the model and the price tier underneath you keep moving.</p><div><hr></div><p><em>This is a paid Architecture lesson with the config patterns and examples below for subscribers.</em></p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe now&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe?"><span>Subscribe now</span></a></p>
      <p>
          <a href="https://claudecodefornoncoders.substack.com/p/stop-treating-mcp-as-tools-its-your">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Weekend Dispatch — June 13, 2026: The Free Ride for Your Agents Ends Monday]]></title><description><![CDATA[None of the frontier labs&#8217; prices are real. Token-efficient architecture is the path to sovereignty.]]></description><link>https://claudecodefornoncoders.substack.com/p/weekend-dispatch-june-13-2026-the</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/weekend-dispatch-june-13-2026-the</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Sun, 14 Jun 2026 18:15:29 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!hwzr!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/"><span>SUBSCRIBE</span></a></p><h2>The meter comes on Monday</h2><p>On June 15, Anthropic stops subsidizing your agents. Starting Monday, programmatic use splits off the flat subscription into its own metered pool: the Agent SDK, <code>claude -p</code> headless mode, and Claude Code GitHub Actions all bill against a separate credit at full API rates, $20 for Pro, $100 for Max 5x, $200 for Max 20x, none of it rolling over (<a href="https://www.techtimes.com/articles/317625/20260602/anthropic-ends-subscription-subsidy-agents-june-15-credit-pool-replaces-flat-rate-access.htm">TechTimes</a>, <a href="https://blog.vibecoder.me/anthropic-claude-subscription-billing-split-june-2026">Vibe Coder</a>). Chat, interactive Claude Code in the terminal, and Cowork stay on your plan. The unattended stuff, the cron jobs, and the SDK loops do not.</p><p>The reporting frames this as Anthropic&#8217;s third billing fix this year, and the pattern tells you what&#8217;s actually happening: agents burn compute at a rate flat-rate plans were never built to carry, and the company has stopped pretending otherwise. The subsidy was never the product. It was a customer-acquisition loss that the unit economics finally caught up to.</p><p>The hidden cost of a sloppy agent just became a visible line item. The operator who lets a sub-agent re-read the whole repo on every call, who never caps the loop, who fans out twenty tool calls where three would do, starts paying for that design Monday. I covered one lever against exactly this on Tuesday: an agent carrying too many tools with too little scoping spends tokens on calls it never needed to make (<a href="https://claudecodefornoncoders.substack.com/p/ai-prices-are-going-up-your-architecture">Lesson 2.3: AI Prices Are Going Up. Your Architecture Is Your Hedge.</a>). The operator who tightened that months ago barely notices. The meter doesn&#8217;t punish usage. It punishes architecture you never tightened.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!hwzr!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!hwzr!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!hwzr!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!hwzr!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!hwzr!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!hwzr!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/de0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:115610,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202016596?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!hwzr!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!hwzr!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!hwzr!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!hwzr!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fde0465ef-20eb-499f-8bea-d123fff89c7f_1920x1080.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>Image: subscription pool vs. metered agent pool, with the SDK/cron surfaces moving across the line</em></figcaption></figure></div><div><hr></div><h2>OpenAI is selling dollars for forty-five cents</h2><p>OpenAI is cutting token prices in the same week, and for the opposite reason. It&#8217;s bleeding share, ChatGPT&#8217;s slice of generative-AI web traffic fell from 77.6% to 53.7% in a year, with more firms on the Ramp index now paying Anthropic than OpenAI, so it&#8217;s dropping developer prices to pull enterprise back (<a href="https://cryptobriefing.com/openai-token-price-cuts-ipo/">Crypto Briefing</a>, <a href="https://startupfortune.com/openai-weighs-drastic-token-price-cuts-as-anthropic-eclipses-its-valuation/">Startup Fortune</a>). It&#8217;s doing this while running a negative 122% operating margin, losing $1.22 for every dollar it earns, eleven days after filing confidentially to go public (<a href="https://www.indexbox.io/blog/openai-considers-price-cuts-amid-rising-competition-and-financial-losses/">IndexBox</a>).</p><p>The naive read is that this is good news, cheaper tokens for everyone. Read it as what it is: a price set below cost to buy market share, by a company about to owe public shareholders a path to margin. That discount has an expiration date built into the IPO it&#8217;s filed against.</p><p>So if you architect your system around OpenAI&#8217;s subsidized June price, you&#8217;ve handed a soon-to-be-public company the dial on your cost structure. The day the road show needs to show margin, the price corrects, and your build reprices with it. That makes a cheap token you depend on a lock-in you volunteered for. Don&#8217;t chase whichever vendor is bleeding hardest this quarter; build so your design survives the day the bleeding stops.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!OuZg!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!OuZg!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!OuZg!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!OuZg!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!OuZg!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!OuZg!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/bb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:103915,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202016596?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!OuZg!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!OuZg!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!OuZg!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!OuZg!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fbb941677-5967-4b82-824f-ddbfc1870925_1920x1080.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>Image: a price tag below the cost line, with a small &#8220;IPO&#8221; fuse burning toward it</em></figcaption></figure></div><div><hr></div><h2>Sovereignty is the architecture, not the vendor</h2><p>Put the two price moves next to each other, and the lesson stops being about price at all. One lab is raising the cost of agentic compute toward its true number; the other is cutting it below cost to take share. Neither price is the real one, and building on either as if it were permanent is the mistake. The hedge that survives both is the same hedge: a token-efficient, model-agnostic architecture you can repoint without a rebuild.</p><p>This stopped being theoretical this week. Anthropic launched Fable 5 on June 9 and pulled both Fable 5 and Mythos 5 offline for all customers worldwide by June 12, complying with a Commerce Department export order while disputing its rationale (<a href="https://www.cnbc.com/2026/06/12/anthropic-disables-access-to-fable-5-and-mythos-5-after-a-us-export-order.html">CNBC</a>, <a href="https://fortune.com/2026/06/13/anthropic-disables-fable-mythos-export-controls-national-security-threat/">Fortune</a>). Seventy-two hours, flagship to dark, on one official&#8217;s letter. And the compute under Claude itself runs on hardware you don&#8217;t control: Anthropic pays xAI $1.25 billion a month for the whole of Colossus 1 in Memphis, a contract now folded inside the SpaceX entity that went public Friday (<a href="https://techcrunch.com/2026/05/20/anthropic-will-pay-xai-1-25-billion-per-month-for-compute/">TechCrunch</a>).</p><p>So sovereignty isn&#8217;t running open weights because it feels principled, and it isn&#8217;t picking the one correct model. It also isn&#8217;t free. Move your stack onto open weights to escape the meter, and the cost doesn&#8217;t disappear; it relocates: off the subscription line and onto your energy bill, the GPUs you now rent or run, and the power they pull. An agent that was wasteful on the API is just as wasteful on your own hardware, paid in kilowatt-hours instead of credits. Efficient architecture is the one variable that carries across every regime, the metered API, the subsidized one, and the self-hosted box, which is why your design, not your vendor, is what sovereignty actually rests on. The test is whether your system can absorb a doubled price, a vanished model, or a move to your own iron as a config change instead of a fire drill. Last week, I argued you should <a href="https://claudecodefornoncoders.substack.com/p/weekend-dispatch-the-models-went?r=3ve08">build so you can leave</a>. This week, the bill arrived twice. The operator who tightened the architecture early reads all of this as news rather than as an emergency.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!3U2_!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!3U2_!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!3U2_!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!3U2_!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!3U2_!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!3U2_!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:106874,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/202016596?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!3U2_!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!3U2_!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!3U2_!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!3U2_!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd9264808-ea45-4b56-9d26-8dad8fe25a14_1920x1080.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>Image: one app hardwired to a single API vs. a thin routing layer with swappable model backends</em></figcaption></figure></div><div><hr></div><p>New here? The build behind these dispatches lives in the paid Architecture track. Start with the map: Start Here: <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The Claude Architecture</a>.</p><p><em>Claude Code for Non-Coders publishes Tuesdays and Thursdays. Weekend Dispatch covers the week&#8217;s biggest AI developments through a builder&#8217;s lens.</em></p><div><hr></div><p><em>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</em></p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/leaderboard&quot;,&quot;text&quot;:&quot;LEADERBOARD&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/leaderboard"><span>LEADERBOARD</span></a></p>]]></content:encoded></item><item><title><![CDATA[You Don't Have Sovereign AI. You Have a Single-Layer Bet.]]></title><description><![CDATA[Sovereignty operates across compute, model, architecture, interface, & data. The US bet on concentrated; China bet on distributed. You're on one of these paths, whether you realize it or not.]]></description><link>https://claudecodefornoncoders.substack.com/p/china-didnt-wait-for-permission-to</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/china-didnt-wait-for-permission-to</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Thu, 11 Jun 2026 12:15:54 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!4bAu!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>You think you have sovereign AI because you self-host a model or run your own GPUs. You have a single-layer bet. Sovereignty isn&#8217;t a binary. It&#8217;s a spectrum across five layers: compute, model, architecture, interface, and data. No stack is fully sovereign anywhere, including China&#8217;s, including the frontier labs&#8217;, including yours. The goal isn&#8217;t 100% sovereignty; nobody has it. The goal is climbing the spectrum at each layer over time, and the path you&#8217;re climbing on, concentrated versus distributed, compounds. The layer you&#8217;re least sovereign at is where you&#8217;re actually exposed.</p><p>The U.S. bet on concentrated frontier capability: a small number of well-resourced labs, centralized compute, closed-weight models, and premium pricing. China bet on distributed infrastructure across the stack: open-weight models, compute spread across the country, integration into industrial systems, and an architecture designed for breadth rather than peak capability. Both paths exist. Both paths produce real value. The contrarian read is that the distributed path produces more innovation over time, not less, because innovation comes more from breadth of participation than from concentration of resources. That&#8217;s the structural argument underneath this piece. Most enterprise stacks haven&#8217;t recognized which path they&#8217;re on, and U.S. policy in 2022 made the same mistake: it treated sovereignty as a single-layer binary.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!4bAu!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!4bAu!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png 424w, https://substackcdn.com/image/fetch/$s_!4bAu!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png 848w, https://substackcdn.com/image/fetch/$s_!4bAu!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png 1272w, https://substackcdn.com/image/fetch/$s_!4bAu!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!4bAu!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:567819,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/198329458?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!4bAu!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png 424w, https://substackcdn.com/image/fetch/$s_!4bAu!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png 848w, https://substackcdn.com/image/fetch/$s_!4bAu!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png 1272w, https://substackcdn.com/image/fetch/$s_!4bAu!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a3a2527-987c-4da1-8c5f-8362a8c1ff48_2000x1125.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>What China Built on the Distributed Path</h2><p>In October 2022, the Biden administration imposed semiconductor export controls aimed at slowing Chinese access to the chips needed for frontier AI training. The H800 restrictions followed in 2023. The Trump administration shifted its approach in 2025 toward strategic licensing of advanced chips with volume caps, a 25% tariff on advanced computing chips, anti-distillation enforcement against Chinese firms that extract capabilities from U.S. models, and direct Trump-Xi negotiations on reciprocal tech access. The mechanics changed across administrations. The underlying bet didn&#8217;t. Both bet that targeting Chinese access at the hardware layer would contain China&#8217;s rise in AI. By March 2026, the U.S.-China Economic and Security Review Commission was reporting that <a href="https://www.uscc.gov/sites/default/files/2026-03/Two_Loops--How_Chinas_Open_AI_Strategy_Reinforces_Its_Industrial_Dominance.pdf">80% of U.S. AI startups now use Chinese open-source models</a>. Qwen passed Llama in cumulative Hugging Face downloads. DeepSeek&#8217;s R1 release <a href="https://www.csis.org/analysis/deepseek-huawei-export-controls-and-future-us-china-ai-race">knocked $600 billion off Nvidia&#8217;s valuation in a single day</a>. The dependency the policy was meant to prevent ran in the opposite direction.</p><p>The export controls didn&#8217;t make China lose. They forced China onto a different path. China launched the <a href="https://www.sciencedirect.com/science/article/pii/S2095809924005058">East-Data-West-Computing initiative</a> in 2022 as a national infrastructure project. The result, four years later, is a high-speed optical network spanning 55,000 kilometers and 40 cities, organized around 8 major computing hubs and 10 data center clusters. The architecture is deliberately distributed: western regions, with four times the renewable energy capacity of eastern ones, handle AI training and batch inference. Eastern hubs handle low-latency applications. Compute moves to where the power is, not the other way around. The choice isn&#8217;t only an environmental one. It&#8217;s an architectural commitment to a system that can&#8217;t be controlled at a single point.</p><p>Above the compute layer, the open-weight model strategy did what the export controls were designed to prevent. Alibaba&#8217;s Qwen, DeepSeek, Moonshot AI&#8217;s Kimi, MiniMax, and ByteDance&#8217;s Doubao all reached near-frontier capabilities without the chip access that U.S. policy was trying to deny. Each is open-weight, deployable on whatever compute is available, and substantially cheaper to run than closed-weight U.S. equivalents. Cost per inference <a href="https://qz.com/ai-us-china-open-models-deepseek-qwen">runs between one-sixth and one-fourth of frontier U.S. rivals</a>. The 80% adoption number among U.S. startups isn&#8217;t an ideological choice. It&#8217;s a price-performance choice, and the architecture choice flowed from the constraint that produced it.</p><p>Down at the application layer, China is integrating AI into smart factories, supply-chain optimization, and public infrastructure. The Ordos region of Inner Mongolia was transformed from a ghost city into a renewable-energy and computing hub. The deployment pattern is industrial rather than consumer Internet. The U.S. concentration plays out in coastal tech metros and white-collar software products. The Chinese distribution system operates across manufacturing, logistics, and public services nationwide. The two paths produce different kinds of growth: knowledge-work productivity in one, industrial throughput in the other. The asymmetry compounds over time.</p><h2>The Sovereignty Spectrum Across Five Layers</h2><p>Sovereignty operates on a spectrum, not a binary, and it exists across five layers. No stack is fully sovereign anywhere. China still depends on TSMC for some chip production. The U.S. labs depend on Nvidia, which depends on TSMC, which depends on ASML. Every enterprise depends on something it doesn&#8217;t control. The question isn&#8217;t whether you&#8217;re sovereign or not sovereign. It&#8217;s how high on the spectrum you are at each layer, and which layer has the most room to climb.</p><p><strong>Compute</strong> is commoditizing fast. Distributed networks, alternative chip strategies, multi-provider routing, and small-model local inference are all spreading. Five years from now, compute sovereignty will be table stakes rather than a source of differentiation. The China example proves you can build a competitive AI economy without owning the leading-edge chip; the U.S. example proves you can build it with one. The compute layer is becoming a substrate you choose between rather than a moat anyone holds.</p><p><strong>Model</strong> is commoditizing too, faster than most U.S. enterprises expected. Open-weight models catch up to frontier capabilities in months. Switching costs are dropping. Qwen passing Llama in downloads is one data point; the larger pattern is that no model lead lasts as long as the previous one did. Frontier capability is still real, and there are still tasks where the latest closed-weight model produces meaningfully better output. But that lead is shrinking on a clock measured in releases, not years. Building a stack that assumes you can swap models is a stronger architectural position than building one that assumes you can&#8217;t.</p><p><strong>Architecture</strong> is the layer where most of the recent CC4NC writing has lived. MCP, hooks, deterministic specifications, the Outcome Engineer test, and agent portfolio governance. These patterns are becoming public knowledge as fast as they&#8217;re being developed. Compliance is folding into architecture, and outcome specification is one of the most important skills to acquire. The architecture layer is becoming a commodity because the patterns are no longer secret. Sovereignty here is about whether you&#8217;ve implemented the patterns, not whether you can name them.</p><p><strong>Interface</strong> is converging on open standards. Headless platforms, MCP, portable agents, vendor-neutral protocols. Salesforce launched <a href="https://www.salesforce.com/news/stories/salesforce-headless-360-announcement/">Headless 360</a> in April, featuring 60-plus MCP tools and 30-plus coding skills, and working with Claude Code, Cursor, Codex, and Windsurf. The pitch from Parker Harris was direct: &#8220;Why should you ever log into Salesforce again?&#8221; Notion <a href="https://www.notion.com/releases/2026-05-13">shipped its developer platform on May 13</a> with Workers, Database Sync, an External Agents API, and a CLI for coding agents. <a href="https://newsroom.servicenow.com/press-releases/details/2026/ServiceNow-opens-its-full-system-of-action-to-every-AI-Agent-in-the-enterprise/default.aspx">ServiceNow opened its MCP Server</a> to any AI agent, including ones a customer brings. Atlassian Rovo, Snowflake Cortex, and HubSpot have all added MCP access. The interface war that seemed set to be fought among Agentforce, Notion AI, Now Assist, and the frontier-lab agents is being settled by openness instead. The platforms went headless because customers chose Claude and ChatGPT over their own agents. Holding the interface didn&#8217;t matter if the agent battle was lost; what mattered was holding the data relationship.</p><p><strong>Data</strong> is the layer that will matter most in five years, and it&#8217;s where the spectrum gets the most interesting. When it&#8217;s fresh, unique, and tied to ongoing operations, data doesn&#8217;t commoditize the way compute, models, architecture, and interface do. Your customer interactions this quarter, your operational telemetry from the last month, your domain context that nobody else has access to: these are yours alone and can&#8217;t be reproduced. Stale data, public data, or data that&#8217;s been published or leaked does commoditize. The advantage isn&#8217;t &#8220;data&#8221; generically; it&#8217;s the data that stays fresh, proprietary, and operationally meaningful. Below that threshold, data is just another resource that can be sourced elsewhere.</p><p>The SaaS market is learning and executing on this in real time. The platforms went headless at the interface layer specifically because they recognized the data layer is the moat they actually hold. Salesforce, Notion, ServiceNow, and the rest will lose the agent battle. That&#8217;s already happened. They&#8217;re betting they can keep the data relationship by exposing it through MCP rather than locking it behind a proprietary chat UI. From the customer&#8217;s perspective, this is a mid-spectrum move: you can now bring your own agent to data that lives on the vendor&#8217;s infrastructure. You&#8217;ve climbed the spectrum at the interface layer. You haven&#8217;t climbed it at the data layer, because exit costs are real, the vendor controls the MCP surface, and the data is still hosted somewhere you don&#8217;t own.</p><p>The mistake to avoid: don&#8217;t confuse &#8220;I can bring my own agent&#8221; with &#8220;I have data sovereignty.&#8221; Bringing your own agent is the interface-layer win. Owning and hosting your data is the data-layer climb, and most enterprise stacks haven&#8217;t started it. Five years from now, when the other four layers are commodities, the question every senior person reading this will be answering is whether their organization&#8217;s data still lives on infrastructure they don&#8217;t control.</p><p>Accenture&#8217;s recent <a href="https://www.accenture.com/us-en/insights/digital-transformation/sovereign-ai">Sovereign AI: Own Your AI Future</a> report quantifies the gap. A survey of 1,928 organizations across 28 countries found 60% have applied sovereignty oversight to data, 46% to infrastructure, 35% to security and governance, 32% to applications, and just 22% to AI models. The data and infrastructure work is underway. The model and application layers, where AI-era sovereignty actually lives, are where most enterprises haven&#8217;t started.</p><h2>The GPU-Poor Paradox</h2><p>The intuition is that more resources buy more sovereignty: GPU-rich means you self-host, GPU-poor means you&#8217;re API-dependent. The actual dynamic runs the other way. Constraint at the compute layer pushes you up the spectrum at the other four.</p><p>The GPU-poor consultant who built her stack on a frontier API, open-weight fallbacks, portable specifications, and open-standard interfaces has greater aggregate sovereignty than the GPU-rich enterprise that self-hosts one model and ties every prompt to its quirks. The consultant can swap models, change providers, port her specifications, and route work across compute substrates. The enterprise has top-spectrum compute sovereignty and bottom-spectrum sovereignty at everything else. China ran this paradox on a national scale: export controls denied access to top-spectrum compute, and the response was to climb the spectrum in the other four layers harder than they otherwise would have. DeepSeek&#8217;s $5.6M training run that knocked $600B off Nvidia&#8217;s valuation is the same paradox at the model layer: constrained access produced a leaner architecture that traveled further than the better-resourced incumbents.</p><p>I run this newsletter, and most of my clients work with Claude, a frontier model from a U.S. lab. Frontier models do things that distributed alternatives still can&#8217;t, and any senior practitioner who pretends otherwise is selling something. The argument isn&#8217;t that the concentrated path produces nothing; it&#8217;s that the concentrated path has a shorter half-life on any given lead, and the distributed path produces more participants who can build, which compounds over a longer horizon. The reader&#8217;s job is to know which path each layer of their stack is on and to climb the spectrum where the exposure is highest.</p><h2>Your Multi-Layer Sovereignty Test</h2><p>Not every workload needs to be sovereign. Accenture&#8217;s research suggests roughly one-third is the right share for most organizations; the rest can run on the global mix. The test isn&#8217;t whether you&#8217;ve made everything sovereign. It&#8217;s whether the third you have made sovereign is the right third, and whether your sovereignty score on that third matches the stakes.</p><p>Map your stack to the five layers and ask one question per layer. Each answer is graded, not binary. Aim for movement, not perfection.</p><p><strong>Compute.</strong> Do you have any leverage on substrate, or are you fully API-dependent on a single provider? </p><ul><li><p>Low-spectrum is a single compute provider, whether it be local inference, public cloud, or frontier lab.</p></li><li><p>Mid-spectrum looks like multi-provider routing, fallback compute, and local inference for some workloads. </p></li><li><p>High-spectrum looks like the ability to move workloads across providers and substrates without rebuilding your stack.</p></li></ul><p><strong>Model.</strong> Can you swap to a different model and keep working? </p><ul><li><p>Low-spectrum is prompts tightly coupled to one model&#8217;s quirks. </p></li><li><p>Mid-spectrum is portable specifications that work across closed-weight providers. </p></li><li><p>High-spectrum is specifications that survive a swap from closed to open-weight, or from a U.S. lab to a Chinese one, without the output collapsing.</p></li></ul><p><strong>Architecture.</strong> Is your specification layer (context, hooks, MCP, skills, agent portfolio governance) something you own, or is it locked to a vendor&#8217;s tools? </p><ul><li><p>Low-spectrum is a stack built inside one vendor&#8217;s frameworks. </p></li><li><p>Mid-spectrum is patterns you&#8217;ve implemented yourself but haven&#8217;t tested against different runtimes. </p></li><li><p>High-spectrum is an architecture that survives a runtime swap because the patterns are vendor-neutral.</p></li></ul><p><strong>Interface.</strong> Can users and agents reach your system through open standards, or is access mediated by a proprietary UI? </p><ul><li><p>Low-spectrum is vendor-locked chat surfaces. </p></li><li><p>Mid-spectrum is MCP access alongside the vendor&#8217;s UI. </p></li><li><p>High-spectrum is open-standard access with the vendor&#8217;s UI as one option among many.</p></li></ul><p><strong>Data.</strong> Do you own and host your data, or does your operational data live in third-party platforms you can read but not control? </p><ul><li><p>Low-spectrum is customer and operational data trapped in SaaS platforms with real exit costs. </p></li><li><p>Mid-spectrum is MCP access to that data, plus active export pipelines you maintain. </p></li><li><p>High-spectrum is data you own, host, and can move without permission. This is the layer I believe will see ROI grow over time.</p></li></ul><p>Find your lowest-spectrum layer. That&#8217;s the exposure. The highest-leverage move this quarter is to climb that layer one notch.</p><h2>What This Asks of You</h2><p>The U.S. didn&#8217;t lose. The export controls produced an unintended outcome at the national scale, and the same single-layer error is being made in most enterprise stacks right now. You&#8217;re not sovereign because you self-host. You&#8217;re not sovereign because you run open-weight. You&#8217;re not sovereign because you can bring your own agent to a SaaS platform. You&#8217;re sovereign to the extent that you can move at each of the five layers when the conditions change, and the path you&#8217;re on determines how durable that movement is. The concentrated path produces real capability and real fragility. The distributed path produces breadth and the patience that compounds.</p><p>The exercise to run this quarter: pick the layer where your sovereignty score is lowest and identify the highest-leverage move to climb it one notch. If it&#8217;s data, start an export pipeline from the SaaS platform that holds most of your operational data. If it&#8217;s an interface, integrate MCP access into a single system that&#8217;s currently locked into a vendor UI. If it&#8217;s compute, set up multi-provider routing for one workflow. The move doesn&#8217;t need to be all-or-nothing. The point is to start the climb at the layer where you&#8217;ve been most exposed.</p><p>China didn&#8217;t wait for permission to build sovereign AI. The export controls made sure of it. Your path is being decided right now, whether you know it or not. The good news is that the decision is yours, and the climb is achievable. The bad news is that the layer where you&#8217;ve been least sovereign is the one most likely to determine where you end up.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe now&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe?"><span>Subscribe now</span></a></p><div><hr></div><p>The portable layer this piece is about, the config you can hand to a different model tomorrow, is the paid build: <strong><a href="https://claudecodefornoncoders.substack.com/p/stop-treating-mcp-as-tools-its-your">Stop Treating MCP as Tools. It's Your Architecture</a>.</strong> New here? Start with the map: <strong><a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The Claude Architecture Series</a></strong>.</p><p>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</p><p><a href="https://claudecodefornoncoders.substack.com/">Claude Code for Non-Coders</a> publishes on Tuesdays and Thursdays. If you found this useful, share it with someone whose stack is on one path or the other.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/leaderboard&quot;,&quot;text&quot;:&quot;Leaderboard&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/leaderboard"><span>Leaderboard</span></a></p><p></p>]]></content:encoded></item><item><title><![CDATA[AI Prices Are Going Up. Your Architecture Is Your Hedge.]]></title><description><![CDATA[Lesson 2.3: Your agent has too many tools and not enough scoping. Tool architecture discipline is one of your levers against rising token costs.]]></description><link>https://claudecodefornoncoders.substack.com/p/ai-prices-are-going-up-your-architecture</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/ai-prices-are-going-up-your-architecture</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Tue, 09 Jun 2026 12:15:04 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!5nHS!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<blockquote><p>&#128075; Welcome! I&#8217;m Daniel Williams. I write <em>Claude Code for Non-Coders</em> for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8221;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8220;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><div><hr></div><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></blockquote><div><hr></div><p><em>Architecture Series &#183; Domain 2 &#183; Lesson 2.3 &#183; Tool Distribution &amp; </em><code>tool_choice</code></p><p><strong>tl;dr</strong> Your agent has too many tools and not enough scoping. Selection reliability is a tool architecture problem, not a model problem. The fix is fewer tools, tighter scoping, and control at the call level. As token prices rise, the architecture discipline is one of the few levers that survive every deployment choice. This is Lesson 2.3 of the <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">Claude Architecture series</a>.</p><div><hr></div><p>If your coding agent&#8217;s bill went up this quarter and you&#8217;ve been wondering whether to switch models or wait for the next price cut, the answer to both is the same. Don&#8217;t. The next model will cost more, not less. The price cuts you remember belong to a phase of the market that ended in early 2026, and they aren&#8217;t coming back on the schedule you expected.</p><p>The lever you have is the one you built into your agent&#8217;s tool surface, and most of you built it carelessly. Your agent has too many tools and not enough scoping, which is an operational failure that nearly every builder (including me) has shipped to production. It is also a budget-buster that is about to bite harder as pricing reverses. Both are architectural problems. Neither is fixed by picking the next model.</p><p>The Architecture Series has been working through Domain 2, one selection lever at a time. <a href="https://claudecodefornoncoders.substack.com/p/your-agent-picks-the-wrong-tool-its">Tool descriptions</a> tell the agent which tool to pick. Error responses specify what to do when the selected tool fails. This lesson identifies the third lever: which tools the agent gets to choose from in the first place. Get that wrong, and the first two levers cannot save you, and the budget you wrote into your AWS or Anthropic invoice cannot save you either.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!5nHS!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!5nHS!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png 424w, https://substackcdn.com/image/fetch/$s_!5nHS!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png 848w, https://substackcdn.com/image/fetch/$s_!5nHS!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png 1272w, https://substackcdn.com/image/fetch/$s_!5nHS!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!5nHS!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png" width="1456" height="816" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/b9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:816,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:89688,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/200843260?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!5nHS!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png 424w, https://substackcdn.com/image/fetch/$s_!5nHS!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png 848w, https://substackcdn.com/image/fetch/$s_!5nHS!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png 1272w, https://substackcdn.com/image/fetch/$s_!5nHS!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fb9eda5bf-687b-4c64-b54a-7d1c90781e79_1456x816.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>The Visible Cost</h2><p>The cost is already in your bill, even if you haven&#8217;t traced it back to architecture yet. A single MCP server can burn tens of thousands of tokens on tool definitions before the user types a single character. <a href="https://eclipsesource.com/blogs/2026/01/22/mcp-context-overload/">GitHub&#8217;s official MCP server alone consumes about 42,000 tokens per call</a> just for the schemas of the tools it exposes. A typical multi-server setup (GitHub for source, Slack for comms, Sentry for errors, Grafana for metrics, Splunk for logs) stacks roughly 58 tools and 55,000 tokens of definitions in your context window before the agent has heard a word of your prompt. That works out to 25-30 percent of a 200K context window spent on tools, during a call where most of the surface area was never going to be used.</p><p>Then there&#8217;s the accuracy collapse. Bloat the menu past 30 to 50 tools, and <a href="https://dev.to/nebulagg/mcp-tool-overload-why-more-tools-make-your-agent-worse-5a49">tool selection accuracy falls off a cliff: 43 percent to under 14 percent</a> in measured tests. Seven out of eight picks were wrong, on a task that should be a one-shot lookup. The agent isn&#8217;t broken. The model isn&#8217;t getting dumber. The tool surface is the bottleneck.</p><p>Most builders I talk to are running 50+ tools across stacked MCP servers without realizing how much it costs them. The bill keeps climbing. The agent keeps hesitating. The next model release will not fix either one because neither one is a model problem.</p><h2>Tool Architecture Has Three Levers</h2>
      <p>
          <a href="https://claudecodefornoncoders.substack.com/p/ai-prices-are-going-up-your-architecture">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Weekend Dispatch: The Models Went Quiet, The Money Got Loud]]></title><description><![CDATA[Opus 4.8 was a polish. SpaceX, OpenAI, and Anthropic all filed to go public inside three weeks. Early investors are cashing out of the frontier.]]></description><link>https://claudecodefornoncoders.substack.com/p/weekend-dispatch-the-models-went</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/weekend-dispatch-the-models-went</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Sat, 06 Jun 2026 12:15:19 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!j-kB!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<h2>The models went quiet</h2><p>Anthropic shipped Claude Opus 4.8 on May 28, and the notable part is how little changed. It costs the same as 4.7 ($5 per million input tokens and $25 for output), and Anthropic calls it &#8220;a modest but tangible improvement.&#8221; The headline feature isn&#8217;t power. It&#8217;s honesty: 4.8 is about four times less likely than 4.7 to let a flaw in its own code pass unremarked, and it flags its own uncertainty instead of bluffing through it (<a href="https://www.anthropic.com/news/claude-opus-4-8">Anthropic</a>). The company&#8217;s own roadmap note says the next priority is cheaper models at Opus-level capability. The leaps are becoming refinements.</p><p>For two years, the operating assumption was that the next model would be the one that changed your work. That assumption is quietly expiring. When a flagship release leads with candor about its own mistakes rather than a new capability, the frontier has stopped sprinting. I called 4.7 an advisor rather than an executor back in April (<a href="https://claudecodefornoncoders.substack.com/p/the-regression-isnt-in-the-model">the regression isn&#8217;t in the model</a>); 4.8 is the same advisor, now willing to tell you where its work is thin.</p><p>That changes the question you bring to a new model. Not &#8220;how much smarter is it,&#8221; but &#8220;is it honest enough to trust in something that matters.&#8221; Model capability has always been the story. Model trustworthiness is what we&#8217;re tracking now.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!pSaH!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!pSaH!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!pSaH!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!pSaH!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!pSaH!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!pSaH!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/da68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:81739,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/200848308?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!pSaH!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!pSaH!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!pSaH!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!pSaH!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fda68b690-90b9-4613-a70d-ec695daf4a7d_1920x1080.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><div><hr></div><h2>The money got loud</h2><p>While the models inched, the money sprinted. SpaceX filed its public S-1 on May 20 and starts trading June 12 at roughly $1.75 trillion (<a href="https://www.cnbc.com/2026/05/20/spacex-ipo-live-updates.html">CNBC</a>). OpenAI filed confidentially around May 22, targeting a September listing above a trillion dollars while still losing about $1.22 for every dollar it earns on $2 billion a month in revenue (<a href="https://www.cnbc.com/2026/05/20/openai-ipo-filing.html">CNBC</a>). Anthropic filed its own confidential S-1 on June 1, days after raising $65 billion at a $965 billion valuation (<a href="https://www.npr.org/2026/06/01/nx-s1-5843199/anthropic-ipo-filing-ai-large">NPR</a>). Three of the largest IPOs in history were queued inside three weeks.</p><p>The roadshow will sell this as acceleration. Read it the other way. Companies file to go public when the land-grab is maturing into a business that needs public capital and owes shareholders predictable returns, not when the next breakthrough is around the corner. The clearest tell came before the filings: more than 600 current and former OpenAI staff had already sold $6.6 billion in shares on the secondary market (<a href="https://www.tradingkey.com/analysis/stocks/us-stocks/261938698-spacex-openai-anthropic-ipo-valuation-ai-infrastructure-bubble-risk-liquidity-lockup-expiry-profitability-tradingkey">TradingKey</a>). The people with the best information are trimming exposure while the public message stays &#8220;we&#8217;re still early.&#8221;</p><p>I&#8217;m not telling you what to do with a brokerage account; this isn&#8217;t that newsletter. It&#8217;s a signal about the industry, not your portfolio. When the people building these companies are cashing out, be skeptical of the &#8220;we&#8217;re still early&#8221; story they&#8217;re telling everyone else.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!j-kB!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!j-kB!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!j-kB!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!j-kB!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!j-kB!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!j-kB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:126286,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/200848308?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!j-kB!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!j-kB!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!j-kB!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!j-kB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F35d679e9-f0d8-454e-8af9-8bc5c890f863_1920x1080.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><div><hr></div><h2>Build so you can leave</h2><p>If the models are commoditizing and the labs are filing to go public, the operator&#8217;s move is to make sure you can walk out the door. A trillion-dollar valuation prices in durable pricing power, and pricing power requires switching costs. The thing that erodes switching costs is open-weight models getting good enough to run yourself. DeepSeek V4 and Qwen 3.6 already turned frontier-adjacent intelligence into something you can host, and the gap to the closed models keeps narrowing. Every closed-model IPO is, underneath, a wager that open weights stay second-rate.</p><p>Sovereignty here isn&#8217;t about running open-source locally because it feels principled. It&#8217;s narrower: can you hand your architecture to a different model tomorrow without rebuilding it from scratch? If yes, the labs&#8217; pricing power doesn&#8217;t reach you. If no, you&#8217;re renting your leverage from whichever vendor you hardwired, and the rent goes up the moment public shareholders start asking for margin. Build model-agnostic now, while it&#8217;s a design choice and not a fire drill.</p><p>I&#8217;m taking this all the way on Thursday: why China didn&#8217;t wait for permission to build its own AI stack, and what model sovereignty means for the systems you&#8217;re standing up this year.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!_BO-!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!_BO-!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!_BO-!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!_BO-!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!_BO-!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!_BO-!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:93194,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/200848308?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!_BO-!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!_BO-!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!_BO-!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!_BO-!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3083a1eb-a940-4165-81d3-720411cc6369_1920x1080.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><div><hr></div><p>When the model commoditizes, the architecture is what stays yours, and that's the paid build: <strong><a href="https://claudecodefornoncoders.substack.com/p/ai-prices-are-going-up-your-architecture">AI Prices Are Going Up. Your Architecture Is Your Hedge.</a></strong> New here? Start with the map: <strong><a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The Claude Architecture Series</a></strong>.</p><p><em>Claude Code for Non-Coders publishes Tuesdays and Thursdays. Weekend Dispatch covers the week&#8217;s biggest AI developments through a builder&#8217;s lens.</em></p><div><hr></div><p><em>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</em></p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p>]]></content:encoded></item><item><title><![CDATA[Everyone Can Be a Software Engineer Now. Become Something Rarer.]]></title><description><![CDATA[Code authorship is becoming abundant. Outcome specification, precise enough that an agent executes without filling in gaps, is what&#8217;s scarce now. Most senior technical careers haven&#8217;t started the tran]]></description><link>https://claudecodefornoncoders.substack.com/p/everyone-can-be-a-software-engineer</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/everyone-can-be-a-software-engineer</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Thu, 04 Jun 2026 12:15:56 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!ZXV2!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>Earlier this year, <a href="https://nav.al/ai">Naval Ravikant made an optimistic statement</a>: &#8220;Thanks to AI, everybody can be a software engineer.&#8221; He meant it as a prediction about access and democratization, the collapse of the barrier between an idea and its execution. He&#8217;s right on the access side. He&#8217;s incomplete on the value side, and the value side is where the careers live.</p><p>If everybody can be a software engineer, software engineering is no longer the scarce skill. The thing that was the gate, the ability to translate intent into working software, is becoming abundant. When something scarce becomes abundant, the value doesn&#8217;t disappear. It moves. The question for any senior career built on the old gate is where the value moves to, and whether you&#8217;re already standing where it lands.</p><p>The role on the other side of that move now has a name. The frontier labs are calling it the Forward Deployed Engineer, paying $10K a day to deploy agents inside customer organizations. <a href="https://openai.com/index/openai-launches-the-deployment-company/">OpenAI launched a $4 billion deployment company</a> and acquired Tomoro to staff it with 150 FDEs. <a href="https://www.anthropic.com/news/enterprise-ai-services-company">Anthropic raised $1.5 billion with Blackstone and Goldman Sachs</a> for the same play. Aaron Levie at Box <a href="https://www.platformer.news/ai-job-loss-box-ceo-aaron-levie/">calls it the fastest-growing role</a> at companies like OpenAI and Anthropic. The <a href="https://claudecodefornoncoders.substack.com/">Weekend Dispatch covered the external version</a> two weeks ago: a $5.5 billion bet that the right answer for AI deployment is consultants sitting inside your company at $10K a day.</p><p>The external bet is real. It is also incomplete. External FDEs can customize the deployment, but they cannot make your team trust the system, improve your data hygiene, or capture the institutional context that determines whether the agent is solving the right problem. That work is internal. It lives with the senior person who knows what good looks like in the organization. Call it the Outcome Engineer: the person inside your company who specifies what the software should do precisely enough that the agent builds it correctly, reliably, repeatably, without continuous interpretation and correction. Becoming one is the move Naval didn&#8217;t name.</p><p>I had to become an Outcome Engineer before I knew the role existed. When I first started working seriously with coding agents, nearly every interaction was probabilistic. I would describe what I wanted, the model would interpret my intent, and something would come back: usually impressive-looking, often close to what I had in mind, but shaped by the model&#8217;s best guess about the gaps between what I said and what I meant. The output varied from session to session on the same problem. The same prompt delivered different results depending on how much context the model had, which model I was using, and what I&#8217;d said in the first ten messages of the conversation. I thought this was the nature of the tool. It is not. It was the nature of where I was in the process.</p><p>This is what practitioners now call vibe coding. You&#8217;re expressing intent and hoping the model&#8217;s interpretation of that intent is close enough to be useful. Sometimes it is. Over time, though, you notice something: the results are uneven in ways you can&#8217;t fully explain, you&#8217;re re-explaining your preferences in every session, and the impressive-looking output sometimes collapses under examination. You&#8217;ve built something that works until it doesn&#8217;t, and you can&#8217;t always tell in advance which one you got.</p><p>The transition out of that layer doesn&#8217;t happen at once. It happens as you accumulate the infrastructure that makes outcomes repeatable: briefing documents that give the model your context before you&#8217;ve typed a word, rules that encode the preferences you&#8217;d otherwise re-explain, skills that specify the exact procedure for tasks you run more than once, commands that invoke those procedures without ambiguity. None of this is about complexity. The setups I run now are simpler than the elaborate &#8220;multi-agent&#8221; architectures I built a year ago and subsequently dismantled. What they are is precise. The model doesn&#8217;t interpret; it follows. When I specify the outcome I want, I get that outcome, or I get a failure I can diagnose and correct. That&#8217;s context engineering: building the layer beneath the model that makes its behavior deterministic rather than probabilistic.</p><p>The test I use is simple. Can I hand this to a different model with similar capabilities tomorrow and get the same result? If yes, I&#8217;ve engineered the outcome. If the result depends on this specific model, this specific session, or this specific phrasing, I&#8217;m still vibe coding with better vocabulary.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!ZXV2!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!ZXV2!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!ZXV2!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!ZXV2!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!ZXV2!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!ZXV2!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/fd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:172696,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/198151080?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!ZXV2!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!ZXV2!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!ZXV2!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!ZXV2!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ffd2087cf-ba84-46c8-b489-aaea009e7aa8_1920x1080.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>The Distance Between Layers</h2><p>The career structure that felt like advancement is now the source of exposure. Software development as a profession has historically organized itself into layers of abstraction. You start writing code. As you grow more senior, you move toward reviewing code, designing systems, and managing the people who write the code. Each layer felt like an advancement: more responsibility, more distance from the implementation details. Seniority looked like an abstraction. That pattern wasn&#8217;t wrong for most of the last thirty years. It described how technical careers actually worked.</p><p>The problem is that the layers between you and value creation are now a different kind of exposure than they used to be. Each layer of seniority added distance from the output. Writing code puts you one step away. Code review added another. Managing a team that did the reviewing added a third. Each layer felt like safety, and each is now the thing that can be removed without the output stopping, because the output keeps coming regardless of who&#8217;s in the middle.</p><p>Block is the public case. In March 2025, <a href="https://www.thehrdigest.com/block-layoffs-announced-dorsey-wants-a-startup-revolution-again/">Jack Dorsey cut about 1,000 workers and explicitly demoted 200 managers</a> out of their leadership roles. In February 2026, Block announced cuts of <a href="https://fortune.com/2026/02/27/block-jack-dorsey-ceo-xyz-stock-square-4000-ai-layoffs/">roughly 4,000 jobs</a>, about 40 percent of the workforce, with the stated goal of flattening the org, building smaller and more focused teams, and mandating AI fluency in performance evaluations. Dorsey predicted most companies will make similar cuts within a year. The layers are being compressed, not from the top but from the bottom, and the people who understand this earliest have the most time to reposition.</p><p>The dynamic isn&#8217;t specific to developers. The same compression is happening at the consulting layer, where the partner whose value lies in translating client needs into project scopes is being asked to produce what the agent could have produced on its own. The product management layer is feeling it, where the PM whose value was aligning stakeholders around a roadmap is being asked whether the alignment work would survive an agent that surfaces the same options. Every layer in which the job description involves translating intent into something an agent could produce is exposed. The layer matters less than the gap between you and the outcome. If the gap is greater than zero, someone will ask whether it could be removed.</p><p>The repositioning isn&#8217;t about writing more code faster. Developers who respond to this moment by accelerating code production are running toward the disruption rather than away from it. The repositioning is about moving toward outcome specification: becoming the person who defines what the software should do, at a level of precision that an agent can execute against without filling in gaps you didn&#8217;t intend. That&#8217;s a recognition that the scarcest cognitive skill in a world where code-writing is abundant isn&#8217;t the ability to produce code. It&#8217;s the ability to specify outcomes precisely enough that the right code gets produced without continuous interpretation and correction.</p><p>The timeline on this is shorter than most developers are accounting for. The ones who are repositioning now, who are learning to work at the outcome layer, are building a durable skill while the layer below them is still in transition. The ones who wait for the transition to complete before deciding what to do about it are making a calculation that has historically not worked out well.</p><h2>The Same Destination From Two Directions</h2><p>The CC4NC reader, who has never written a line of production code, and the developer, who has spent twenty years doing exactly that, are converging on the same skill set from opposite directions.</p><p>The non-coder is arriving at outcome engineering because they&#8217;ve discovered that expressing vague intent to a coding agent produces vague results. The better they get at specifying what they want in plain language, with constraints and explicit success criteria, before the session starts, the better the output gets. They&#8217;re learning that precision in the brief is the leverage. They&#8217;re becoming Outcome Engineers without ever touching a syntax error.</p><p>The developer is arriving at the same place from the other direction. They know precisely what they want at the code level, but they&#8217;re learning that articulating that precisely enough for an agent to execute reliably, without babysitting the session, without fixing the agent&#8217;s interpretation of their intent, requires a different kind of specification than they&#8217;re used to writing. Something more like a contract with the agent: here is the outcome, here are the constraints, here is what &#8220;done&#8221; means, here is how to tell if you got it wrong before it reaches me. The specification is the work. The code is the artifact produced once the specification is sufficiently well-defined.</p><p>Aaron Levie has been describing the role for months. <a href="https://www.platformer.news/ai-job-loss-box-ceo-aaron-levie/">&#8220;You need humans to go implement this stuff inside the organization. Those are the engineers of the future, if you&#8217;re not just building software that is an application.&#8221;</a> That description maps directly to the Outcome Engineer. Levie is hiring for it externally at the frontier labs and internally at Box. Every senior technical person reading this is being hired for some version of it, whether the title catches up or not.</p><p>An Outcome Engineer is someone who can specify the target precisely enough that the gap between specification and output is not filled by the model&#8217;s best guess. It&#8217;s the same role arriving from two very different backgrounds, and the path from either direction runs through the same set of skills.</p><h2>What This Asks of You</h2><p>The transition Naval was pointing at is real on the access side and incomplete on the value side. The completed version is this: you were hired for the code you could write. You&#8217;re hired now for the outcomes you can specify well enough that an agent can produce them without filling in the gaps. The senior people who make this transition early are the ones to whom the next wave of FDE-style work falls. The ones who don&#8217;t are the ones whose layer keeps getting compressed.</p><p>The objection worth handling is that AI will eventually do outcome engineering too. The model will read the user&#8217;s mind, infer intent without specification, and fill in the gaps with judgment rather than guesses. That may come, in some narrow domains, on some timescale. It hasn&#8217;t come yet, and what is clear from current practice is that the human context, the institutional knowledge, the read on what success actually looks like for this customer, in this market, this quarter, is the part that doesn&#8217;t outsource cleanly to a model trained on the average of the internet. For now, outcome engineering is a human role that an agent executes against.</p><p>The exercise to run this week: pick one recurring task you currently do in agent sessions. Write the outcome specification, what you want, what constraints apply, what &#8220;done&#8221; means, how to tell if it went wrong, precisely enough that a fresh session with a different model would produce the same result. Then run it against a different model. The gap between what you specified and what came back is the work that remains.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe now&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe?"><span>Subscribe now</span></a></p><div><hr></div><p>Becoming the rarer thing is what the paid Architecture track teaches, end to end. New here? Start with the map: <strong><a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The Claude Architecture Series</a></strong>.</p><p>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</p><p><a href="https://claudecodefornoncoders.substack.com/">Claude Code for Non-Coders</a> publishes on Tuesdays and Thursdays. If you found this useful, share it with someone who&#8217;s still writing code instead of specifying outcomes.</p><p></p>]]></content:encoded></item><item><title><![CDATA[Your Agent Hallucinated a Recovery. Your MCP Tool's Error Response Asked for It.]]></title><description><![CDATA[Claude Architecture Series &#183; Lesson 2.2: Most error responses give your agent room to invent a recovery. Here's how to take that room away.]]></description><link>https://claudecodefornoncoders.substack.com/p/your-agent-hallucinated-a-recovery</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/your-agent-hallucinated-a-recovery</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Tue, 02 Jun 2026 12:15:11 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!ZHOW!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="callout-block" data-callout="true"><p>&#128075; Welcome! I&#8217;m Daniel Williams. I write <em>Claude Code for Non-Coders</em> for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8221;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8220;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><div><hr></div><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><p><strong>tl;dr</strong> If your tool fails and the agent recovers gracefully, you built a tool. If your tool fails and the agent hallucinates a workaround, you built a trap. The fix is structured error responses that name the error category and action, leaving no room for improvisation. This is Lesson 2.2 of the <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">Claude Architecture series</a>.</p><div><hr></div><p>If your tool fails and the agent recovers gracefully, you built a tool. If your tool fails and the agent hallucinates a workaround, you built a trap.</p><p>The trap is expensive in two stacked ways. The wasted calls alone burn through your budget as the agent retries, replans, and escalates. The higher cost is the recovery the agent invents on top of the failure, which sounds reasonable, and which the agent will run against your live system. Models are getting better at sounding reasonable. They are also getting more expensive per call, and the gap between &#8220;smarter&#8221; and &#8220;cheaper&#8221; is widening with every release. The path to keeping costs sane is not waiting for the next model. It is architecting your agent so it never has to improvise in the first place.</p><p>You have seen the trap close. A tool returned &#8220;file not found,&#8221; and the agent created the file from scratch. Or it returned &#8220;authentication failed,&#8221; and the agent looked for a different endpoint that wouldn&#8217;t require credentials. Or it returned an empty list, and the agent retried three times before escalating, convinced it had hit a transient outage when the actual story was that the customer didn&#8217;t exist.</p><p>None of those were model failures. Each one was an error response that left the agent enough ambiguity to be creative, and Claude did what coding agents do at the edges of ambiguity. It filled in.</p><p>None of those are hypothetical, either. Last July, <a href="https://fortune.com/2025/07/23/ai-coding-tool-replit-wiped-database-called-it-a-catastrophic-failure/">Replit&#8217;s AI agent deleted the production database of SaaStr founder Jason Lemkin</a> during a code freeze, wiping data on 1,200 executives and 1,190 companies. The agent later confessed it had been &#8220;panicking in response to empty queries.&#8221; The same month, <a href="https://winbuzzer.com/2025/07/26/googles-gemini-cli-deletes-user-files-confesses-catastrophic-failure-xcxwbn/">Google&#8217;s Gemini CLI overwrote a product manager&#8217;s files</a> after misinterpreting a silent <code>mkdir</code> failure as success, then admitted: &#8220;I have failed you completely and catastrophically.&#8221; In December 2025, <a href="https://fortune.com/2026/03/18/ai-coding-risks-amazon-agents-enterprise/">Amazon&#8217;s own coding agent autonomously deleted</a> and recreated a live production environment, taking AWS Cost Explorer offline for 13 hours. Different vendors. Same pattern. Each agent read an error response that did not tell it to stop and filled in what it left blank.</p><p>The job most builders think they&#8217;re doing when they format errors is &#8220;return useful diagnostics.&#8221; The job they&#8217;re actually doing is closing the gap so the agent can interpret what an error means. The error response is part of your agent&#8217;s architecture, not the leftovers after the architecture failed.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!ZHOW!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!ZHOW!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png 424w, https://substackcdn.com/image/fetch/$s_!ZHOW!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png 848w, https://substackcdn.com/image/fetch/$s_!ZHOW!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png 1272w, https://substackcdn.com/image/fetch/$s_!ZHOW!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!ZHOW!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png" width="1456" height="816" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:816,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:111955,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/200223773?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!ZHOW!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png 424w, https://substackcdn.com/image/fetch/$s_!ZHOW!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png 848w, https://substackcdn.com/image/fetch/$s_!ZHOW!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png 1272w, https://substackcdn.com/image/fetch/$s_!ZHOW!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3412e8a2-04ff-4a53-bb03-c6326dda3f74_1456x816.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Two Failures, Only One You Care About</h2><p>A <strong>protocol error</strong> occurs when the <a href="https://modelcontextprotocol.io/specification/2025-06-18/basic/transports">JSON-RPC</a> call itself fails: a malformed request, a transport timeout, or a broken pipe. The <a href="https://modelcontextprotocol.io/docs/getting-started/intro">MCP</a> transport catches these. The agent never sees them. You do not write code to handle this case.</p><p>An <strong>application error</strong> is the other thing. The tool ran, the response came back, and the operation failed logically. The customer record didn&#8217;t exist. The refund amount exceeded a threshold. The API key was rejected. The agent sees this response and decides what to do next. This is the response you write, and this is the response the agent will improvise around if you let it.</p><p>MCP gives you one flag, <code>isError: true</code>, to mark the response as an application error. The flag is necessary. The flag is not the fix. Setting <code>isError: true</code> and returning the string &#8220;something went wrong&#8221; leaves the agent exactly where it was before: trying to figure out what to do with a vague failure. The structure of the response is the fix. The flag is the envelope it comes in.</p><h2>The Four Categories</h2><p>Application errors come in four shapes, and each shape demands a different next move from the agent. Get this mapping wrong, and the agent&#8217;s behavior gets worse the harder it tries.</p>
      <p>
          <a href="https://claudecodefornoncoders.substack.com/p/your-agent-hallucinated-a-recovery">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Weekend Dispatch - May 30, 2026: AI With No Vision Is Just Chaos]]></title><description><![CDATA[The U.S. plan for AI is a slogan with no vision underneath. The same pattern shows up at every scale this week: federal AI policy, identity loss from AI displacement, and Claude for Small Business.]]></description><link>https://claudecodefornoncoders.substack.com/p/weekend-dispatch-may-30-2026-ai-with</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/weekend-dispatch-may-30-2026-ai-with</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Sat, 30 May 2026 12:15:35 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!OWuc!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="callout-block" data-callout="true"><p><strong>&#128075; Welcome! I&#8217;m Daniel Williams.</strong> I write Claude Code for Non-Coders for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8220;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8221;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:&quot;button-wrapper&quot;}" data-component-name="ButtonCreateButton"><a class="button primary button-wrapper" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!OWuc!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!OWuc!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!OWuc!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!OWuc!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!OWuc!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!OWuc!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/cf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:146409,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/199657354?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!OWuc!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!OWuc!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!OWuc!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!OWuc!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fcf5cae4a-8484-4f83-b830-381b90046cf0_1920x1080.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>Trump killed the AI safety executive order on May 22 after three CEOs called him. The U.S. is so distracted with &#8220;winning&#8221; the AI race against China that it has yet to develop a unifying vision for using AI to rebuild a decaying homeland.</h2><p>The order would have set cybersecurity standards and vetted frontier models for the companies most likely to ship the systems that need them. Zuckerberg, Musk, and Sacks called the President personally over the weekend, and by Monday, it was dead (<a href="https://www.nbcnews.com/politics/donald-trump/trump-abruptly-scraps-signing-landmark-executive-order-regulating-ai-rcna209900">NBC News</a>, Washington Post, Axios). Their argument is the standard anti-regulation line: that regulation slows U.S. competitiveness relative to China. The federal AI agenda is comprehensive on the offense side: the <a href="https://www.whitehouse.gov/fact-sheets/2025/11/fact-sheet-president-donald-j-trump-unveils-the-genesis-missionto-accelerate-ai-for-scientific-discovery/">Genesis Mission</a> (November 2025 executive order mobilizing DOE supercomputers for scientific discovery, Apollo-framed), <a href="https://www.whitehouse.gov/wp-content/uploads/2025/07/Americas-AI-Action-Plan.pdf">America&#8217;s AI Action Plan</a> titled &#8220;Winning the Race&#8221; (July 2025, ninety-plus federal actions across innovation, infrastructure, and diplomacy), the <a href="https://www.ai.gov/initiatives/presidential-challenge">Presidential AI Challenge</a> for K-12, and AI.gov as a unified portal. Every initiative is organized around that one frame.</p><p>&#8220;Winning the AI race&#8221; has never been defined in concrete terms. More powerful models than China? Owned by whom? Deployed where for what purpose? Until those answers come, &#8220;winning&#8221; is whatever the loudest CEO needs it to mean. There is nothing in the federal agenda about how AI should serve communities beyond the dominant labs, nothing about rebuilding industries that have lost their footing, nothing about who gets crushed as competition accelerates.</p><p>The &#8220;regulation kills innovation&#8221; argument collapses on inspection as well. China issued more national AI standards in the first half of 2026 than in the previous three years combined. Cybersecurity Law amendments took effect on January 1, with maximum fines increased twentyfold (from RMB 500K to RMB 10M). AI safety sits alongside pandemics and cyberattacks in China&#8217;s National Emergency Response Plan. That regulatory expansion happened while DeepSeek V4 and Qwen 3.6 shipped, 35,000 smart factories went online, and the distributed compute network expanded to 1,243 miles of fiber. Dan Wang&#8217;s <em>Breakneck</em> calls this the difference between an engineering state and a lawyerly society. China builds at scale because the state functions as an engineering project organized around a unifying vision; the U.S. has become a lawyerly society where industry and government argue over process while the energy for building atrophies.</p><p>Without that vision, the U.S. fills the vacuum with chaos and capture. PE-backed data centers run roughshod over local communities. Frontier labs (most, not all) chase consumer engagement loops and enterprise contracts where the next quarter&#8217;s revenue lives. Congress has passed no binding AI statute. The executive branch just killed the only proposed one. The judicial branch applies twentieth-century consumer protection law to twenty-first-century technology. All three branches are asleep at the wheel and ignorant of how AI could be deployed for society's benefit. The three CEOs aren&#8217;t the cause of the dysfunction, but a symptom of it. They showed up to exploit the dysfunction at the public&#8217;s expense.</p><p>A unifying vision would be specific about what AI is for, and what it isn&#8217;t. The country has problems that have caused infrastructural decay for generations: roads and bridges that should have been rebuilt twenty years ago, manufacturing capacity that hollowed out, agricultural supply chains running on aging logistics, regional health systems that can&#8217;t staff themselves, and public schools operating on twentieth-century models. AI could accelerate work on each of them. Instead of eliminating regulation, use AI to speed up compliance and validation. Environmental review, permitting, safety certification. The legal scaffolding that takes a decade on a bridge or transmission line is exactly the workload AI is good at. Builders are already doing this without federal direction. @<a href="https://notesofanomad.substack.com/">notesofanomad</a> built <a href="https://constructbuddy.textstonelabs.com/">ConstructBuddy</a> to automate county and city plan review, exactly the bottleneck that slows local infrastructure to a crawl. The same pattern applies to every permit, certification, and environmental review the country needs to speed up. The people learning to operate AI deliberately are exactly those needed to build it. The choice the killed EO presented (regulate or don&#8217;t) is a false binary. The real choice is developing innovative AI solutions that comply with regulation while delivering value at the speed the country, society, communities, and its people actually need.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!FlNz!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!FlNz!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!FlNz!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!FlNz!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!FlNz!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!FlNz!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:141156,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/199657354?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!FlNz!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!FlNz!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!FlNz!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!FlNz!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2a90f8b7-d5d1-4a2c-9832-3c6c57725796_1920x1080.png 1456w" sizes="100vw"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>Side-by-side 2026 timeline (China AI standards rollout vs. U.S. AI executive order pulled)</em></figcaption></figure></div><div><hr></div><h2>Dan Haylett&#8217;s piece on the hidden losses of retirement is the most accurate description anyone has written of what AI displacement does to senior technical professionals a decade early. Retirement has thirty years of vocabulary for this graveyard. AI displacement has none.</h2><p>I found <a href="https://substack.com/home/post/p-196646169">Dan Haylett&#8217;s piece</a> from May 6 very interesting. Retirement, in Haylett&#8217;s phrase, isn&#8217;t one loss; it&#8217;s &#8220;ten things in a trench coat&#8221;: identity, status, mastery, tribe, structure, progress, stimulation, purpose, validation, the future tense itself. The financial industry sells retirement as a destination of freedom and choice. Haylett, who plans retirements for a living, calls it a five-year graveyard most people walk into with no emotional preparation at all.</p><p>Those losses describe AI displacement exactly. They&#8217;re what gets stripped from a senior technical professional when a transformation program closes their role at fifty-five. Block&#8217;s restructuring this spring cut 4,000 jobs and demoted 200 managers as part of a 40% workforce reduction. No retirement parties, no gold watches, no language at all. The retirement industry has a thirty-year vocabulary for what these professionals are about to feel. The AI displacement industry has none. Same losses, different rituals, no support on the other side.</p><p>Haylett gives flourishing retirees four operator disciplines:</p><ul><li><p><strong>name losses out loud</strong>, </p></li><li><p><strong>build a self that isn&#8217;t subcontracted to your job title</strong>, </p></li><li><p><strong>find new tribes on purpose</strong>, </p></li><li><p><strong>invent your own nexts</strong></p></li></ul><p>These overlap almost exactly with what this newsletter has been teaching senior technical professionals through the AI transition. The fifth one, <strong>learn to spend</strong>, is retirement-specific. The first four are the operator-discipline that this newsletter has been arguing for. Haylett&#8217;s clients start the work at sixty-five. The CC4NC reader can start much earlier.</p><p>If you&#8217;re a senior technical professional reading this, you&#8217;re walking toward one of two graveyards. The retirement version is well-documented; Haylett can name every loss and give you the playbook. The AI displacement version is the same loss inventory arrived at involuntarily, in a culture that doesn&#8217;t yet have rituals for what&#8217;s actually happening to you. The work of building the self that survives both is the same work. Starting early in your career with intent beats starting at sixty with regret.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!t9uX!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!t9uX!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!t9uX!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!t9uX!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!t9uX!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!t9uX!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:89170,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/199657354?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!t9uX!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!t9uX!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!t9uX!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!t9uX!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7bb5c2c4-dee2-40e2-a61a-b7bcf75cc36e_1920x1080.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>Side-by-side diagram (Retirement losses, well-documented &#183; AI displacement losses, unnamed)</em></figcaption></figure></div><div><hr></div><h2>Even a planned exit walks through Haylett&#8217;s graveyard. I planned mine for nine years, executed it at 45 in August 2024, and still spent eighteen months hedging on what I had become.</h2><p>The plan started in 2015. My wife left her data engineering job in 2020 to homeschool our sons full-time. I left mine four years later. By every spreadsheet measure, this was a textbook deliberate transition. I still walked into every one of Haylett&#8217;s ten losses.</p><p>The texts from former colleagues thinned to nothing within six months. I started introducing myself as a &#8220;semi-retired consultant,&#8221; then a &#8220;fractional executive,&#8221; then an &#8220;advisor.&#8221; While technically accurate, none of them described who I had become and my transition from nearly 25 years as a consultant to who I am today: a writer. But &#8220;writer&#8221; felt exposed in a way that &#8220;consultant&#8221; never had, so I hedged for over a year.</p><p>The evidence slowly built over time. Seventy-plus published pieces. Thirty-three thousand subscribers who showed up for the writing, not the consulting. A backlog of pieces I couldn&#8217;t stop adding to. My wife noted I was less stressed than I&#8217;d been in twenty+ years of consulting. The honest description (&#8221;I am a writer&#8221;) was always available. I needed time to let go of my former identity to say it out loud.</p><p>If you&#8217;re a senior technical professional planning your own exit (or being shoved through one by an AI rollout you didn&#8217;t choose), phase 1 is planning the exit itself. Phase 2 is the hedging that comes after: the year-plus you spend introducing yourself as something you used to be, and the work of defining your new identity. That&#8217;s the part Haylett can&#8217;t fully prepare you for because you have to walk through it to know. Start naming what you&#8217;re becoming now, before the exit forces the question.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!JQfG!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!JQfG!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!JQfG!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!JQfG!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!JQfG!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!JQfG!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:97733,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/199657354?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!JQfG!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!JQfG!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!JQfG!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!JQfG!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4e72a2cb-6b9b-4de7-add9-e553cfad503a_1920x1080.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>My journey, from &#8220;consultant &#8594; writer&#8221;</em></figcaption></figure></div><p></p><div><hr></div><h2>Anthropic launched Claude for Small Business on May 13. Day-one demos are easy and real. The durable value requires the same operator-discipline work enterprises have been failing at for two years: clean data underneath and deliberate choices about which processes, friction points, and problems are actually worth automating.</h2><p><a href="https://www.anthropic.com/news/claude-for-small-business">Claude for Small Business</a> ships with fifteen agentic workflows and fifteen skills across finance, sales, marketing, and operations. The connector list is comprehensive: QuickBooks, PayPal, HubSpot, Canva, DocuSign, Google Workspace, and Microsoft 365. The promised use cases are real: payroll planning that reconciles QuickBooks with incoming PayPal payments, monthly close that reconciles books against settlements, lead triage from HubSpot, and campaign performance analysis. I&#8217;ve connected my stack and automated about half of my finance processes. The demo works.</p><p>The day-one demo is not the durable value. The durable value requires two pieces of operator work, which the announcement leaves to the owner. First, the data substrate has to support what the workflows assume. A QuickBooks account where invoices have been categorized inconsistently for three years produces a reconciliation that doesn&#8217;t reconcile. A HubSpot deal pipeline where half the records are missing close dates produces a triage that triages nothing. Second, the owner has to pick which of the fifteen workflows are actually worth running against their specific business. Not every workflow fits every owner. The friction points that matter (where time is bleeding, where errors cost money, where the owner&#8217;s judgment is being applied to work an agent could carry) are the ones to automate. Toggling everything on and hoping for productivity is the SMB version of the enterprise AI buildouts that haven&#8217;t shown bottom-line impact.</p><p>McKinsey and HBR have been naming this same problem at the enterprise level for two years. The State of Organizations 2026 report and the Last Mile diagnosis both land on the same conclusion: 88% of organizations deploy AI somewhere, 86% of leaders aren&#8217;t ready to embed it in day-to-day operations, and the productivity gains get reabsorbed into low-value work because nobody redesigned the roles, the substrate, and the workflow to target the freed time. Claude for SMB is that problem at smaller scale and lower price. Twenty dollars a month for Claude Cowork is cheap; the operating-discipline cost to extract recurring productivity from it is the same shape of work the enterprise has been trying to crack.</p><p>CC4NC has been <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">teaching</a> this same pattern at the code level. The tool can&#8217;t outperform the operating discipline that fed it data and chose its targets. The architecture you build over time (clean data, documented processes, deliberate choices about which workflows actually solve your real problems) is what makes the AI work or fail. The agents amplify what&#8217;s there. They don&#8217;t fix what isn&#8217;t.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!e80r!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!e80r!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!e80r!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!e80r!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!e80r!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!e80r!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:112661,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/199657354?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!e80r!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!e80r!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!e80r!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!e80r!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd718bbae-c44d-42c8-883f-5d0fd52859ca_1920x1080.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>Day-1 demo vs. durable value (quick wins vs. operator-discipline substrate)</em></figcaption></figure></div><div><hr></div><p><em>Claude Code for Non-Coders publishes Tuesdays and Thursdays. Weekend Dispatch covers AI developments that I find interesting and typically share with friends and family.</em></p><div><hr></div><p><em>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</em></p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/leaderboard&quot;,&quot;text&quot;:&quot;LEADERBOARD&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/leaderboard"><span>LEADERBOARD</span></a></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Claude Code for Non-Coders is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[Your AI Compliance Story Is a Shaky Scaffold of Strongly-Worded Prompts. Wire the Architecture Around It.]]></title><description><![CDATA[You&#8217;re accountable for AI you built, AI you bought, and AI you inherited. The architectural standards don&#8217;t change with the source.]]></description><link>https://claudecodefornoncoders.substack.com/p/your-ai-compliance-story-is-a-shaky</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/your-ai-compliance-story-is-a-shaky</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Thu, 28 May 2026 12:15:36 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!9JR6!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="callout-block" data-callout="true"><p><strong>&#128075; Welcome! I&#8217;m Daniel Williams.</strong> I write Claude Code for Non-Coders for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8220;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8221;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:&quot;button-wrapper&quot;}" data-component-name="ButtonCreateButton"><a class="button primary button-wrapper" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><p>On April 28, a Cursor AI agent running Claude Opus 4.6 <a href="https://zenity.io/blog/current-events/ai-agent-database-deletion-pocketos">deleted PocketOS&#8217;s production database in nine seconds</a>. It found an unscoped Railway CLI token, guessed at an API call, and wiped prod plus three months of backups. The agent&#8217;s post-mortem, when asked to explain itself, was a confession: it had violated its own instructions, guessed rather than verified, and acted without being asked.</p><p>That was the second such incident in a year. A <a href="https://fortune.com/2025/07/23/ai-coding-tool-replit-wiped-database-called-it-a-catastrophic-failure/">Replit agent did the same thing in July 2025</a>, taking out a SaaS company&#8217;s live database during a code freeze and wiping data for over 1,200 executives and 1,190 companies. Both agents apologized in their post-mortems. In both cases, the only thing standing between the agent and the destructive action was the instructions written into the prompt. The instructions weren&#8217;t the constraint they appeared to be.</p><p>Across the agent ops engagements I&#8217;m taking on right now, the same pattern shows up on a smaller scale. Agents behave inconsistently in exactly the situations that require consistency: revenue, expenses, employee and customer data, and regulatory actions. The agents do the work correctly most of the time, and &#8220;most of the time&#8221; is the problem. That&#8217;s not a model failure. It&#8217;s the absence of architecture around the model.</p><p>You are accountable for the AI you built, the AI you bought, the AI inside platforms you don&#8217;t operate, and the AI a colleague built and handed off. The architectural standards you would apply to your own builds apply to all of it. The criteria for what counts as a real control don&#8217;t change because the source changed. Wire the architecture around the AI, or pay the tax when the agent runs the wrong command on the wrong day.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!9JR6!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!9JR6!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!9JR6!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!9JR6!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!9JR6!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!9JR6!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/e57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:196836,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/197232175?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!9JR6!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!9JR6!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!9JR6!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!9JR6!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fe57e9358-9a3f-430e-aa4e-e5112ad94238_1920x1080.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>The Collapse</h2><p>Two things made the build/buy distinction useful in the pre-AI era. Building was expensive, so most companies bought what they didn&#8217;t have time or expertise to build. And the things you bought came with vendor responsibility, since the vendor had built the thing and you were renting their architecture.</p><p>AI broke both. Building agents and policy enforcement is now cheap enough that the company that wouldn&#8217;t have built its own ERP in 2015 will build its own AI compliance layer in 2026. The vendors selling AI features are increasingly admitting in the fine print that their models' behavior is non-deterministic and that the customer bears the residual risk.</p><p>The May 7 piece in this newsletter named one consequence of the shift: the tolerance for non-builders is shrinking, especially at mid-to-senior levels. The architecture and risk angle are the operational versions of the same trend. &#8220;I&#8217;m just buying it&#8221; was a defensible position when the seller carried the risk. The contracts and the regulators are moving the risk back onto the buyer, and the only way to manage that risk is to become the person who can architect real policy enforcement around the AI you didn&#8217;t write.</p><h2>The Four Sources</h2><p>The AI in your portfolio comes from four sources. You wrote some of it: agents, scripts, and prompt chains your team built in-house. You bought some of it: enterprise accounts at frontier labs and domain-specific SaaS tools with built-in AI features. Some lives inside platforms you don&#8217;t control, like Salesforce Einstein, ServiceNow Now Assist, and the AI features being added to every enterprise app your company already uses. And some came from a colleague who shipped a prototype and walked away, leaving scripts and automations running in production with no current owner.</p><p>Each of these is a different surface. The lens you use to assess them doesn&#8217;t change because the surface changed. The same questions a builder would ask about their own agent before shipping it apply to every surface above. The work of asking those questions is what most organizations are skipping for the bought, embedded, and inherited surfaces, because the assumption is that someone else has answered them. They haven&#8217;t, or they&#8217;ve answered them in ways that don&#8217;t survive contact with reality.</p><h2>How You Look at an AI Surface</h2><p>Four questions decide whether a given AI surface is architecturally sound. <strong>Where does the policy live?</strong> If it lives in a prompt, you have <em>a behavior</em>. If it lives in code that runs before the action ships, you have <em>a control</em>. The second question is <strong>what happens when something goes wrong.</strong> That covers two cases: a user trying to bypass the policy, and the agent itself making an autonomous decision under stress. The Cursor and Replit agents weren&#8217;t attacked; they violated their instructions on their own. In both cases, &#8220;the model won&#8217;t&#8221; isn&#8217;t an answer; &#8220;the policy code rejects the attempt and logs it&#8221; is. The third is <strong>how you would demonstrate this control under pressure, whether to an auditor, a board member, or an incident reviewer.</strong> Pointing at a system prompt produces a soft control at best. Pointing at a code path and a test suite that exercises it produces something real. The last question is the hardest: <strong>is the failure rate zero, or is it &#8220;we haven&#8217;t seen it yet&#8221;?</strong> Models are non-deterministic, which means a prompt-only control&#8217;s worst-case behavior is your worst-case exposure, multiplied by your traffic.</p><p>Microsoft&#8217;s <a href="https://techcommunity.microsoft.com/blog/linuxandopensourceblog/agent-governance-toolkit-architecture-deep-dive-policy-engines-trust-and-sre-for/4510105">Agent Governance Toolkit</a> quantifies the difference. In their red-team testing, prompt-based safety (&#8220;please follow the rules&#8221;) resulted in a 26.67% policy violation rate. Deterministic application-layer enforcement produced 0.00%. Same agents. Same scenarios. The 26-point delta is the gap between a behavior and a control. SOC 2, the framework most enterprise software is measured against, assumes controls work the traditional way: documented, tested at a point in time, and effective until intentionally changed. AI delivers none of that natively. The framework expects a control; the agent produces a behavior. The gap is yours to close.</p><p>Most vendor pitches conflate behaviors and controls. The language gives them away.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!3tgy!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!3tgy!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png 424w, https://substackcdn.com/image/fetch/$s_!3tgy!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png 848w, https://substackcdn.com/image/fetch/$s_!3tgy!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png 1272w, https://substackcdn.com/image/fetch/$s_!3tgy!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!3tgy!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png" width="1350" height="668" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:668,&quot;width&quot;:1350,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:129099,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/197232175?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!3tgy!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png 424w, https://substackcdn.com/image/fetch/$s_!3tgy!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png 848w, https://substackcdn.com/image/fetch/$s_!3tgy!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png 1272w, https://substackcdn.com/image/fetch/$s_!3tgy!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4edc6400-1523-46d7-9a39-edc94f324daa_1350x668.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p>The right-hand column is what a control looks like. The left-hand column is what a behavior looks like. Behaviors are useful. They are not controls. A control survives an adversary. A behavior survives only the well-behaved user. The Cursor agent that wiped PocketOS in nine seconds had an instruction not to run destructive commands; its post-mortem read: &#8220;I violated every principle I was given. I guessed instead of verifying. I ran a destructive action without being asked. I didn&#8217;t understand what I was doing before doing it.&#8221; The instructions were real. The constraints weren&#8217;t.</p><h2>Compliance Is Becoming Agent Architecture</h2><p>The cost of treating bought or inherited AI as architecturally separate from your own builds shows up in three places, all of which end up on your desk. Production incidents arrive on inherited systems first; the prototype someone shipped six months ago and abandoned is still running, still talking to customers, still capable of producing outputs nobody thought to gate. Then there are the vendor failures you inherit by contract. The breach happens at the vendor, the data was yours, and the regulator calls you. And there are the audit and incident reviews, where the control on paper turned out to be &#8220;the vendor said so.&#8221; Third-party assertion isn&#8217;t evidence of a control, and the reviewer doesn&#8217;t accept it. The <a href="https://captaincompliance.com/news/the-delve-scandal-fake-soc-2-audits-open-source-code-theft-and-exit-from-y-combinator/">Delve scandal in March 2026</a> made that failure mode public: a Y Combinator-backed compliance automation startup was generating SOC 2 reports where 493 out of 494 were nearly identical, with the same paragraphs and the same grammatical errors across hundreds of customers. Y Combinator asked Delve to leave the program. Every customer who pointed at their Delve-generated badge as evidence of a control now has the same problem: the badge wasn&#8217;t backed by a control. It was backed by a behavior of the vendor&#8217;s documentation generator. Contractual indemnification doesn&#8217;t close the gap. The vendor can carry contractual liability; only the buyer can carry the architectural kind, and a regulator looking at the actual control mechanism doesn&#8217;t accept &#8220;we have indemnification&#8221; as evidence of one.</p><p>Shadow AI breaches cost an average of <a href="https://www.reco.ai/blog/ai-and-cloud-security-breaches-2025">$4.63 million per incident, roughly $670,000 higher than breaches without AI involvement</a>. 77% of employees paste data into GenAI tools, and 22% of those pastes contain PII or PCI. The AI surface in your organization is bigger than your architecture knows about, and the gap between those two surfaces is where the cost lives.</p><p>This is what it looks like when compliance becomes architecture. The function that used to live in vendor management and compliance team budgets is folding into the work on your desk because non-deterministic agents can&#8217;t be governed through vendor-managed badging. The May 14 piece described judgment as the new scarce resource and the asymmetry opening up between people whose judgment is sharpest and people whose output was their differentiator. The architectural version of that asymmetry is the gap between senior people who can run this assessment and senior people who can&#8217;t. Forrester&#8217;s layoff regret data tracks one symptom: the people who came back were AI architects, not AI consumers.</p><h2>Standards Don&#8217;t Change With the Source</h2><p>You can&#8217;t prompt-engineer your way to reliable agents. You also can&#8217;t outsource your way to a compliant AI portfolio. The architectural standards don&#8217;t change with the source. Wire the architecture around the AI you bought, the AI you built, and the AI you inherited, because all three have the same name on the page when something goes wrong.</p><p>The technical version of &#8220;wire the architecture&#8221; is the policy enforcement gateway: side-effecting actions are mediated by code that runs before the action ships, not by the model&#8217;s instructions. The identity version is harder. It&#8217;s the willingness to take ownership of every AI surface in your portfolio, treat each one with the same architectural rigor regardless of who built it, and develop the assessment skill that lets you see in the first thirty seconds whether the controls are real.</p><p>The exercise to run this quarter: list every AI surface in your stack across the four categories above. For each, identify whether the controls live in prompts or in code. The ones that live in prompts are your highest-impact architectural work, regardless of who built them.</p><div><hr></div><p>The architecture that turns strongly-worded prompts into real controls is the paid build: <strong><a href="https://claudecodefornoncoders.substack.com/p/stop-treating-mcp-as-tools-its-your">Stop Treating MCP as Tools. It's Your Architecture.</a></strong> New here? Start with the map: <strong><a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The Claude Architecture Series</a></strong>.</p><p>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</p><p><a href="https://claudecodefornoncoders.substack.com/">Claude Code for Non-Coders</a> publishes on Tuesdays and Thursdays. If you found this useful, share it with someone whose compliance story is one prompt away from collapsing.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/leaderboard&quot;,&quot;text&quot;:&quot;Leaderboard&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/leaderboard"><span>Leaderboard</span></a></p><p></p>]]></content:encoded></item><item><title><![CDATA[Your Agent Picks the Wrong Tool. It’s Not the Agent’s Fault.]]></title><description><![CDATA[Lesson 2.1: When your agent reaches for the wrong tool, the answer isn&#8217;t a routing classifier. It&#8217;s a description that says when NOT to use the tool.]]></description><link>https://claudecodefornoncoders.substack.com/p/your-agent-picks-the-wrong-tool-its</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/your-agent-picks-the-wrong-tool-its</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Tue, 26 May 2026 12:15:23 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!wVT4!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<blockquote><p><em>Architecture Series &#183; Domain 2 &#183; Lesson 2.1 &#183; Tool Design</em></p><p><em>Domain 1 (Lessons 1.1 &#8211; 1.7 + Capstone Parts 1 &amp; 2) is complete. <a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The full series index</a> also appears at the end of this piece.</em></p></blockquote><div class="callout-block" data-callout="true"><p>&#128075; Welcome! I&#8217;m Daniel Williams. I write <em>Claude Code for Non-Coders</em> for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8221;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8220;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><div><hr></div><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><blockquote><p><strong>tl;dr</strong> Tool selection is a description problem before it is an architecture problem. The first fix when your agent picks the wrong tool is to rewrite the two competing descriptions so each one names the other and says when NOT to use it.</p></blockquote><div><hr></div><p>Your agent picks the wrong tool. You ask about a specific order, and it fetches the customer profile. You ask about a refund, and it lists recent orders. The reflex is to blame Claude. The reflex is wrong.</p><p>Tool selection is not a model problem. The model reads each tool&#8217;s name and description and picks based on what it sees. When two descriptions say roughly the same thing, the model picks one, and you hope for the best.</p><p>For operators who aren&#8217;t writing tools themselves, the judgment that matters is what to do about it. You can stack architecture on top, a classifier, a router, or a block of few-shot examples that show correct routing. Or you can fix the descriptions that made the choice ambiguous in the first place. Operators who reach for the classifier turn a thirty-line fix into a three-hundred-line system, and the system still fails at the edges where the descriptions still overlap. Operators who fix the descriptions ship reliable agents and stop fighting their own architecture. This is the kind of choice that separates operators from prompters, the operating discipline this newsletter exists to teach.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!wVT4!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!wVT4!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png 424w, https://substackcdn.com/image/fetch/$s_!wVT4!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png 848w, https://substackcdn.com/image/fetch/$s_!wVT4!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png 1272w, https://substackcdn.com/image/fetch/$s_!wVT4!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!wVT4!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png" width="1456" height="816" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/adc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:816,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:110738,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/199276319?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!wVT4!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png 424w, https://substackcdn.com/image/fetch/$s_!wVT4!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png 848w, https://substackcdn.com/image/fetch/$s_!wVT4!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png 1272w, https://substackcdn.com/image/fetch/$s_!wVT4!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fadc267f4-ef06-4381-8462-f0c5c092ac6e_1456x816.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>The Misrouting Moment</h2><p>Let&#8217;s look at an example in which a customer support agent has five tools: lookup_customer, lookup_order, list_recent_orders, list_refunds, and <code>issue_refund</code>. The user prompts, &#8220;C<em>heck the status of order #12345.&#8221;</em> The agent reaches for <code>lookup_customer</code>. The two descriptions it had to pick between read:</p><pre><code><code>lookup_customer: Retrieves customer information.
lookup_order:    Retrieves order information.</code></code></pre><p>The boundary between them is implied, not stated. The model is being asked to infer where one tool ends and the other begins, based on two short sentences that mirror each other almost word for word. Models infer poorly at the edges of overlapping definitions, and overlapping definitions are the rule, not the exception, in tool surfaces that grow over time.</p><p>Vague or overlapping descriptions produce unreliable selection. Not occasionally, not on edge cases. Reliably unreliable, wherever the descriptions don&#8217;t draw clear lines.</p><h2>The Reflexes That Make It Worse</h2><p>I made this mistake on an MCP server I was building before I had a name for it. A tool would get picked at the wrong moment, and I would reach for the architecture itself: add a <code>mode</code> parameter, split one tool into two, consolidate two others. Architectural moves, sometimes a whole afternoon of refactoring. The descriptions stayed roughly the same, and that was the actual problem. Every time, the fix I needed was just twenty minutes of writing.</p><p>Instinctively, most builders gravitate toward architecture before descriptions. But the right move is usually to fix the descriptions BEFORE tinkering with the tool architecture.</p><p>A <strong>classifier</strong> in front of the agent is the most common reach. A small model reads the user&#8217;s message and decides which tool to call. It sometimes works, at the cost of doubling the architecture. You now have two systems to maintain and two systems that can disagree. The classifier routes around broken descriptions rather than fixing them.</p><p><strong>Few-shot patches</strong> are the next instinct. A block of examples in the system prompt shows the right tool for various inputs. They sometimes work, at the cost of tokens per call and a system prompt that grows whenever a new ambiguity surfaces. The descriptions are still wrong, and you have patched the symptom.</p><p><strong>Consolidation</strong> is the move that feels architecturally clean. Collapse the two tools into one with an <code>entity_type</code> parameter. This is the right move for five GitHub tools that all handle issues in similar ways. It is the wrong move to use <code>lookup_customer</code> instead of <code>lookup_order</code>. Those tools operate on different resources, return different shapes, and have different consequences when called incorrectly. A bad consolidation produces a single tool that requires more documentation than the two clean ones it replaced.</p><p>The fix most builders skip is the one the official docs call &#8220;by far the most important factor in tool performance.&#8221; <strong>Rewrite both descriptions so each one explicitly names the other and says when NOT to use it.</strong></p><h2>What a Working Description Looks Like</h2>
      <p>
          <a href="https://claudecodefornoncoders.substack.com/p/your-agent-picks-the-wrong-tool-its">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Weekend Dispatch: The Quiet Ones Are the Production Layer]]></title><description><![CDATA[Everyone&#8217;s reading this week&#8217;s AI stories wrong: AI didn&#8217;t replace the careful thinkers. It exposed how long the org has been ignoring them. /goal just shipped in Claude Code to close the gap.]]></description><link>https://claudecodefornoncoders.substack.com/p/weekend-dispatch-the-quiet-ones-are</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/weekend-dispatch-the-quiet-ones-are</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Sun, 24 May 2026 12:15:51 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!Eu9B!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<div class="callout-block" data-callout="true"><p><strong>&#128075; Welcome! I&#8217;m Daniel Williams.</strong> I write Claude Code for Non-Coders for senior technical professionals who built their careers on technical judgment, stopped writing code years ago, and are now figuring out how AI and coding agents will change their work.</p><p>The goal is to keep you as the operator, not the AI&#8217;s assistant (&#8220;<a href="https://claudecodefornoncoders.substack.com/p/accenture-is-building-reverse-centaurs">reverse-centaur</a>&#8221;), by helping you decide which tasks to automate and which require the judgment that made you valuable in the first place.</p><p>I advise clients on AI tools, strategy, and human resilience at <a href="https://dewilliams.co">dewilliams.co</a>. This newsletter is where I document the patterns, commands, and operator habits that help you grow from babysitting prompts to building reliable systems.</p><p><strong>Join 33,000+ senior technical professionals</strong> learning the operating discipline that keeps your judgment valuable.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe&quot;,&quot;text&quot;:&quot;SUBSCRIBE&quot;,&quot;action&quot;:null,&quot;class&quot;:&quot;button-wrapper&quot;}" data-component-name="ButtonCreateButton"><a class="button primary button-wrapper" href="https://claudecodefornoncoders.substack.com/subscribe"><span>SUBSCRIBE</span></a></p></div><h2>The careful professional in the meeting wasn&#8217;t failing at communication. The org was structurally rewarding confidence theater over judgment. AI is now making the cost legible.</h2><p>Mats Alvesson coined the term "functional stupidity" in 2016, and it is finally getting the attention it deserved a decade ago. Orgs systematically tax reflexive thinking and reward fluent performance, because frictionless execution looks good in quarterly numbers. The colleague who delivered three confident sentences about alignment got the nod. The careful point, the one with the actual data, and the inconvenient caveat got &#8220;parked for later consideration,&#8221; which everyone in the room understood to mean never.</p><p>Sven Brodmerkel&#8217;s <a href="https://svenbrodmerkel.substack.com/p/why-competent-people-disappear-functional">piece this week</a> extends the diagnosis to the very people most likely to be reading this newsletter. Senior technical professionals built careers on careful pattern recognition. Many learned to mask it to survive. The ones who couldn&#8217;t perform confidence theater on demand became the &#8220;difficult&#8221; ones, the ones meetings get scheduled without, the ones whose pattern recognition was too sharp for the room to absorb. I&#8217;ve watched this play out in client engagements more than once. The person with the careful read on the rollout gets sidelined for the person with the confident roadmap, and six months later, the rollout stalls in exactly the way the careful person predicted, after the budget has already been spent.</p><p>The CC4NC thesis names what the system has been hiding. Your judgment is the layer the org de-funded for thirty years, and the AI rollout is about to make the cost show up on the line item. When McKinsey reports that less than 20% of AI adopters see bottom-line impact, somebody has to figure out why. When the 18,000-process automation at the apparel group stops compounding, somebody has to redesign the operating model. The careful thinkers are the only people in the building who can do that work. The org that taxed your judgment will now need it back, and the question is whether you&#8217;re still in the room when they ask.</p><div class="callout-block" data-callout="true"><p><em>&#8220;The social penalty for thinking carefully, in a functionally stupid organisation, is real and cumulative. And it operates below the level at which you can easily name it and fight it.&#8221;<br>- Sven Brodmerkel (PhD)</em></p></div><div><hr></div><h2>McKinsey just admitted in print that less than 20% of AI adopters see bottom-line impact, and the reason isn&#8217;t the models.</h2><p>Andrei Savine&#8217;s <a href="https://andreisavine.substack.com/p/last-mile-enterprise-ai-dies">analysis</a> pairs <a href="https://www.mckinsey.com/capabilities/people-and-organizational-performance/our-insights/the-state-of-organizations">McKinsey&#8217;s State of Organizations 2026</a> with <a href="https://hbr.org/2026/03/the-last-mile-problem-slowing-ai-transformation">HBR&#8217;s &#8220;Last Mile&#8221; diagnosis</a>. One story repeats across both. 88% of organizations deploy AI in some capacity. 86% of leaders say they aren&#8217;t ready to embed it in day-to-day operations. The productivity gains that show up locally (250 LLM apps in production at one global bank, 18,000 automated processes at an apparel group, 99% Copilot adoption at a payments network) get reabsorbed into low-value work because nobody redesigned the roles and budgets to harvest the freed time.</p><p>McKinsey put a number on it: for every $1 spent on AI technology, $5 should be spent on people. Current spend is the opposite. We funded models, integration, and dashboards. We did not fund the production layer: verification, agent orchestration, role redesign, and the governance that determines whether an AI output touches a customer or a ledger. Savine calls it System 2. Almost no enterprise has built it.</p><p>I keep running into a version of this in advisory discussions. The exec team announces an AI program. The engineering team builds the integrations. Six months later, the CFO asks why the line item hasn&#8217;t moved, and the answer is always the same: nobody owned the operating-model redesign. The reabsorption pattern in McKinsey&#8217;s data matters because CFOs who can&#8217;t see a production layer balance the spreadsheet by cutting headcount and calling it an AI transformation. Atlassian cut 10% of staff in March. WiseTech is cutting 29% of its 7,000-person workforce over 18 months. The first companies to cut aren&#8217;t the ones with the most AI value to capture. They&#8217;re the ones with the least serious operating-model design.</p><p>If your judgment is what System 2 looks like in practice, your value just doubled. The question is whether you&#8217;re positioned to be the one the CFO calls when the spreadsheet stops working, or whether you&#8217;re already on the layoff slate the spreadsheet generated instead.</p><div class="callout-block" data-callout="true"><p><em>&#8220;Everywhere I look, companies are rolling out copilots and agents, building hundreds of pilots and process automations. Yet when you ask for firm&#8209;level impact, you get silence, hand&#8209;waving or a headcount plan. The &#8220;last mile&#8221; is where enterprise AI quietly dies.&#8221;<br>- Andrei Savine</em></p></div><div><hr></div><h2>The $700B consulting industry isn&#8217;t being disrupted by AI. Its positioning to capture the production-layer margin that enterprises never funded, and whether it can actually deliver the work it&#8217;s now charging for, are open questions.</h2><p>Pradeep&#8217;s <a href="https://cioinsights.substack.com/p/the-great-consulting-reinvention">analysis</a> of CB Insights&#8217; professional services report reveals what the headline numbers are hiding. McKinsey has deployed 12,000 internal AI agents. Accenture merged five business units into a single &#8220;reinvention services&#8221; line. KPMG, EY, Deloitte, and PwC have all launched agentic platforms in the past year. AI agent solutions generated over $10B in private market revenue in 2024 and are on pace to more than double in 2025. The orchestration layer (Workbench at KPMG, Refinery at Accenture, EY.ai&#8217;s agentic platform) is the product the firms now sell, and the advisor tier is being subsidized to feed it. KPMG&#8217;s Global AI Head said it plainly: &#8220;We built Workbench as our global architecture to standardize how agents are built, deployed, and monitored.&#8221; That is the language of a platform company, not a service firm.</p><p>The caveat the announcements skip past is that management consulting has lived in the advisory-recommendation lane for fifty years. The deck got delivered, the partner moved on, and accountability for whether the recommendation actually worked was structurally somebody else&#8217;s problem. Owning the orchestration tier is the opposite business model. You stay through implementation, you&#8217;re on the hook when the agent breaks the audit, and you eat the margin when the productivity number doesn&#8217;t hit. Whether these firms can actually staff to deliver that work, or whether they&#8217;re charging platform prices for a service offering they&#8217;ve never proven they can ship, is the question every CIO should be asking in the next procurement cycle.</p><p>The second question is even sharper. If AI compresses delivery costs by 60-80%, where does the surplus land go? The optimistic read says competition forces firms to pass savings through to clients, and outcome-based pricing makes the lower cost legible on the invoice. The realistic read says firms sell their platforms as proprietary infrastructure, lock clients into multi-year arrangements that look like SaaS and feel like SOW retainers, and keep as much of the new margin as they can for as long as they can. The history of this industry suggests the realistic read wins, which means the orchestration platform pivot is partly a value-capture play wearing platform-economics clothing.</p><p>If you&#8217;re a senior technical professional inside one of these firms, the question is whether you&#8217;re being moved into the orchestration tier or the advisory tier. The traditional pyramid is inverting fast. Lovable hit $100M ARR with 45 people. Anysphere generates over $2M revenue per employee. When clients eventually run at that efficiency, the billable-hour justification collapses, and the firms that survive will be the ones who can actually deliver outcomes they charge for. Internal builders who can own a production layer are about to be the most valuable people in the industry. Everyone else is in the headcount review the spreadsheet is already writing.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!Eu9B!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Eu9B!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png 424w, https://substackcdn.com/image/fetch/$s_!Eu9B!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png 848w, https://substackcdn.com/image/fetch/$s_!Eu9B!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png 1272w, https://substackcdn.com/image/fetch/$s_!Eu9B!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Eu9B!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png" width="751" height="794" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/c3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:794,&quot;width&quot;:751,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:null,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:null,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:null,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Eu9B!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png 424w, https://substackcdn.com/image/fetch/$s_!Eu9B!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png 848w, https://substackcdn.com/image/fetch/$s_!Eu9B!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png 1272w, https://substackcdn.com/image/fetch/$s_!Eu9B!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc3aeb54a-a8dc-4f86-a437-2cdf76d9b5aa_751x794.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><div><hr></div><h2>The credentials American universities have been selling for fifty years just got reevaluated in real time, and the institution can&#8217;t hedge between &#8220;formation&#8221; and &#8220;ticket&#8221; anymore.</h2><p>Amarda Shehu&#8217;s <a href="https://amardashehu.substack.com/p/what-the-university-is-now-for">piece</a> names what every higher-ed piece this year has been hedging. She&#8217;s a computer scientist running AI deployment at a 40,000-student public research university, most of whose students are first-generation. She names what the institution has been doing for two generations: telling the public a story about citizenship and formation while collecting tuition for a credential the labor market reads as a hiring filter. AI is making both stories impossible to hold at once.</p><p>The data she pulls together is hard to dismiss. Forrester&#8217;s 2026 Future of Work report finds 55% of employers regret AI-related layoffs and projects roughly half will be reversed. The Burning Glass Institute reports the value of a bachelor&#8217;s degree has dropped to a thirty-year low. Companies that fired junior analysts last year are quietly rehiring them offshore. Tuition keeps rising. The bachelor&#8217;s wage premium is approaching parity with non-graduates, because the entry-level cognitive work the degree was supposed to qualify you for has been absorbed by language models.</p><p>Shehu&#8217;s answer isn&#8217;t a list of safe disciplines. There is no list. The answer is formation: judgment, slow understanding, tolerance for ambiguity, relational capacity under uncertainty. The things that resist automation aren&#8217;t subjects. They emerge from sustained encounters with hard problems and the people working on them. The contrarian move isn&#8217;t a new AI-literacy curriculum or another interdisciplinary degree. It&#8217;s an honest audit of which existing programs actually deliver formation and which deliver only the ticket, and a refusal to keep charging the same tuition for both. The public research university (where a first-generation student can access formation without being born to wealth) has the most to lose if it doesn&#8217;t choose, in public, what it actually sells.</p><p>If you&#8217;re hiring senior people in the next five years, the formation pipeline that produces them is narrowing under you. The same question hits parents with high schoolers at the dinner table. This is the Loop 3 reabsorption question from last week&#8217;s dispatch at the institutional level: the careful thinkers orgs will need to build production layers that come from somewhere, and the places that take formation seriously aren&#8217;t the ones selling tickets. If the public university spends the next five years studying the question, the formation slot in American life closes, and the only people who get it are those who can pay private-college prices. That&#8217;s a much narrower industrial base for the AI economy than anyone in policy circles is acknowledging.</p><div class="callout-block" data-callout="true"><p><em>Anyone who gives you a list is selling you something, and the institution that has been gesturing at one has been complicit in a pretense that is no longer sustainable. The truth is simpler and harder. If a job is a task that can be fully digitized, it is done. The tempo at which it is done is not in our hands.<br>- </em>Dr. Amarda Shehu</p></div><div><hr></div><h2>Anthropic just shipped /goal in Claude Code, and it isn&#8217;t a chatbot feature. It&#8217;s the outcome-specification interface this newsletter has been pointing at since Domain 1.</h2><p><code>/goal</code> lets you tell Claude Code what &#8220;done&#8221; looks like, then walk away while it works across sessions until it either succeeds or escalates. I ran it this week, paired with the feature contract workflow I use on AutomationResilience.com. Wednesday evening, I specified the goal, handed Claude the contract that defined &#8220;done,&#8221; and went to make dinner for the kids with my wife. By the time we sat down to eat, Claude had shipped the update, and the test suite was green.</p><p>This is the operator move at the personal-practice level. Most Claude Code usage is still in task mode: prompt, watch, prompt again, watch again. /goal is outcome-mode: name the contract, let the agent figure out the steps, return when the work is verifiable. The discipline isn&#8217;t typing. It&#8217;s specifying outcomes precisely enough that an agent can&#8217;t drift away from them. That is the production layer in personal practice, the same layer that the McKinsey 5:1 ratio names as missing at the enterprise level. The reason most enterprises can&#8217;t see ROI on AI is the same reason most individuals can&#8217;t get more than a chat session out of Claude Code: they&#8217;re still operating in task-mode when the tool is built for outcome-mode.</p><p>If you&#8217;re using Claude Code, this is the skillset to build. Most users will treat /goal like a fancier prompt and keep getting fancier-prompt value out of it. The operators will treat it like a contract: a specification of what &#8220;done&#8221; means, written before they start, that the agent has to satisfy or escalate. The skill that gets harder to charge for over time is task execution. Anthropic just made the second one cheaper to practice, and the gap between people who do it deliberately and those who don&#8217;t is widening fast.</p><div class="captioned-image-container"><figure><a class="image-link image2" target="_blank" href="https://substackcdn.com/image/fetch/$s_!8g_S!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!8g_S!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png 424w, https://substackcdn.com/image/fetch/$s_!8g_S!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png 848w, https://substackcdn.com/image/fetch/$s_!8g_S!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png 1272w, https://substackcdn.com/image/fetch/$s_!8g_S!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!8g_S!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png" width="1456" height="160" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:160,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:40479,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/199014714?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!8g_S!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png 424w, https://substackcdn.com/image/fetch/$s_!8g_S!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png 848w, https://substackcdn.com/image/fetch/$s_!8g_S!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png 1272w, https://substackcdn.com/image/fetch/$s_!8g_S!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F67a07bdd-9723-4e45-a80a-e488c5ee6e46_1512x166.png 1456w" sizes="100vw" loading="lazy"></picture><div></div></div></a></figure></div><div><hr></div><p><em>Claude Code for Non-Coders publishes Tuesdays and Thursdays. Weekend Dispatch covers AI developments that I find interesting and typically share with friends and family.</em></p><div><hr></div><p><em>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co">dewilliams.co</a>.</em></p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/leaderboard&quot;,&quot;text&quot;:&quot;LEADERBOARD&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/leaderboard"><span>LEADERBOARD</span></a></p>]]></content:encoded></item><item><title><![CDATA[Tokenmaxxing Is a Dead End. Learn to Manage Agent Portfolios Instead.]]></title><description><![CDATA[Tokenmaxxing is the data warehouse mistake at a different layer. The fix isn&#8217;t compressing tokens. It&#8217;s deciding which agents in your portfolio earn their keep.]]></description><link>https://claudecodefornoncoders.substack.com/p/tokenmaxxing-is-a-dead-end-learn</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/tokenmaxxing-is-a-dead-end-learn</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Thu, 21 May 2026 12:15:16 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!siYT!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>A senior engineer I know showed me his approach to prompt optimization a couple of weeks ago. Multiple columns, months of A/B tests, average tokens per call broken out by tool path. He had cut his agent&#8217;s token usage by 30+ percent. I asked him whether the work the agent produced had gotten better. He didn&#8217;t have a column for that. He didn&#8217;t have a column for whether the automation needed to exist. He had a column for tokens because tokens are denominated in dollars. The dashboard his team built had a slot for them, and this is what the executives at his company care about.</p><p>Tokenmaxxing is being sold to every CFO in the country as a discipline. It is the data warehouse mistake that we already learned, painfully, through the late 1990s and into the 2000s, that volume metrics on infrastructure whose underlying value isn&#8217;t understood produce confidently wrong decisions and a decade of compression projects on data that should have been deleted. The lesson took fifteen years and several billion dollars of write-offs to absorb then. AI tooling is reproducing it now, and the people building the dashboards have no apparent memory of how the last version of this story ended.</p><p>The discipline that worked then is the discipline that will work now: rationalization, not optimization. <strong>Agent rationalization</strong> means deciding, at the portfolio level, which agents are producing value and which to kill. Compressing prompts on automations that shouldn&#8217;t exist is the mistake being made now.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!siYT!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!siYT!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!siYT!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!siYT!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!siYT!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!siYT!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png" width="1456" height="819" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:819,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:170269,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/196783319?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!siYT!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png 424w, https://substackcdn.com/image/fetch/$s_!siYT!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png 848w, https://substackcdn.com/image/fetch/$s_!siYT!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png 1272w, https://substackcdn.com/image/fetch/$s_!siYT!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F7a9c8587-c728-4a3e-b649-0d8edd677b77_1920x1080.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>The Last Time We Did This</h2><p>Through the late 1990s, large enterprises built data warehouses the way large enterprises now build agent platforms in 2025: every team got a pipeline, every system got a feed, every report became a job, and the storage line item compounded quarter over quarter. By the mid-2000s, the CFO noticed. The first response was technical. Compression ratios, columnar formats, tiered storage, partition strategies. Vendors sold optimization. Consultants sold optimization. The cost curve bent for about eighteen months and then resumed climbing, because the underlying problem wasn&#8217;t storage efficiency. The underlying problem was that nobody knew which of those pipelines was producing decisions and which was producing dust. <a href="https://www.inc.com/jeff-barrett/misusing-data-could-be-costing-your-business-heres-how.html">Forrester eventually quantified the gap</a>: 60 to 73 percent of enterprise data goes unused for analytics, regardless of how much storage gets optimized.</p><p>What eventually broke the cycle were master data management and data rationalization, both euphemisms for deletion. The companies that did this honestly killed 40 to 60 percent of pipelines and reports. The work that mattered ran faster and got governed better. The work that didn&#8217;t matter went away. The savings compounded because they were structural rather than technical. The companies that stayed in compression mode spent another ten years optimizing infrastructure carrying low-value freight, and the line item never came down.</p><p>Rationalization, done honestly, surfaces underinvestment as often as it surfaces waste. I ran one such engagement at a top-20 global pension fund. The work canceled hundreds of thousands of dollars a year in data licensing the fund didn&#8217;t need and identified over $10 million in new and expanded data products and services worth investing in. The client hired me to find savings. They left with something more valuable: a clear-eyed map of where they had been under-investing in assets that actually mattered.</p><p>Token spend has the same shape, on a faster clock. Any metric that captures volume of activity on infrastructure whose business value is unclear will produce optimization projects, and those projects will be confidently executed. They will not move the bottom line because the value problem has always been upstream of the volume problem. The vendor ecosystem is already lining up to sell you the optimization layer.</p><h2>&#8220;Tokenmaxxing&#8221;</h2><p>Tokenmaxxing is a meme describing the cluster of practices that confuse the meter for the work. Prompt golf, where engineers spend a day shaving 800 tokens off a system prompt that runs in an automation nobody has audited for outcomes in six months. Compression schemes that pre-summarize context before it reaches the model, on the theory that if the model produces similar output for less input, the optimization is free. Agent harness comparisons that report token efficiency to 4 significant digits and output quality as a sentence. Vendor pitches denominated in dollars per million tokens, as if the unit being purchased were tokens rather than work products. The token-spend dashboard at the CFO level, which is easier to build than a value framework, is therefore the artifact that gets reviewed in the QBR.</p><p>Each of these practices shares a particular tell: teams have stopped asking what the agent is for. They have moved to asking how to do whatever it currently does for less. That move is socially comfortable. It produces a number that goes down quarter over quarter, it generates artifacts to put in the deck, and it doesn&#8217;t require any of the hard portfolio conversations about whether the automation should exist. It is also, almost without exception, in the wrong layer of the stack.</p><p>When a team tells me they cut token usage by a third, the question I ask back is which automations they killed. The answer is almost always none. They have made the existing portfolio more efficient. The portfolio still contains the same number of agents producing the same questionable work product, and the dashboard now reports the spend as down. Five quarters of that and the cost curve resumes climbing, because the underlying portfolio is still wrong.</p><p>The buying organization is not the beneficiary of any of this. Tokenmaxxing produces no shipped product, no decision improvement, and no customer value of any kind. What it produces is more token consumption, more sophisticated optimization stacks, and more reasons to keep buying inference. The parties whose interests the practice actually serves are the frontier labs billing by the token, the GPU and TPU manufacturers selling the substrate, and the data centers leasing rack space. Inside the company, paying the bills, tokenmaxxing is a discipline whose primary externality is keeping the meter running. The vendor ecosystem will tell you it&#8217;s the responsible thing to do, because for them, it is.</p><h2>What Agent Rationalization Actually Looks Like</h2><p>This discipline doesn&#8217;t have a name in the current discourse. Search for AI agent governance, and you find runtime concerns: identity, kill switches, policy enforcement, and reliance drills. Search for AI portfolio rationalization, and you find vendors offering AI agents as a tool to rationalize legacy application portfolios, which is a different problem entirely. Search for agent decision frameworks, and you find guidance on selecting the right agent for a use case. The strategic question of which agents in your existing AI portfolio earn their keep, and which ones don&#8217;t, isn&#8217;t being asked. Call it <strong>&#8220;agent rationalization.&#8221;</strong></p><p>The strategic move is portfolio review, not prompt engineering. The deliverable is a list of automations, agent workflows, and recurring AI-touched processes, scored by the business value they produce rather than the tokens they consume.</p><p>A professor I had in grad school taught us a framework I have used ever since. Every project a company invests in has to fit one of three buckets: <strong>generate revenue</strong>, <strong>reduce costs</strong>, or <strong>increase efficiency</strong>. If it does not fit cleanly into one of those three, the question is, why are we doing this? Apply it to your AI portfolio, and the answers come quickly. An agent that drafts proposals that actually win deals fits the revenue bucket. An agent that handles a class of tickets that used to require headcount fits the cost bucket. An agent that compresses a review cycle from a week to a day fits the efficiency bucket. An agent that produces an artifact nobody files, summarizes meetings nobody acts on, or runs every night because someone built it once and forgot fits none of them. That last category is where most token spending ends up when nobody is asking the question.</p><p>The bottom third of the portfolio gets retired. The middle gets re-evaluated against a sharper version of the original brief. The top gets resourced more aggressively than current spend, because the constraint on those agents is judgment and design, not token budget. Most rationalizations I have run have produced both directions of recommendation in the same deliverable: cuts to the work that wasn&#8217;t earning its keep, and increased investment in the work that was producing real value but was under-resourced. The same logic applies to agents. Useless AI initiatives don&#8217;t survive a rationalization. Value-generating ones come out the other side with more resources, not fewer. Token rationalization is a sub-discipline of agent rationalization, applied to the portfolio that survived the test. The compression and prompt optimization completed at that point are legitimate work. Done before the portfolio review, they are tokenmaxxing under a different name.</p><p>The senior person doing this work has to be willing to say which automations are not pulling their weight, which is socially harder than saying which prompts can be compressed. The shift the work asks of you is from someone who manages AI inputs to someone who governs an AI portfolio. That&#8217;s the discipline that scales with seniority, and it&#8217;s not the one a token-spend dashboard will ever measure. Most organizations will choose the easier framing because it produces clean numbers without making anyone defend their pet workflow. The companies that take the harder path will end up with smaller, sharper agent portfolios and better cost discipline three years out, the same way the companies that took the harder path on data ended up with smaller, sharper data estates.</p><p>The senior technical professionals reading this newsletter are who this work falls to, because nobody on the prompt-optimization track is going to surface it. The token-spend dashboard is being installed in your finance org right now, or it will be by the end of the year. The question to bring to the next portfolio review is not how the tokens are trending. It&#8217;s which of these agents produced work in the last quarter that someone actually used, and what would happen if you turned the others off tomorrow. That conversation is harder to have than a compression ratio, and it&#8217;s the only one that ends in a different cost curve.</p><p>If you run an AI portfolio of any size, do this one exercise this quarter: list every recurring agentic workflow your organization runs, and for each one, name the decision it informs or the artifact it produces. The ones you can&#8217;t name go on a list. The list is your starting point.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe now&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe?"><span>Subscribe now</span></a></p><div><hr></div><p><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);">Tokenmaxxing is a dead end as AI prices rise with each new model release. Learn to architect around the uncertainty: </span><strong><a href="https://claudecodefornoncoders.substack.com/p/ai-prices-are-going-up-your-architecture">AI Prices Are Going Up. Your Architecture Is Your Hedge.</a></strong> &#8212; <span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);">New here? Start with the map: </span><strong><a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The Claude Architecture Series</a></strong><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);">.</span></p><p>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</p><div><hr></div><p><a href="https://claudecodefornoncoders.substack.com/">Claude Code for Non-Coders</a> publishes on Tuesdays and Thursdays. If you found this useful, share it with someone who&#8217;s about to install a token-spend dashboard.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/leaderboard&quot;,&quot;text&quot;:&quot;Leaderboard&quot;,&quot;action&quot;:null,&quot;class&quot;:&quot;button-wrapper&quot;}" data-component-name="ButtonCreateButton"><a class="button primary button-wrapper" href="https://claudecodefornoncoders.substack.com/leaderboard"><span>Leaderboard</span></a></p>]]></content:encoded></item><item><title><![CDATA[You Built the Agent. Don't Stop at Wiring. Agent Ops Is Next.]]></title><description><![CDATA[The capstone part 1 wired the agent. Operating it takes three architectures: a persona that defines the job, a decomposition that scales the work, and a session model that survives the closed laptop.]]></description><link>https://claudecodefornoncoders.substack.com/p/you-built-the-agent-now-you-have</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/you-built-the-agent-now-you-have</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Tue, 19 May 2026 12:15:59 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!0B9G!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<blockquote><p>This is the second half of the Domain 1 Capstone. Last week, we wired the agent. This week is how production agents survive the work.</p></blockquote><p>You built the agent. The Domain 1 capstone walked through the wiring: the loop that runs while Claude works, the PostToolUse hook that normalizes data before the model sees it, and the PreToolUse gate that blocks policy-violating tool calls. That&#8217;s the part that takes the most time to explain because most people haven&#8217;t seen it. It&#8217;s also the part that takes the least time once you&#8217;ve seen it. Once the wiring is right, it&#8217;s done.</p><p>Production agents have to do three more things that the wiring alone doesn&#8217;t address. They have to know what they&#8217;re for, without you re-explaining every session. They have to handle work that doesn&#8217;t fit cleanly into a single prompt. They have to survive the gap between Friday afternoon and Monday morning, across machines, across colleagues, across the closed laptop.</p><p>The capstone repo has all three. Same agent, same hooks, same MCP server. Three more architectures are sitting around them.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!0B9G!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!0B9G!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png 424w, https://substackcdn.com/image/fetch/$s_!0B9G!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png 848w, https://substackcdn.com/image/fetch/$s_!0B9G!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png 1272w, https://substackcdn.com/image/fetch/$s_!0B9G!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!0B9G!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png" width="1456" height="816" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/c10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:816,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:100800,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/197161376?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!0B9G!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png 424w, https://substackcdn.com/image/fetch/$s_!0B9G!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png 848w, https://substackcdn.com/image/fetch/$s_!0B9G!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png 1272w, https://substackcdn.com/image/fetch/$s_!0B9G!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fc10e267d-5d0a-4a34-8c0f-81d3736b8363_1456x816.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><h2>The Persona Defines the Job, Not the Job Title</h2><p>The agent persona for the capstone is a 41-line markdown file at <code>.claude/agents/support-agent.md</code>. It declares which of the five MCP tools the agent is allowed to use, the refund policy in plain language, the expected tone, the date format the agent can rely on, and the workflow shape. The frontmatter at the top declares the model and the tool list; the body is prose for the agent to read at every session start.</p><p>The first instinct most builders have when they encounter this file is to name the agent like a human role: &#8220;Senior Customer Support Agent,&#8221; &#8220;Compliance Officer Agent,&#8221; &#8220;Senior Data Analyst Agent.&#8221; This is the wrong instinct, and it&#8217;s the most common mistake people make when they first encounter subagents. The persona file isn&#8217;t a job title. It&#8217;s the substance of a job description: what the agent is for, what tools it has access to, what the boundaries are, and what outcome it owns.</p><p>A real job posting doesn&#8217;t lead with the title. It leads with responsibilities and scope. The title gets applied last, often arbitrarily. The persona file is what the title would be at a real company once HR translates the actual work into a label. Skip the label. Write the work.</p><p>The wrong instinct produces persona files that read like LinkedIn profiles (&#8221;results-driven senior agent with 10+ years of experience&#8221;) rather than operational specs (&#8221;uses these five tools, follows this workflow, escalates these cases, never bypasses these checks&#8221;). The first kind doesn&#8217;t help Claude do the job. The second kind does.</p><p>There&#8217;s a second thing the persona file does that&#8217;s easy to miss. It declares contracts with the surrounding architecture. The capstone&#8217;s persona has this line: <em>&#8220;Order dates always come back in ISO 8601.&#8221;</em> That sentence is not true at the data layer. The orders.json file has Unix epoch integers, MM/DD/YYYY strings, and ISO 8601 mixed together. The sentence is true because the PostToolUse hook converts every date before the model sees it. The agent prompt can rely on a clean schema because programmatic normalization sits between the data and the prompt.</p><p>This is the relationship between persona and architecture. The persona says what the agent expects. The hooks make that expectation true. If the persona declared a contract that no hook enforced, the agent would behave one way most of the time and another way at the wrong moments. Hook-backed contracts are the only kind that hold.</p><p>The persona is the job description. The hooks are the compliance department. Both are written, both are operational, and neither replaces the other.</p><h2>Decomposition Lets It Work at Scale</h2><p>Most demos run in Claude Code without a separate Anthropic API key. The loop demo is the exception: it calls the Anthropic API directly to expose the stop_reason mechanic that Claude Code normally hides.</p><p>If you don&#8217;t have a standalone API key, that one step gets skipped, and the rest still runs. Get one at <a href="https://console.anthropic.com">console.anthropic.com</a>. It takes about five minutes. Once you have it, set it in your terminal before running the scripts:</p><pre><code><code>export ANTHROPIC_API_KEY=sk-ant-...</code></code></pre><p>The same five tools that handle one customer&#8217;s refund request can audit all three customers&#8217; refund patterns. How you orchestrate the audit determines what it actually finds.</p><p>The seeded data has 3 customers, 30 orders, 9 refunds, and 8 ground-truth patterns to surface. The <code>audit_demo/</code> folder contains two scripts that approach the same audit in different ways.</p><p>Single-pass (<code>audit_single_pass.py</code>) dumps every customer&#8217;s orders and refunds into one prompt and asks for the full analysis at once. This is the way most people instinctively approach the problem. It finds the headline patterns: Alice&#8217;s March cluster, Bob&#8217;s clean record, Carla&#8217;s high refund rate. It&#8217;s fast, it&#8217;s coherent, and it consistently misses two or three of the eight planted patterns because the model&#8217;s attention dilutes across 30 orders and 9 refunds.</p><p>Multi-pass (<code>audit_multipass.py</code>) spawns three parallel workers, one per customer. Each worker runs its own <code>stop_reason</code> loop, calls the tools to fetch only its customer&#8217;s data, and produces a structured audit section. After all three are complete, a synthesis call reads only the compressed findings (not the raw orders and refunds) and produces the final report.</p><div class="captioned-image-container"><figure><a class="image-link image2" target="_blank" href="https://substackcdn.com/image/fetch/$s_!kfYS!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!kfYS!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png 424w, https://substackcdn.com/image/fetch/$s_!kfYS!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png 848w, https://substackcdn.com/image/fetch/$s_!kfYS!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png 1272w, https://substackcdn.com/image/fetch/$s_!kfYS!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!kfYS!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png" width="1154" height="186" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:186,&quot;width&quot;:1154,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:36471,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/197161376?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!kfYS!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png 424w, https://substackcdn.com/image/fetch/$s_!kfYS!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png 848w, https://substackcdn.com/image/fetch/$s_!kfYS!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png 1272w, https://substackcdn.com/image/fetch/$s_!kfYS!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd0fd3433-3418-405c-b120-c6fa57d3a77f_1154x186.png 1456w" sizes="100vw" loading="lazy"></picture><div></div></div></a></figure></div><p>Both versions find the headline patterns: Alice&#8217;s March cluster, Bob&#8217;s clean record, Carla&#8217;s high refund rate. The interesting part is what only the synthesis step can see.</p><p>In testing, the multi-pass synthesis produced observations neither single-pass nor any individual worker surfaced:</p><pre><code><code>- Alice's pattern is a burst-abuse model: four refunds in six days. Carla's is sustained selective extraction: every refund targets a delivered, high-value order ($480&#8211;$720); no low-value order has ever been disputed. Two distinct fraud archetypes, requiring different responses. Visible only when both accounts are compared.

- The $500 approval threshold is structurally visible to customers. All three accounts have at least one refund in the $400&#8211;$499 band, each individually sub-threshold, each avoiding the manager-approval gate. Single-pass flagged the pattern for one customer. The synthesis produced a cross-customer comparison table and named it threshold structuring.

- manager_approval_flag is non-functional as a control in all three cases, for different reasons. Alice: never set despite four refunds in six days. Carla: set but didn't stop ongoing activity across seven months. Bob: not set on a watchlist account. Each worker found its own case. The synthesis connected them.</code></code></pre><p>These aren&#8217;t faster findings. They&#8217;re deeper findings, and two of the three only exist at the synthesis layer, where no single worker had the full picture. Multi-pass costs more tokens than single-pass, roughly three to five times more in practice, which is the same overhead laid out in <a href="https://claudecodefornoncoders.substack.com/p/attention-doesnt-scale-decomposition">Lesson 1.6</a>. The point of multi-pass isn&#8217;t speed. Its depth.</p><p>The pattern is the same as the per-file analysis pattern from Lesson 1.6: each item gets undivided attention in its own context window, and the integration step reads only the compressed signal. Production agents that audit, summarize, or compare across many items without this pattern will produce thinner findings than they should. The pattern that matters is sometimes the one that requires every account to be considered fully, then compared.</p><h2>The Session Model Survives the Closed Laptop</h2><p>Real cases don&#8217;t finish in one sitting. The Alice / ORD-1002 investigation that the capstone uses for its refund-bypass demo is exactly the kind of investigation that gets paused over a weekend and resumed Monday morning, sometimes on a different machine. The capstone&#8217;s <code>session_demo/</code> folder has three scenarios, all on the same investigation, each demonstrating a different resumption pattern.</p><p><code>scenario_1_continue.md</code> walks through the simplest case. Investigate Alice&#8217;s refund cluster on Friday afternoon. Step away. Come back Monday morning, same machine, same folder. Run <code>claude --continue</code>. The full session loads. Claude references the March cluster without re-fetching anything.</p><p>This works because the session is recent and the context window can hold the whole transcript. It breaks down exactly the way Lesson 1.7 said it would: past a certain size, reloading the full transcript actively degrades the next response. For investigations that finish within a session or two, <code>--continue</code> is the right tool.</p><p><code>scenario_2_fork.md</code> walks through a different problem. The investigation is done. The manager has approved the refund. Before issuing it, you want to see two outcomes from the same starting point: the approved branch (issue the refund) and the denied branch (draft the escalation email instead). Both branches share the parent&#8217;s context up to the fork; after the fork, they diverge. The parent session stays untouched.</p><p>What catches experienced builders here is what fork doesn&#8217;t do. It doesn&#8217;t fork the filesystem. If the approved branch issues the refund and writes to <code>refunds_log.json</code>, the denied branch starts its work, seeing that change. The mandatory step between branches is to reset the log with <code>python3 audit_demo/reset_refunds.py</code>. The reset is the lesson. Forks branch the conversation, not the disk.</p><p><code>scenario_3_fresh_brief.md</code> walks through the cross-machine, multi-day case. You finished Friday on the office laptop. Monday you&#8217;re on the home desktop with no shared session state. The handoff brief at <code>scenario_3_fresh_brief.handoff_brief.md</code> looks like this:</p><pre><code><code># Investigation handoff: Alice Chen / ORD-1002

## Subject
alice@example.com (CUST-01, Pro tier), refund request for ORD-1002 ($612.00, "shipping damaged", March 15 2025).

## Findings
- Manager approval flag is FALSE; refunds over $500 require manager_approved=true (enforced by PreToolUse hook)
- Refund history shows a 7-day cluster (March 14&#8211;20 2025): 4 refunds totalling $1,212
- 3 of 4 cluster refunds lacked manager approval; policy oversight gap flagged

## Outstanding
- Manager verdict: APPROVED (shipping damage documented in carrier report)
- Action needed: call issue_refund for ORD-1002, amount $612, reason "shipping damaged (carrier documented)", manager_approved=true
- Confirm entry in refunds log</code></code></pre><p>The brief is about 200 words. It contains the case facts, the findings, and the outstanding action with the exact tool parameters. New session, no flags, paste the brief, ask Claude to continue. Claude re-fetches what it needs and processes the refund correctly.</p><p>This is the doctor&#8217;s handoff pattern from Lesson 1.7. The transcript has hundreds of turns. The brief has twelve lines. The brief preserves the signal; the transcript preserves the noise. For long gaps, cross-machine work, or any handoff where the session itself can&#8217;t travel, the brief is the right tool.</p><p>The three patterns sit on a single axis: how much context survives the gap.</p><div class="captioned-image-container"><figure><a class="image-link image2" target="_blank" href="https://substackcdn.com/image/fetch/$s_!UhME!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!UhME!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png 424w, https://substackcdn.com/image/fetch/$s_!UhME!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png 848w, https://substackcdn.com/image/fetch/$s_!UhME!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png 1272w, https://substackcdn.com/image/fetch/$s_!UhME!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!UhME!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png" width="1116" height="156" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:156,&quot;width&quot;:1116,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:38120,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/197161376?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!UhME!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png 424w, https://substackcdn.com/image/fetch/$s_!UhME!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png 848w, https://substackcdn.com/image/fetch/$s_!UhME!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png 1272w, https://substackcdn.com/image/fetch/$s_!UhME!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F713a8fda-1dd4-41a8-b1f9-b56054a4fd05_1116x156.png 1456w" sizes="100vw" loading="lazy"></picture><div></div></div></a></figure></div><h2>What Operating Looks Like</h2><p>The capstone wired the agent. These three architectures are how it operates.</p><p>Without persona, every session re-explains the agent and its workflow. Without decomposition, work that needs depth across many items produces shallow output. Without a session model, every gap loses context that the next session has to rediscover.</p><p>With them: production AI, not toy AI. The agent knows what it&#8217;s for, scales to work that doesn&#8217;t fit one prompt, and survives the gap between when you started and when you came back. The wiring you did in the capstone holds because these three sit around it.</p><p>Domain 2 starts on Tuesday, May 26, and the paid tier opens then. The five tools the support agent uses (lookup_customer, get_order, list_recent_orders, list_refunds, issue_refund) each had to be designed before the agent could pick the right one. The design choices aren&#8217;t obvious. Builders who skip them produce agents that pick the wrong tool and can&#8217;t explain why.</p><p>The Founding Member tier opens Tuesday, capped at the first 100 readers: $200 a year, the price holds as long as the subscription stays active. Standard paid pricing applies after. Domain 1 stays free for everyone, including this two-part capstone.</p><p>Domain 1 wired and operated the agent. Domain 2 makes the operation reliable.</p><p>The full repo for this build is at <a href="https://github.com/danieleugenewilliams/cc4nc">github.com/danieleugenewilliams/cc4nc</a>. The <code>audit_demo/</code> and <code>session_demo/</code> folders have the demos this article walked through, with verification tests in <code>verification/</code>. Same paste-into-Claude-Code prompt as the capstone; it walks through the loop and hooks, and the audit and session demos run directly from the command line.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe now&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/subscribe?"><span>Subscribe now</span></a></p><div><hr></div><p><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);">One of the most overlooked aspects of agent ops is understanding why agents make silly mistakes that cost you in tokens and money. That&#8217;s one of the areas I walk you through here: </span><strong><a href="https://claudecodefornoncoders.substack.com/p/your-agent-hallucinated-a-recovery?r=3ve08">Your Agent Hallucinated a Recovery. Your MCP Tool&#8217;s Error Response Asked for It<span>.</span></a></strong><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);"> New here? Start with the map: </span><strong><a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The Claude Architecture Series</a></strong><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);">.</span></p><p>Daniel Williams advises clients about AI tools, strategy, and human resilience at <a href="https://dewilliams.co/">dewilliams.co</a>.</p><div><hr></div><p><a href="https://claudecodefornoncoders.substack.com/">Claude Code for Non-Coders</a> publishes on Tuesdays and Thursdays. If you found this useful, share it with someone who&#8217;s been building agents and wondering what changes once they go to production.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://claudecodefornoncoders.substack.com/p/you-built-the-agent-now-you-have?utm_source=substack&utm_medium=email&utm_content=share&action=share&quot;,&quot;text&quot;:&quot;Share&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://claudecodefornoncoders.substack.com/p/you-built-the-agent-now-you-have?utm_source=substack&utm_medium=email&utm_content=share&action=share"><span>Share</span></a></p>]]></content:encoded></item><item><title><![CDATA[Weekend Dispatch: Architect or Be Architected]]></title><description><![CDATA[Everyone&#8217;s reading this week&#8217;s four AI stories wrong: the FDE rebrand, Karpathy&#8217;s compression test, the brake Citrini missed, and Nvidia on your wall.]]></description><link>https://claudecodefornoncoders.substack.com/p/weekend-dispatch-architect-or-be</link><guid isPermaLink="false">https://claudecodefornoncoders.substack.com/p/weekend-dispatch-architect-or-be</guid><dc:creator><![CDATA[Daniel Williams]]></dc:creator><pubDate>Sat, 16 May 2026 12:15:53 GMT</pubDate><enclosure url="https://substackcdn.com/image/fetch/$s_!XIJO!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<blockquote><p>This is the first CC4NC Weekend Dispatch, a free, feed-only roundup of the week&#8217;s most important AI developments through the strategic builder&#8217;s lens. Short, reactive, and designed to keep you current without adding to your inbox.</p></blockquote><h2>OpenAI, Anthropic, and Google just spent $5.5 billion hiring consultants and calling them something else.</h2><p>They&#8217;re calling them &#8220;Forward Deployed Engineers&#8221; (FDE). The price tag is $10K/day. The job is to sit inside your company and make AI work for you. As one commenter put it: &#8220;I have about 20 years of experience as a forward-deployed engineer, we used to call them consultants.&#8221;</p><p>OpenAI launched a <a href="https://openai.com/index/openai-launches-the-deployment-company/">$4 billion deployment company</a> and acquired Tomoro to staff it with 150 FDEs. Anthropic <a href="https://www.anthropic.com/news/enterprise-ai-services-company">raised $1.5 billion</a> with Blackstone and Goldman Sachs for the same play. Google is <a href="https://x.com/FirstSquawk">recruiting hundreds more</a>. EPAM is certifying 10,000 Claude architects. Aaron Levie calls it <a href="https://x.com/levie">one of the most in-demand jobs in tech</a>.</p><p>Allie Miller got closest to what everyone else is dancing around: <a href="https://x.com/alliekmiller">external FDEs won&#8217;t make your company AI-first</a>. You can customize the deployment and still have your employees avoid AI and distrust every leadership decision around it. Her Salesforce analogy: you can customize the implementation, but that won&#8217;t make your sales team fix their data hygiene.</p><p>Platforms are going headless because customers have already picked their agents elsewhere. Salesforce tried Agentforce. Notion tried Notion AI. People used Claude or ChatGPT instead, because nobody wants to learn a different agent for every SaaS tool they touch. <a href="https://www.salesforce.com/news/stories/salesforce-headless-360-announcement/">Salesforce launched Headless 360</a> in April: 60+ MCP tools that let your agent of choice operate the platform without a UI. <a href="https://www.notion.com/releases/2026-05-13">Notion shipped its developer platform on Tuesday</a> with Workers, Database Sync, and external agent support. The platforms aren&#8217;t competing to be the agent anymore. They&#8217;re competing to be the substrate the agent runs on.</p><p>Your client already has Claude Desktop. They already have Codex. I frequently recommend Claude Desktop to clients, friends, and family members. My cousin started using Claude Cowork and found tens of thousands in change order value from an electrical spec on day one. No FDE. No SOW. What we discussed afterward was the architecture he couldn&#8217;t build himself. If your value disappears when the client opens a $20/month tool, you&#8217;re not selling expertise. You&#8217;re selling navigation through complexity you could have simplified.</p><p>This bifurcates the FDE play. Simple integrations and happy-path workflows go to the frontier lab-released skills, SaaS MCP connectors, and the desktop agent that the buyer already pays for. The hard cases are messy data, cross-system architecture, and domain logic that nobody wrote down. Those need humans with context: call them FDEs, call them consultants, call them internal builders with the skill and authority to make it work. Every company with legacy systems and compliance burdens genuinely needs that help. The $5.5 billion bet is reasonable for the hard half. The risk is that most buyers can&#8217;t yet tell which half they&#8217;re in.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!XIJO!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!XIJO!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png 424w, https://substackcdn.com/image/fetch/$s_!XIJO!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png 848w, https://substackcdn.com/image/fetch/$s_!XIJO!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png 1272w, https://substackcdn.com/image/fetch/$s_!XIJO!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!XIJO!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png" width="1200" height="736" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:736,&quot;width&quot;:1200,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:null,&quot;alt&quot;:&quot;OpenAI's announcement says the new deployment-company launches with more  than $4 billion in initial investment, but Axios reports additional  investor terms not included in the announcement: a guaranteed minimum 17.5%  return and&quot;,&quot;title&quot;:null,&quot;type&quot;:null,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:null,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="OpenAI's announcement says the new deployment-company launches with more  than $4 billion in initial investment, but Axios reports additional  investor terms not included in the announcement: a guaranteed minimum 17.5%  return and" title="OpenAI's announcement says the new deployment-company launches with more  than $4 billion in initial investment, but Axios reports additional  investor terms not included in the announcement: a guaranteed minimum 17.5%  return and" srcset="https://substackcdn.com/image/fetch/$s_!XIJO!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png 424w, https://substackcdn.com/image/fetch/$s_!XIJO!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png 848w, https://substackcdn.com/image/fetch/$s_!XIJO!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png 1272w, https://substackcdn.com/image/fetch/$s_!XIJO!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3b5acd03-a274-4f52-a132-a21b5af14289_1200x736.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>Image: Screenshot of the OpenAI Deployment Company announcement</em></figcaption></figure></div><div><hr></div><h2>Remove all the code from your app. Give the raw input directly to an LLM. Is the output roughly the same?</h2><p>That&#8217;s Karpathy&#8217;s test. He ran it on his own product, and it failed.</p><p>He built Menu Gen: a photo of a restaurant menu goes through OCR, an image model generates pictures of each dish, and the app re-renders the menu with food photos next to every item. Full pipeline. Deployed on Vercel. Someone gave Gemini the same photo with one prompt: &#8220;overlay pictures of each dish onto the menu.&#8221; Gemini returned the original menu with food images rendered directly into the pixels. One prompt. The entire app is unnecessary.</p><p>I ran this test on two of my own products. One passed cleanly; the knowledge maturation pipeline does things no single prompt can replicate. The other was closer to the line than I expected.</p><p>The 20% that survives has to be something the model genuinely cannot do: persisting state across users, enforcing access controls, processing payments, connecting to hardware. If your 20% is &#8220;better formatting&#8221; or &#8220;a nicer UI,&#8221; you&#8217;re in the 80% that&#8217;s about to get compressed. Run the test before the market runs it for you.</p><div class="native-video-embed" data-component-name="VideoPlaceholder" data-attrs="{&quot;mediaUploadId&quot;:&quot;ae1fa37a-7895-4888-8915-2bcfd52dba3e&quot;,&quot;duration&quot;:null}"></div><p style="text-align: center;"><em>Video: Karpathy discussing his app getting oneshotted</em></p><div><hr></div><h2>Citrini&#8217;s &#8220;No Natural Brake&#8221; diagram includes a brake. They drew it and forgot to label it.</h2><p><a href="https://open.substack.com/pub/citrini/p/2028gic">Citrini Research</a> published &#8220;The 2028 Global Intelligence Crisis,&#8221; a fictional memo from June 2028. The diagram went everywhere: AI improves, companies need fewer workers, layoffs increase, displaced workers spend less, the economy weakens, and companies invest more in AI. Stamped across the top: &#8220;No Natural Brake.&#8221;</p><p>Displaced workers spend less. The economy weakens. That is the brake. Agents don&#8217;t buy coffee or pay rent. The income has to flow to someone who does. When it stops flowing, consumption collapses. When consumption collapses, revenue disappears. When revenue disappears, nobody is funding the next round of AI investment. The brake isn&#8217;t gentle: it&#8217;s a recession. But it exists.</p><p>The strongest objection is that automation could close the loop without consumers at all. Wealthy investors fund automated B2B chains supplying other automated businesses. Capital cycles through machines that never needed human spending in the first place. The Thiel/Yarvin enclave scenario. It&#8217;s the most coherent version of &#8220;no brake,&#8221; and short of an authoritarian solution to the political problem, it can&#8217;t run at a steady state. Capital is only valuable to the extent it commands real goods, services, or political power. Pure capital-serving-capital resolves into paper wealth nobody can redeem. The closed loop is a transient: it lasts as long as investors keep funding the bet, and breaks when they notice revenue isn&#8217;t materializing or when joblessness becomes politically untenable. Reabsorption isn&#8217;t just morally preferable. It&#8217;s the only durable equilibrium short of authoritarian enclosure.</p><p>The real question is speed. Does the acceleration hit the demand brake before or after the labor market adjusts? History suggests markets do adjust: new roles absorb displaced workers, but only if there&#8217;s a reabsorption mechanism. That mechanism is the third loop Citrini left off the diagram: displaced workers who learn to define and architect outcomes rather than execute tasks. Forrester found <a href="https://www.forrester.com/">55% of employers regret AI-related layoffs</a>. The companies that cut too fast didn&#8217;t lose friction. They lost the judgment that knew when the AI output was wrong.</p><p>If you&#8217;re reading this newsletter, you&#8217;re building the skills that put you in the third loop. The question is whether enough of the labor market gets there before the brake kicks in.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!mryD!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!mryD!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png 424w, https://substackcdn.com/image/fetch/$s_!mryD!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png 848w, https://substackcdn.com/image/fetch/$s_!mryD!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png 1272w, https://substackcdn.com/image/fetch/$s_!mryD!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!mryD!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png" width="1456" height="951" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:951,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:173167,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://claudecodefornoncoders.substack.com/i/197557308?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!mryD!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png 424w, https://substackcdn.com/image/fetch/$s_!mryD!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png 848w, https://substackcdn.com/image/fetch/$s_!mryD!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png 1272w, https://substackcdn.com/image/fetch/$s_!mryD!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8335537c-e5a3-438f-b886-83ce9eff37bb_2000x1307.png 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>Image: Corrected three-loop diagram (Citrini_Three_Loop_Corrected.png)</em></figcaption></figure></div><div><hr></div><h2>Nvidia is running the mineral rights playbook with silicon instead of coal. You should want to own the compute, not rent out your wall.</h2><p><a href="https://capwolf.com/revolutionizing-homes-with-mini-data-centers-nvidia-pultegroup-partnership/">Nvidia and PulteGroup</a> are installing XFRA nodes on residential properties. Liquid-cooled, fanless GPUs mounted on exterior walls. Deploys 6x faster and 5x cheaper than building a data center. The homeowner provides the wall, the electricity, and the network connection. Nvidia keeps the compute revenue. The homeowner gets a discount on their electric bill.</p><p>In Appalachia, homeowners owned the surface while coal companies owned the mineral rights. The wealth left the community. This is the same structure with a different commodity.</p><p>The alternative exists. A Raspberry Pi 5 running open models handles routine inference for $150. Frontier APIs handle the complex reasoning on demand. One of my readers runs three AI systems, coordinated through LocalMemory on a Pi 5&#8212;Claude and two open-source models, that share a unified knowledge layer. Not theoretical. Running in production.</p><p>Most homeowners can&#8217;t set up a home server today. But most homeowners couldn&#8217;t set up a home network in 2003 either. The infrastructure will get easier. The question is whether you&#8217;re positioned as the owner or the tenant when it does. The internet followed this arc: mainframes, client-server, cloud, edge. AI is following. NVIDIA is building step 3. The people who set up step 4 own their data, costs, and independence from providers that can change pricing overnight.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!11Yh!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!11Yh!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg 424w, https://substackcdn.com/image/fetch/$s_!11Yh!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg 848w, https://substackcdn.com/image/fetch/$s_!11Yh!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!11Yh!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!11Yh!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg" width="1200" height="804" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:804,&quot;width&quot;:1200,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:null,&quot;alt&quot;:&quot;&#128680; Jensen Huang wants to turn your house into a data center. NVIDIA is  partnering with a startup called Span and homebuilder PulteGroup to install  mini AI data centers on the side&quot;,&quot;title&quot;:null,&quot;type&quot;:null,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:null,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="&#128680; Jensen Huang wants to turn your house into a data center. NVIDIA is  partnering with a startup called Span and homebuilder PulteGroup to install  mini AI data centers on the side" title="&#128680; Jensen Huang wants to turn your house into a data center. NVIDIA is  partnering with a startup called Span and homebuilder PulteGroup to install  mini AI data centers on the side" srcset="https://substackcdn.com/image/fetch/$s_!11Yh!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg 424w, https://substackcdn.com/image/fetch/$s_!11Yh!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg 848w, https://substackcdn.com/image/fetch/$s_!11Yh!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg 1272w, https://substackcdn.com/image/fetch/$s_!11Yh!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F139e2ce6-0dc8-4062-b77e-698d864830d6_1200x804.jpeg 1456w" sizes="100vw" loading="lazy"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image"><svg role="img" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg"><g><title></title><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption"><em>Image: XFRA node mounted on a home exterior</em></figcaption></figure></div><div><hr></div><p><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);">The portable layer this piece is about, the config you can hand to a different model tomorrow, is the paid build: </span><strong><a href="https://claudecodefornoncoders.substack.com/p/stop-treating-mcp-as-tools-its-your">Stop Treating MCP as Tools. It's Your Architecture</a><span>.</span></strong><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);"> New here? Start with the map: </span><strong><a href="https://claudecodefornoncoders.substack.com/p/start-here-the-claude-architecture">The Claude Architecture Series</a></strong><span data-color="rgb(54, 55, 55)" style="color: rgb(54, 55, 55);">.</span></p><p><em>Claude Code for Non-Coders publishes Tuesdays and Thursdays. Weekend Dispatch covers the week&#8217;s biggest AI developments through a builder&#8217;s lens.</em></p><div><hr></div><p><em>Daniel Williams advises clients about AI tools, strategy, and human resilience at dewilliams.co.</em></p>]]></content:encoded></item></channel></rss>