definition-of-done

Designs and evaluates Definition of Done criteria for software delivery loops.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/tedeuxx/tadeumendonca-skills --skill definition-of-done-tedeuxx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: definition-of-done
Source: https://github.com/tedeuxx/tadeumendonca-skills/tree/main/skills/definition-of-done
Command: npx skills add https://github.com/tedeuxx/tadeumendonca-skills --skill definition-of-done-tedeuxx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams declare work "done" based on reviewer impression rather than agreed, checkable criteria, so review quality varies by who is looking and when. This Skill turns "done" into an objective, falsifiable, evidence-producing checklist designed from the project's actual surfaces, and separates what CI gates prove from what only human review can verify. ## Core Features & Use Cases - DoD design from scratch: Derives criteria from what the project actually delivers, tests each for objectivity, falsifiability, and evidence production, and names the four failure modes (vague criteria, unchecked lists, copied templates, over-heavy checklists). - Concrete nine-row DoD with a gate seam table: Applies this loop's own Definition of Done, marking which criteria CI proves (coverage, lint), which are partial (regressions, security posture), and which no gate can prove (observability, docs, consumer reach). - Use Case: A reviewer finishing a merge request walks the nine criteria, names the artifact a feature must reach outside the diff, and records which rows a green pipeline did not establish, instead of treating "CI is green" as "the DoD is met". ## Quick Start Ask the agent to evaluate whether the current slice satisfies the Definition of Done criteria and identify which rows no gate proves.

Frequently Asked Questions about definition-of-done

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a Definition of Done from scratch?

Start from what the project actually delivers, not a generic template. For each candidate criterion, verify it is objective, falsifiable, and evidence-producing, assign who checks it, and confirm it traces to a real cost of skipping it.

What makes a Definition of Done criterion well-formed?

A well-formed criterion is objective (two reviewers reach the same verdict), falsifiable (a concrete way to fail exists), and evidence-producing (it leaves a named artifact like a passing check or command output).

What is the difference between Definition of Done and quality gates?

Quality gates are CI/CD metrics and thresholds enforced mechanically, while a Definition of Done covers completeness of a work item. A green pipeline proves only some DoD rows; others require human review and cannot be gated.

Why does a Definition of Done fail in practice?

Four common failure modes: vague unfalsifiable criteria, a checklist nobody actually walks item-by-item, criteria copied from another project without adaptation, and a list so heavy the team routes around it.

Can a green CI pipeline mean the Definition of Done is met?

No. CI proves only automatable criteria like coverage thresholds and lint. Criteria such as observability, documentation updates, and whether a feature reaches its consumer have no mechanical gate and require reviewer judgment.

When should I use Definition of Ready instead of Definition of Done?

Use Definition of Ready at the entry gate to resolve ambiguity before building, and Definition of Done at the exit gate to verify completeness. A strong DoD cannot rescue an item that was ambiguous when work started.