Definition of done
Published Updated
What is Definition of done?
A definition of done is the agreed check that says a task is finished, such as a passing test, a reviewer’s sign-off or a screenshot that matches the expected result.
The agreed check that says a task is finished, such as a passing test, a critic's sign-off, or a screenshot that matches the expected result.
A definition of done says how everyone will know the task is actually finished. It can be a passing test, a critic agent's sign-off, or a screenshot that matches. It keeps an agent from stopping too early and gives a loop a reason to stop instead of running forever.
How it relates to Orbit
After every run, Orbit’s validation pass checks the commit diff and labels the outcome, so “done” rests on the commit rather than the agent’s word. See Approval & Review for details.
When you would use it
You set a definition of done before an agent starts work whenever the task needs a clear finish line or a reliable way to check the result.
Common operations
- Requiring the signup tests to pass, including a new plus-sign email case, before a bug fix is complete.
- Using a critic's sign-off or a matching screenshot as the final check for a visual task.
Frequently asked questions
Why does an AI agent need a definition of done?
Without one, an agent decides for itself when to stop, and can report success without doing the work.
How does Orbit decide a prompt is done?
After each run, a validation pass inspects the commit diff and labels the outcome, for example Validated or Ghost Ship. See Approval & Review.