Article · 9 min read

What is Acceptance Criteria? Definition, Examples, and Tips

Atlassian Free Beginner

Once you have described a feature, acceptance criteria is how you say what done means so you and the developer agree before work starts. The Given, When, Then format lets you spell out behavior in plain language a non technical founder can write and a developer can build against. This is how you avoid the it does not work the way I imagined conversation after delivery.

  • State what done looks like for each feature before work begins
  • Given When Then describes behavior in plain, testable language
  • Clear criteria prevent misread expectations after delivery

It answers 2 questions

  1. How do I write a spec for a developer when I'm not technical?
  2. What's a fair way to structure a milestone-based contract with a dev agency?

Read with it

  1. Basecamp's battle-tested, opinionated system for shipping meaningful work in fixed cycles without endless backlogs, a primary... Basecamp / 37signals Book · free online book Shape Up: Stop Running in Circles and Ship Work that Matters Ryan Singer
  2. Michael Seibel, who ran YC, makes the blunt case for shipping something almost embarrassingly simple and learning from real... Y Combinator Startup Library Video · ~10 min video How to Build an MVP Michael Seibel
  3. Michael Seibel's crisp framing of holding the problem and customer tightly while holding the solution loosely, the mindset that... Y Combinator Startup Library Video · ~15 min How to Plan an MVP Michael Seibel
  4. Figma's free plan is genuinely enough to design, tweak, and export a full logo set (SVG for print, PNG for the web) without... Figma Tool · Ongoing tool Figma (free plan) Figma
  5. The creator of Shape Up talks through fixing the time and cutting the scope, which is exactly the discipline that keeps an MVP... Lenny's Podcast Podcast · 90 min A Better Way to Plan, Build, and Ship Products (Shape Up) Ryan Singer
  6. This is the clearest statement of the exact idea in our answer: a spec describes how the product works entirely from the user's... Joel on Software Essay · 10 min read Painless Functional Specifications, Part 2: What's a Spec? Joel Spolsky
eChai Partner Brands The partnership →