Writing Good Specs

The canonical spec-writing guide lives in AGENTS.md — the same document that AI coding assistants read when integrating PAW.

See the "Writing Good Specs" section there for:

• The #1 practice: iterate with test cases
• Spec-tuning tips (role naming, output constraints, positive vs negative instructions, field ordering, and more)
• Example specs with Input: ... Output: ... format

You can also copy the full AGENTS.md from the AI Agents page and save it as AGENTS.md in your project root — AI assistants will read it automatically.