AddyOsmani.com - How to write a good spec for AI agents
addyosmani.com · 7,139 words · saved by 1 readers
Learn how to write effective specifications for AI coding agents to improve clarity, focus, and productivity in your AI-driven development workflows.
TL;DR: Aim for a clear spec covering just enough nuance (this may include structure, style, testing, boundaries) to guide the AI without overwhelming it. Break large tasks into smaller ones vs. keeping everything in one large prompt. Plan first in read-only mode, then execute and iterate continuously. “I’ve heard a lot about writing good specs for AI agents, but haven’t found a solid framework yet. I could write a spec that rivals an RFC, but at some point the context is too large and the model breaks down.” Many developers share this frustration. Simply throwing a massive spec at an AI agent
saved by
related reading
- Building Effective AI Agents \ Anthropicanthropic.com
- Building Effective AI Agents \ Anthropicanthropic.com
- Would you fly on an AI-coded plane | Hackle's bloghacklewayne.com
- Best practices for using AI coding Agents | Augment Codeaugmentcode.com
- Effective harnesses for long-running agents \ Anthropicanthropic.com
- A Guide to Claude Code 2.0 and getting better at using coding agents – sankalp's blogsankalp.bearblog.dev
- How I'm using coding agents in September, 2025 — Massively Parallel Procrastinationblog.fsck.com
- How I Use Claude Code | Philipp Spiessspiess.dev
- How to Use Coding Agents Effectively from Planning to Execution and Monitoringcharonhub.deeplearning.ai
- Harness design for long-running application developmentanthropic.com
- Best practices for coding with agents · Cursorcursor.com
- Why We Built Our Own Background Agentbuilders.ramp.com