/gaia-review-test

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

What it does

Reviews existing test quality -- identifies flaky tests, shared mutable fixtures, hardcoded sleeps, and other test smells. Complements /gaia-review-qa (which checks coverage exists) by checking whether the existing coverage is good.

When to use it

  • A story is in review status and the test suite needs quality review.

Prerequisites

  • Story must be in review status (for story-based reviews). The story file must exist under .gaia/artifacts/implementation-artifacts/.

How to invoke

/gaia-review-test E3-S7

Pass a story key to scope the review to that story's test files.

What it does step by step

  1. Resolve target Locates the story file or review target.
  2. Run deterministic analysis Executes per-stack tooling to collect evidence.
  3. Apply LLM judgment Performs semantic review on top of the deterministic evidence.
  4. Compute verdict The verdict (APPROVE, REQUEST_CHANGES, or BLOCKED) is computed by the verdict resolver -- the LLM does not determine the verdict.
  5. Update Review Gate Records the verdict in the story's Review Gate table.

Inputs

InputSourceDescriptionExample
story-keyPositional argument (optional)Story to review test quality for./gaia-review-test E3-S7

Outputs

A review report is written to .gaia/artifacts/implementation-artifacts/. The story's Review Gate row is updated with PASSED or FAILED.

Example session

> /gaia-review-test E3-S7

Resolving story E3-S7...
Running deterministic analysis...
Applying semantic review...

Verdict: APPROVE
Review Gate updated: PASSED

0 critical, 1 warning, 2 suggestions.

What to run next

Troubleshooting

"Story must be in review status"

Run /gaia-dev-story to implement and transition the story first.

"Story file not found"

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