/gaia-check-review-gate

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

What it does

/gaia-check-review-gate checks the composite Review Gate status for a story. It reads all six review rows (Code Review, QA Tests, Security Review, Test Automation, Test Review, Performance Review) and reports each as PASSED, FAILED, or UNVERIFIED. When all six pass, the story is ready to transition to done.

When to use it

  • After running reviews (individually or via /gaia-review-all), you want to check whether the story is ready to transition to done.

Prerequisites

  • Story file must exist with a Review Gate section. The canonical location is the per-story directory .gaia/artifacts/implementation-artifacts/epic-{epic_slug}/{story_key}-{slug}/story.md. The check walks three tiers: flat {story_key}-{slug}.md, legacy-nested with stories/, and the new per-story directory.

How to invoke

/gaia-check-review-gate E3-S7

What it does step by step

  1. Resolve story Locates the story file by key.
  2. Read gate statuses Reads all six review rows from the story's Review Gate table.
  3. Compute composite verdict READY (all passed), BLOCKED (any failed), PENDING (none run), or IN_PROGRESS (mixed).
  4. Report Displays the per-review table and composite verdict.

Inputs

The command reads the story file, its associated source files (from the Dev Agent Record file list), and project configuration automatically.

Outputs

Text output only. This command does not modify any files.

Example session

> /gaia-check-review-gate E3-S7

Review Gate Check: E3-S7

Composite Verdict: READY
Reviews: 6/6 passed, 0 failed, 0 unverified

| Review             | Status   |
|--------------------|----------|
| Code Review        | PASSED   |
| QA Tests           | PASSED   |
| Security Review    | PASSED   |
| Test Automation    | PASSED   |
| Test Review        | PASSED   |
| Performance Review | PASSED   |

All reviews passed. Story is ready to transition to done.

What to run next

After all reviews pass, run /gaia-check-review-gate to verify the composite gate status and transition the story to done.

Troubleshooting

"Story file not found"

Verify the story key and check that the file exists under .gaia/artifacts/implementation-artifacts/.