The Definition of Done
"Worked on" is not "done." Stage 6 (review) settles the difference with a machine-checkable gate: the Definition of Done, the operational form of the floor's own "Definition of done." A Request advances review -> done only when DoD == 100% and a CODEOWNER approves. The canonical checklist is definition-of-done.md.
What DoD == 100% means
The DoD is scoped by request type. Every Request runs the Core items; classification flags add conditional items on top:
- Core (every Request) - code review complete, tests green, evals green for any agent-behavior change, the
docs-requiredgate satisfied, signed Conventional Commits, English only, least privilege honored, no unapproved mutation, no secrets, links complete, evidence recorded. - Conditional (added by flags) -
impact.breakingadds migration notes;impact.securityadds a threat model;type: depsadds a dependency review; a design-class change requires its RFC/ADR alreadyAccepted.
Each item is pass, fail, n/a, or waived. DoD == 100% means no item is fail, every applicable item is pass, and every waiver is recorded.
IMPORTANT
A waiver requires { approver, reason } and is valid only for conditional items. Core items cannot be waived - there is no rationale that excuses skipping code review or signed commits.
Two gates, not one
The DoD score is the machine gate. The CODEOWNER approval is a separate human gate, computed independently. Both are required - this is separation of duties: propose is not approve.
The get_dod tool returns the checklist as data, so the gate is queryable rather than a matter of opinion. Its result is done only when no item fails, every applicable item passes or is validly waived, and codeownerApproval.approved is true. A perfect automated score with no human approval is not done.
Closing the loop
The final stage (done / doc-update) closes it: draft the Keep a Changelog entry from the Conventional commits, sync docs/, reindex the UID graph, and write a completion-evidence token to Core. Only when doc-drift is clear and that evidence is recorded does the Request reach done.
TIP
Before you call anything finished, ask the three questions this unit answers: is every applicable DoD item passing (no fails, waivers recorded), did a CODEOWNER approve, and is the completion evidence written? If any answer is no, it is worked on - not done.