Review Story
Testing & Qualityreview-storyReview Story is an Agent Skill for testing & quality published in the SynkraAI/aiox-core repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
QA gate for a story — verdict PASS/CONCERNS/FAIL/WAIVED + lifecycle transition. Use when: review story, qa gate, *qa-gate, /review-story.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/SynkraAI/aiox-core/blob/HEAD/.claude/skills/review-story/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/review-story, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
review-story
Lean SDC skill. Task is source of truth for gate schema and review depth.
Task SOT
Primary:
.aiox-core/development/tasks/qa-gate.md
Supporting (deep review):
.aiox-core/development/tasks/qa-review-story.md
Input
$ARGUMENTS[0]— story path$ARGUMENTS[1]— mode (yolo|interactive)
Protocol
- Load
qa-gate.mdand execute review + gate-file write. - Adopt @qa (or story quality_gate if ≠ executor).
- Write gate under
docs/qa/gates/(path per task/core-config). - Update story QA Results section with verdict + gate path.
- Verdicts: PASS | CONCERNS | FAIL | WAIVED.
Status policy (canonical lifecycle)
The QA task and .claude/rules/story-lifecycle.md are authoritative.
| Verdict | Status action |
|---|---|
| PASS / CONCERNS | Set Done and append the InReview → Done Change Log transition. |
| FAIL | Return to InProgress; list fixes for apply-qa-fixes |
| WAIVED | Document waiver, set Done, and append the lifecycle transition. |
Post-phase verification
- Gate file on disk (or equivalent QA Results with explicit verdict)
- Story QA Results updated
- PASS/CONCERNS/WAIVED set Done; FAIL sets InProgress
Forbidden
- Self-approving as the same agent that implemented (anti-self-review)
- Product harvest trees or product-only local canon (see ARCH-A denylist)
git push