← 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.
Files
<section id="decisions" data-title="Decision records">
<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/tree/main/docs/contributing/decisions" target="_blank" rel="noopener">Decision records</a></h2>
<ul class="big">
<li>Context, decision, consequences</li>
<li>Each one says when to revisit it</li>
<li>Changed your mind? Mark it superseded</li>
</ul>
<p class="src"><a class="quiet" href="https://github.com/kody-hq/kody/tree/main/docs/contributing/decisions" target="_blank" rel="noopener">kody-hq/kody · docs/contributing/decisions</a></p>
<aside class="notes">
<p>Rung 2 (Decisions directory). At BIOS SPHERE I said: "I can't remember if I've got a slide about that. No, I don't have a slide about that. We need to have a slide about that." This is that slide.</p>
<p>The template (docs/contributing/decisions/0000-template.md): number and title, status (accepted, or superseded by a newer record) and date, then Context (what forced the decision), Decision (what was decided; the usual record is a product-shaped no that names the existing primitive that covers the need), and Consequences (what stays simple, what gets harder, and the revisit-if: "in what circumstance would we revisit this decision").</p>
<p>"I don't actually write these either, the agents are writing these." When an agent writes one, it updates the referenced primitives' adrs lists so other agents can find it. It also helps planning: the agent reads the decisions you've already made before proposing something new.</p>
<p>Not new: "I've been doing this for a long time, even before agents were a thing. I did this in the Epic Stack. And I got this idea from the Remix team." "And now the agents do it all for me and it is way, way better."</p>
<p>Stale records: when one is superseded, an agent that opens it follows the link to the newer one. Tickets are different: "A ticket is like, here's the idea of something that we want to do. The ADR is we made this architectural decision and we committed to it." More in the FAQ: <a href="#/faq-adrs">ADRs</a>.</p>
</aside>
</section>