Matt Pocock shows how a good ADR prevents agents from making wrong assumptions
mattpocockuk · x · 2026-11-21
Matt Pocock shares an ADR titled "A Thumbnail Diagram is not a Diagram", born from a long grilling-session battle over naming and data relationships. The ADR documents keeping Thumbnail and Diagram models separate: a Thumbnail owns its own Thumbnail Diagram (a tldraw document) with no snapshots and no Playground Home presence; shapes copied into it record their source with content-hash dedup so later merges stay cheap; the face belongs to the Thumbnail, thumbnails are archived never hard-deleted, and clipboard-pasted shapes deliberately record no source. His point: imagine what assumptions an AI coding agent would make if this ADR didn't exist — good ADRs matter for agents.
More from coding & agent
- AI gateways are becoming the key control layer in production AI stacks: 8 capabilities — goyalshaliniuk · 2026-11-21
- Mnemos 2.0: agent memory designed to preserve what matters for the next session — RileyRalmuto · 2026-11-21
- InferenceBench ranks agents on LLM serving speedup: Claude Opus 5.5 tops at 12.08x, agents lose to simple hyperparameter search — maksym_andr · 2026-11-21
- 4 architecture patterns to tame multi-agent system reliability, from a 27-year reliability engineer — bibryam · 2026-11-21
- AutoCut + FrameAtlas: open-source local-first video editing driven by Claude Code via MCP — moheshmohan · 2026-11-21
- InfoQ: What an agent harness is, and two ways to build one — bibryam · 2026-11-21