Spec Writing for AI Agents

Why Specs Matter

Vague prompts produce vague code. A good spec gives the agent:

• What to build (requirements, not solutions)
• Why it exists (constraints, context, tradeoffs)
• How to verify it's correct (acceptance criteria)
• What not to do (explicit constraints)

One well-written spec is worth 10 follow-up corrections.

Spec Template

## Goal
One sentence: what should exist after this is done that doesn't exist now?