---
title: "Write acceptance criteria for a milestone"
description: "A four-step method to write acceptance criteria that both sides can test, so a software milestone is either done or not, without argument."
url: https://lidvizion.ai/guides/write-acceptance-criteria-for-a-milestone/
site: Lid Vizion
index: https://lidvizion.ai/llms.txt
---

[Field guides](https://lidvizion.ai/guides/) 4 steps

# Write acceptance criteria for a milestone

A four-step method to write acceptance criteria that both sides can test, so a software milestone is either done or not, without argument.

For: Owners and product leads paying for, or overseeing, a software milestone from an internal team or a vendor.

Most disputes about software milestones come from one sentence: “it should work properly”. Clear acceptance criteria turn that into checks anyone can run. These four steps write them before work starts, test them during delivery and use them to close the milestone.

## Step 1 — Start from the outcome

**Goal:** Tie every criterion to what the milestone is for.

1. Write the outcome in one sentence: who can do what, that they could not before.
2. List the main tasks a user must complete for the outcome to be true.
3. Name the systems and data each task depends on.
4. Agree who will sign the milestone off.

**You finish with:** An outcome statement and a list of user tasks.

## Step 2 — Write testable criteria

**Goal:** Turn each task into checks with a clear pass or fail.

1. For each task, write: given a starting situation, when the user does something, then this result appears.
2. Include the important failure cases, such as missing data or wrong permissions.
3. Add basics that are easy to forget: access control, error messages, performance on real data volumes.
4. Remove anything that cannot be checked.

**You finish with:** A numbered list of testable acceptance criteria.

## Step 3 — Test during delivery

**Goal:** Find gaps early instead of at the deadline.

1. Review the criteria with the delivery team before work starts.
2. Demo against the criteria at each checkpoint, not only at the end.
3. Record which criteria pass, fail or have changed, and why.
4. Agree any change to the criteria in writing, with its effect on time and cost.

**You finish with:** A running pass and fail record with agreed changes.

## Step 4 — Accept and hand over

**Goal:** Close the milestone cleanly.

1. Run every criterion on the final version with the person who signs off.
2. List open issues and agree which are fixed now and which wait.
3. Confirm documentation, access and ownership are handed over.
4. Sign off in writing and set the next milestone, if any.

**You finish with:** A signed acceptance record and handover.

## Common pitfalls

- Criteria like “works well” that cannot be tested.
- Writing criteria after the work is done.
- Only testing the happy path.
- Changing scope without updating the criteria.

Want a hand getting started?

## Milestone & Custom Delivery

When the work is bounded, we can own the delivery directly—from integration and automation through a custom application or migration.

[See how it works](https://lidvizion.ai/services/milestone-delivery/) [Talk this playbook through](https://lidvizion.ai/contact/?need=milestone-delivery&from=%2Fguides%2Fwrite-acceptance-criteria-for-a-milestone%2F#write)

## See it as a workflow

- [Rescuing a stalled software build](https://lidvizion.ai/use-cases/rescuing-a-stalled-software-build/): Leadership Take a product build that is over time and over budget, find out what is really done, and reset it to a fixed-scope milestone the team can actually deliver.

## More guides like this

- [Plan a legacy system migration](https://lidvizion.ai/guides/plan-a-legacy-system-migration/)
- [Run a fixed-scope technology milestone](https://lidvizion.ai/guides/run-a-fixed-scope-technology-milestone/)

## Related answers

- [How should a company scope a technology or AI milestone?](https://lidvizion.ai/answers/how-to-scope-a-technology-milestone/)
- [When should a company build custom AI software instead of using existing tools?](https://lidvizion.ai/answers/when-should-a-company-build-custom-ai-software/)

Bring the messy version

## One workflow. A better way to run it.

Show us the tools, the handoffs, and the part that keeps slowing your team down.

[Let’s map your workflow](https://lidvizion.ai/contact/) · [Read our approach](https://lidvizion.ai/approach/)