Acceptance Criteria
Specific, testable conditions that describe the behavior and outcomes a work item must satisfy to be accepted by product and delivery collaborators.
Download Markdown (.md)Soroush’s Product Wiki · https://wiki.soroush.uk/topic/acceptance-criteria/
01What it means
Acceptance criteria are clear conditions used to confirm that a particular story, requirement, or increment behaves as intended. They describe observable outcomes, important rules, boundaries, and error cases for that item. They differ from a team-wide definition of done, which applies common quality expectations across many items.[1][2]
- Context
- The relevant starting condition
- Trigger
- The action or event being evaluated
- Expected behavior
- What the product must do
- Observable result
- What a reviewer can verify
- Boundary cases
- Important errors, permissions, and limits
- Evidence
- Test, inspection, or demonstrated outcome
Acceptance criteria clarify a work item; they do not replace broader quality standards, discovery, or the team's Definition of Done.
02Why it matters
Ambiguous work creates mismatched assumptions, late disputes, and fragile testing. Agreeing criteria before implementation gives product, design, engineering, and quality specialists a shared basis for examples and tests. It also protects solution flexibility by specifying required behavior rather than dictating internal construction.
03When to use it
Add acceptance criteria while refining work that is likely to enter delivery soon. They are valuable for user stories, defects, integrations, policy changes, and operational behavior. Keep early ideas lighter until they are prioritized; detailing every distant backlog item creates waste as knowledge changes.
04How it works
- Discuss the intended outcome, actors, context, business rules, and major risks.
- Write concise, independently testable statements in language collaborators understand.
- Cover representative success, boundary, permission, failure, and recovery scenarios.
- Use examples or Given-When-Then when sequence and context require extra precision.
- Review criteria with the team and connect them to tests without prescribing unnecessary implementation.
05A practical example
For resetting a password, criteria state that an eligible account receives a time-limited link, the response does not reveal whether an email is registered, an expired link explains how to request another, and successful reset invalidates prior sessions. Each statement can be demonstrated and tested.
06Where it breaks
Criteria cannot enumerate every possible behavior, and long checklists may conceal a poorly framed story. Overly technical wording can constrain design or exclude business collaborators. Passing item-specific criteria also does not guarantee broader qualities such as accessibility, security, maintainability, or product value.
Common mistakes
- Using subjective terms such as fast, intuitive, or correct without a testable threshold.
- Confusing item-specific acceptance criteria with the team’s definition of done.
- Documenting implementation steps instead of observable behavior and outcomes.
07Sources
- What Is Acceptance Criteria?Atlassian · Professional guideWhat Is Acceptance Criteria?
- Agile Workflow in Azure BoardsMicrosoft Learn · Technical documentationAgile Workflow in Azure Boards