Skip to content
← Public packages

@kentcdodds/closing-the-agentic-loop

Closing the Agentic Loop: Kent C. Dodds's talk and workshop deck. Default short talk; ?event=aie-2026 is the AIE hour cut with a Podium QR; ?format=full adds labs.

FollowForkOpen app

Files

03-z-agents-md.html

21 lines · 1.8 KB · HTML
<section id="agents-md" data-title="AGENTS.md is a router">
<style>
@scope {
	.src { margin-top: auto; font: 700 44px var(--font-mono); color: var(--muted); }
}
</style>
<h2><a class="quiet" href="https://github.com/kody-hq/kody/blob/main/AGENTS.md" target="_blank" rel="noopener">AGENTS.md is a router</a></h2>
<ul class="big">
	<li>Small: what it is, how to verify, a docs map</li>
	<li>A static check fails when it grows too big</li>
	<li>As little instruction as possible</li>
</ul>
<p class="src"><a class="quiet" href="https://github.com/kody-hq/kody/blob/main/AGENTS.md" target="_blank" rel="noopener">kody-hq/kody · AGENTS.md</a></p>
<aside class="notes">
<p>Rung 1 territory (the agent map). At BIOS SPHERE I walked the live file: "It's intentionally small." It explains what the project is, how to run validation, how to verify locally, how to verify in a production-like environment, and links the docs map. Kody's was about 23 lines then (24 lines on main, checked Nov 4).</p>
<p>"I actually do have a static check that tells the agents or fails the agents if this file gets too big, because you don't want every single agent reading every single thing about your project."</p>
<p>Why small: "models continue to improve, and now those things that you're telling it to do, it has a better way to do that and you are now handicapping your agent. And so you want to give as little instruction as possible while still getting the outcome that you're looking for."</p>
<p>Honest beat from that session: a few lines had "snuck in" that should go. The size check and the docs-freshness cron agent are how it stays small without me reading it.</p>
<p>The docs map is the router: from AGENTS.md, the contributing index links the architecture docs, the primitives map and the decision records (next slides).</p>
</aside>
</section>