# How to Write a Good Spec for AI Agents – O’Reilly

<https://www.oreilly.com/radar/how-to-write-a-good-spec-for-ai-agents/>

- Host: [oreilly.com](https://links.thingelstad.xyz/hosts/oreilly.com/)
- Saved: February 26, 2026 (2026-02-27T05:06:08Z)
- Record: https://links.thingelstad.xyz/links/58ff474b1096/
- JSON: https://links.thingelstad.xyz/links/58ff474b1096.json

## What Jamie wrote

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.

## Facts

- Kind: [Page](https://links.thingelstad.xyz/kinds/page/)

## Same host

- [What We Learned from a Year of Building with LLMs (Part I) – O’Reilly](https://links.thingelstad.xyz/links/4c03d6d183f7/) (oreilly.com, May 30, 2024)
- [How to Fix “AI’s Original Sin” – O’Reilly](https://links.thingelstad.xyz/links/2654a181afd1/) (oreilly.com, July 20, 2024)
- [The End of Programming as We Know It – O’Reilly](https://links.thingelstad.xyz/links/9fb54a584322/) (oreilly.com, February 11, 2025)
- [MCP in Practice – O’Reilly](https://links.thingelstad.xyz/links/751708de9e48/) (oreilly.com, September 25, 2025)
- [The Agentic Commerce Revolution – O’Reilly](https://links.thingelstad.xyz/links/6c38f5689c6a/) (oreilly.com, February 12, 2026)

## Saved the same week

- [How I built Timeframe, our family e-paper dashboard - Joel Hawksley](https://links.thingelstad.xyz/links/ddc00755200b/) (hawksley.org, February 26, 2026)
- [Email Marketing Skill for Claude Code | Email Marketing Bible](https://links.thingelstad.xyz/links/04a79c6c15f4/) (emailmarketingskill.com, February 26, 2026)
- [Loon — A LISP that flies](https://links.thingelstad.xyz/links/60a4c74f4e5c/) (loonlang.com, February 26, 2026)
- [The Software Development Lifecycle Is Dead | Boris Tane](https://links.thingelstad.xyz/links/a81550cde2f2/) (boristane.com, February 26, 2026)
- [tldraw • very good free whiteboard](https://links.thingelstad.xyz/links/6f57a6005200/) (tldraw.com, February 26, 2026)

## Elsewhere

- Wayback Machine: https://web.archive.org/web/*/https://www.oreilly.com/radar/how-to-write-a-good-spec-for-ai-agents/