Guide

What is a definition of done?

Short answer

A definition of done is a short checklist, agreed by the whole team, that every piece of work must pass before anyone calls it finished. For a software team it usually covers code review, tests, documentation, and release. It applies to every task in the same way, which is what separates it from acceptance criteria, which are written for one task at a time.

Last updated 19 October 2026. Written by the Kaneo team, who also build one of the tools mentioned.

Definition of done vs acceptance criteria

Definition of doneAcceptance criteria
Applies toEvery task the team finishesOne task or user story
AnswersIs this finished to our quality standard?Does this do what was asked?
Written byThe team, once, and revised occasionallyWhoever writes the task, with the requester
ExampleReviewed by a second engineerA monthly customer can switch to annual billing

A definition of done checklist template

This is a starting point for a software team. Copy it, delete what does not apply, and add the checks your team keeps forgetting. Keep it short enough that people actually read it; six to ten items is typical.

CheckWhat it means in practice
Acceptance criteria metEvery criterion on the task is checked by someone other than the author.
Code reviewedAt least one other engineer approved the change, and review comments are resolved.
Tests passNew behaviour has tests, and the full suite passes in CI.
No known regressionsThe areas around the change were checked, and any new bug found has its own task.
Docs updatedUser docs, API reference, and changelog reflect the change, or the task says why none are needed.
AccessibleNew UI works with a keyboard and a screen reader, with sufficient contrast.
ReleasedThe change is merged and deployed to production, or behind a flag that is documented.
Task closedThe task is in a done column, linked to the pull request, with follow-ups filed separately.

Examples for other kinds of teams

Design team

Designs cover empty, loading, and error states. Reviewed with an engineer for feasibility. Components come from the design system or are added to it. Files are named, organised, and linked from the task. Handoff notes cover interactions and edge cases.

Content and marketing team

Fact-checked and proofread by a second person. Title and meta description within length. Links and images checked. Approved by whoever owns the topic. Published, shared, and added to the tracking sheet.

Operations or infrastructure team

Change tested in staging. Rollback steps written down. Monitoring and alerts cover the new component. Runbook updated. Change announced to the people it affects.

How to write your team's definition of done

Start from recent problems

Look at the last few things that came back after being called done. Each one usually points at a missing check: no review, no docs, never actually deployed.

Write it together

A definition the team agreed on gets followed. One handed down by a manager gets ticked without being read.

Make every item checkable

"Good quality" is not a check. "Reviewed by a second engineer" is. If two people could disagree about whether an item is met, rewrite it.

Keep it achievable

If the team cannot meet it on every task today, it will be ignored on every task. Add stricter checks once the basics hold.

Review it every few months

Remove checks that never catch anything and add ones for problems that keep slipping through. Retrospectives are a natural place to do this.

Using a definition of done in Kaneo

Paste the checklist into the task description as checkboxes. Tick each item as it is done, and anyone opening the task sees what is left. Keep the master copy in the project description so it is easy to find and copy.

In the project's workflow settings, turn on Done for the column where finished work lands, and add a Review column before it so work waits there while the checklist is completed. A column's name alone does not mark work as complete in Kaneo; the Done setting does.

If you connect GitHub, Gitea, or GitLab, automations can move a task when its pull request merges. Point that event at the Review column rather than Done if your definition includes steps that happen after merge, such as docs or a production deploy.

Frequently asked

Who owns the definition of done?

The whole team. In Scrum the Scrum Team creates it, using the organisation's standard as a minimum where one exists. In practice whoever runs the team's retrospectives keeps it current.

Is the definition of done the same for every task?

Yes, that is the point of it. Task-specific conditions belong in acceptance criteria. If some kinds of work need different checks, such as a bug fix versus a new feature, keep one short shared list and add the extras to the acceptance criteria.

What is a definition of ready?

The mirror image: a checklist a task must pass before work starts, such as clear acceptance criteria, an estimate, and no open blockers. It stops half-defined work from entering the board.

Is definition of done only for Scrum?

No. It comes from Scrum, but any team that finishes work benefits from agreeing what finished means. Kanban teams often encode it as the exit criteria of their last column.