{
  "id": "58ff474b1096",
  "url": "https://www.oreilly.com/radar/how-to-write-a-good-spec-for-ai-agents/",
  "title": "How to Write a Good Spec for AI Agents – O’Reilly",
  "note": "Long (37 min) but genuinely useful if you're building with coding agents regularly. Addy Osmani's five-principle framework is practical, not theoretical — especially the three-tier boundary system (always/ask/never) and the point that modular focused prompts beat one giant spec. Worth reading in full, not just skimming.",
  "voice": "jamie",
  "saved": "2026-02-27T05:06:08Z",
  "host": "oreilly.com",
  "kind": "page",
  "tags": [],
  "record": "https://links.thingelstad.xyz/links/58ff474b1096/",
  "markdown": "https://links.thingelstad.xyz/links/58ff474b1096.md",
  "issues": [],
  "connections": {
    "same_host": {
      "count": 20,
      "page": "https://links.thingelstad.xyz/hosts/oreilly.com/",
      "nearest": [
        {
          "id": "4c03d6d183f7",
          "title": "What We Learned from a Year of Building with LLMs (Part I) – O’Reilly",
          "url": "https://www.oreilly.com/radar/what-we-learned-from-a-year-of-building-with-llms-part-i/",
          "record": "https://links.thingelstad.xyz/links/4c03d6d183f7/"
        },
        {
          "id": "2654a181afd1",
          "title": "How to Fix “AI’s Original Sin” – O’Reilly",
          "url": "https://www.oreilly.com/radar/how-to-fix-ais-original-sin/",
          "record": "https://links.thingelstad.xyz/links/2654a181afd1/"
        },
        {
          "id": "9fb54a584322",
          "title": "The End of Programming as We Know It – O’Reilly",
          "url": "https://www.oreilly.com/radar/the-end-of-programming-as-we-know-it/",
          "record": "https://links.thingelstad.xyz/links/9fb54a584322/"
        },
        {
          "id": "751708de9e48",
          "title": "MCP in Practice – O’Reilly",
          "url": "https://www.oreilly.com/radar/mcp-in-practice/",
          "record": "https://links.thingelstad.xyz/links/751708de9e48/"
        },
        {
          "id": "6c38f5689c6a",
          "title": "The Agentic Commerce Revolution – O’Reilly",
          "url": "https://www.oreilly.com/radar/the-agentic-commerce-revolution/",
          "record": "https://links.thingelstad.xyz/links/6c38f5689c6a/"
        }
      ]
    },
    "same_week": {
      "count": 21,
      "nearest": [
        {
          "id": "ddc00755200b",
          "title": "How I built Timeframe, our family e-paper dashboard - Joel Hawksley",
          "url": "https://hawksley.org/2026/02/17/timeframe.html",
          "record": "https://links.thingelstad.xyz/links/ddc00755200b/"
        },
        {
          "id": "04a79c6c15f4",
          "title": "Email Marketing Skill for Claude Code | Email Marketing Bible",
          "url": "https://www.emailmarketingskill.com/",
          "record": "https://links.thingelstad.xyz/links/04a79c6c15f4/"
        },
        {
          "id": "60a4c74f4e5c",
          "title": "Loon — A LISP that flies",
          "url": "https://loonlang.com/",
          "record": "https://links.thingelstad.xyz/links/60a4c74f4e5c/"
        },
        {
          "id": "a81550cde2f2",
          "title": "The Software Development Lifecycle Is Dead | Boris Tane",
          "url": "https://boristane.com/blog/the-software-development-lifecycle-is-dead/",
          "record": "https://links.thingelstad.xyz/links/a81550cde2f2/"
        },
        {
          "id": "6f57a6005200",
          "title": "tldraw • very good free whiteboard",
          "url": "https://www.tldraw.com/?ref=DenseDiscovery-376",
          "record": "https://links.thingelstad.xyz/links/6f57a6005200/"
        }
      ]
    },
    "mentions": [],
    "mentioned_by": [],
    "saved_twice": []
  },
  "elsewhere": {
    "wayback": "https://web.archive.org/web/*/https://www.oreilly.com/radar/how-to-write-a-good-spec-for-ai-agents/"
  }
}