Acceptance criteria vs Definition of Done vs ready
Definition of Done is the same on every story: tests, review, docs. Acceptance criteria change with the work — “account owner can export CSV in under five seconds.” Definition of Ready asks whether those examples exist before you start. The QA testing checklist is how you prove them. Using all three as checklists on the work item improves clarity and cuts ambiguity — status and next steps are visible without a scavenger hunt.
An example: an API that lists Jira issues
Acceptance criteria usually differ from story to story — each list describes what this work item should deliver. Picture a backlog item your team might actually pick up: build a GET endpoint that returns a paginated list of Jira issues for a project. Product wants the fields and permissions clear. Engineering wants pagination and error shapes agreed. QA wants something they can curl in a quick demo.
The checklist below is what that story might carry on the work item — not a template for every API, but a pattern: who can call it, what success looks like, what failure looks like, and how you would show it working.
The best test for each row: can someone demo this without guessing? Your next story gets its own list — same idea, different examples.
Acceptance criteria — list Jira issues API
- Scope
- Authenticated user with browse permission on the project can call GET /issues
- Response is JSON; UI work stays out of this story
- Only issues in Open, In Progress, and Done are returned unless the work item says otherwise
- Happy path
- GET /issues?project=ENG returns 200 with issue key, summary, and status for each row
- page and pageSize query params work; defaults are documented on the work item
- Response includes total count so the client can paginate
- Errors
- Unknown project returns 404; user without browse permission gets 403
- Project with no issues returns 200 with an empty list
- Invalid page or pageSize returns 400 with a clear error body
- Demo
- A curl example is attached — each row above is demoable from it
- Open questions are resolved or parked before development starts
That list belongs on this story alone. In Checklist for Jira you add items like these directly on the work item, tick them as the behavior lands, and save a short starter template when the shape of your team's stories repeats — with fresh examples written each time.
Put this on the work item with Checklist for Jira
Templates, automation, workflow gates, and a Rovo agent — free for teams of up to 10 users.
Save a starter, edit per story
- Checklist for Jira adds a checklist panel on the issue view. Add acceptance criteria there for your scenario — use the example above as a pattern and fill in rows for your work.
- If you want a reusable scaffold, save the headings (scope, happy path, errors, demo-ready) as a project or global template, then rewrite every row when the next story starts.
- You can configure per-template automation to add that scaffold when a Story is created or when work moves to In Progress — or apply it manually from Add → Add from template whenever you need it.
- If your team wants strict gates on the process, add a completion validator on a workflow transition.
- Reset or update items when scope shifts; pair with Definition of Done at the end and the QA testing checklist when testers own a pass — see the automation guide.
Pair it with the rest of the delivery set
Keep Definition of Done on the same issue for the ship bar. Attach the QA testing checklist when someone needs a structured test pass. Use Definition of Ready during refinement if intake quality helps your team. Browse the template hub for the full set.
FAQ
Who owns acceptance criteria?
Product usually drafts them; engineering and QA sharpen them. A checklist on the issue makes that back-and-forth visible instead of buried in comments.
Why do engineering and QA like acceptance criteria on the issue?
Because the checklist is where they receive and understand requirements — concrete examples they can build against and test, visible next to the work instead of buried in a description or a slide deck.
Can acceptance criteria change after development starts?
They often do. Tick or update items on the work item when scope shifts, and link the discussion there so the list stays the source of truth.
How do I know when a criterion is good enough?
Ask how you would demo it. If nobody can show the behavior in a short walkthrough, the row still needs detail.
Put this on the work item with Checklist for Jira
Templates, automation, workflow gates, and a Rovo agent — free for teams of up to 10 users.