New agent chats keep asking product questions you already answered. Write short ADRs so the next agent opens the no instead of making you the memory.

  • (00:00) - Fill the agent's mind
  • (00:36) - Better with Kent
  • (00:46) - The problem: decisions die in chat
  • (02:06) - The solution is ADRs
  • (03:06) - Epic Stack + Remix origin
  • (03:32) - Template + AGENTS.md pointer
  • (04:21) - What to write ADRs about
  • (05:22) - Cameron - 0001 + 0006
  • (06:59) - Darren - wait on skills / 0015
  • (07:54) - One-off hooks - 0021
  • (08:50) - Persistent services - the missing no
  • (11:13) - Don't write diaries or an ADR per PR
  • (11:45) - Homework - three declined decisions
  • (12:33) - Close


Better with Kent - durable skills for people who ship software.

Every new agent conversation starts from zero. Last week's product decision lives in a chat nobody will reopen. You become the memory. That does not scale.

The old fix still works: architecture decision records. An ADR is a short record of a decision already made. Context, decision, consequences, and a revisit-if. Put them in docs/decisions/. Point AGENTS.md at the folder so the agent checks before it proposes a new primitive or surface.

They are not set in stone. They give the next agent a starting place so it does not re-decide, re-ask, or plow into a direction you already refused.

Kent walks real Kody receipts. Cameron's call became 0001 (no package versioning) and 0006 (no repo CI primitive). Darren's call became 0015 (wait on skills over MCP). A late-night one-off hooks idea became 0021: talk first, stay in packages. Then the missing no: persistent services kept getting defended because there was no written decision. After the back-and-forth, the primitive was deleted in kody#1552 and 0025 was written. Write the no before the next agent.

Do not write essays nobody opens, UI diaries, or an ADR on every PR. Ten seconds on the trap, then homework.

Homework: create docs/decisions/ this week. Write three declined decisions you already made. Link the folder from AGENTS.md. Agents will start asking whether the thing you just discussed should be an ADR.

Links

Rss
Podden och tillhörande omslagsbild på den här sidan tillhör Kent C. Dodds. Innehållet i podden är skapat av Kent C. Dodds och inte av, eller tillsammans med, Poddtoppen.