/gaia-check-dod

user-facing
Category:
Validation
Lifecycle phase:
4 -- Implementation
Arguments:
[story-key]

What it does

/gaia-check-dod checks the Definition of Done checklist in a story file and reports whether all items are satisfied. It parses each checkbox line in the DoD section and produces a COMPLETE or INCOMPLETE verdict with a count of checked versus unchecked items.

When to use it

  • You finished implementing a story and want to verify all DoD items are checked before requesting review.
  • You want a quick summary of which DoD items remain for a story in progress.

Prerequisites

  • A story file must exist at the canonical per-story path .gaia/artifacts/implementation-artifacts/epic-{epic_slug}/{story_key}-{slug}/story.md with a "Definition of Done" section. The check walks three tiers: flat {story_key}-{slug}.md, legacy-nested with stories/, and the new per-story directory — any tier that matches counts as present.

How to invoke

/gaia-check-dod E3-S7

Pass a story key in E{n}-S{n} format.

What it does step by step

  1. Resolve story file Locates the story file using the story key.
  2. Parse Definition of Done section Reads the DoD section and identifies each checkbox line as checked or unchecked.
  3. Generate verdict COMPLETE if all items are checked; INCOMPLETE if any are unchecked.
  4. Report results Prints the verdict, the ratio of checked items, and lists any unchecked items explicitly.

Inputs

InputSourceDescriptionExample
story-keyCommand argument (required)The story to check, in E{n}-S{n} format./gaia-check-dod E3-S7

Outputs

OutputLocationDescription
VerdictConsole outputCOMPLETE or INCOMPLETE with per-item status.

Example session

> /gaia-check-dod E3-S7

## DoD Check: E3-S7

**Verdict:** INCOMPLETE
**Items:** 7/9 checked

### Unchecked
- [ ] No lint warnings
- [ ] All subtasks checked

What to run next

  • Fix the unchecked items, then re-run /gaia-check-dod.
  • /gaia-dev-story runs this check automatically during its Definition of Done step.

Troubleshooting

Story file has no Definition of Done section

The story file is missing the DoD section. Add one manually or regenerate the story with /gaia-create-story.

Story file not found

The story key did not match any file. Check the key format (E{n}-S{n}).