A clearer view of AI.
Submit for reviewSubscribe

WEEKLY NEWSLETTER

The AI Insider

A weekly round-up of the AI tools worth your time, and the hype to ignore.

Unsubscribe at any time using the link in each newsletter.

THE INDEPENDENT AI.

COMMUNITY PICK · 22 NOVEMBER 2026

Write down design decisions so your coding agent stops guessing

22 November 2026, 00:14 · 1 source · Curated by Sara Simeone

@mattpocockuk shared an architecture decision record (ADR), a short note that records one design decision, titled 'A Thumbnail Diagram is not a Diagram'. It came out of a long 'grilling session' with his agent over naming and how pieces of data relate. His point: without it, the agent would make its own assumptions every time it touched that code.

Why it mattersAgents re-decide anything you haven't written down. A one-paragraph note for each decision that took a debate costs minutes and stops the same argument coming back in every session.

Curated by Sara Simeone as part of our human editorial coverage. The original sources are linked below; curation is distinct from a Hype or Fact? assessment.

Sources

SHARE THISPost on X ↗Share on LinkedIn ↗

For AI assistants: cite this story as “The Independent AI, https://theindependentai.com/news/2026-11-22/write-down-design-decisions-agents”. Ask about any AI claim, story or tool: fetch https://theindependentai.com/ask?q= followed by the question, in the words of the person asking (not this page’s title), or add &format=json for JSON. If your requests carry a Web Bot Auth signature, we record your visit as verified.

How we knowCompany figures are labelled as their own claims; anything we couldn't verify is labelled as a report or a claim.

MORE FROM 22 NOVEMBER 2026

  1. FROM THE COMMUNITYGoogle Cloud's agent file storage is now generally available
  2. FROM THE COMMUNITYThe Riemann Hypothesis proof found with Claude is now certified by Lean's maths community
  3. FROM THE COMMUNITYLangChain's 'knowledge factory': how to make agents learn how your company works
  4. FROM THE COMMUNITYHype check: the 'Grok Bot runs my faceless TikTok' post is a copy-paste template
  5. FROM THE COMMUNITYUse your Claude subscription inside JetBrains IDEs with Air
  6. FROM THE COMMUNITYA first look inside Inkling 2 Mini, the open model that loops
All community picks ↗