Agent skill
qa-review
Validate that implemented code fully satisfies Story acceptance criteria, respects rules, and introduces no regressions. This is the hard quality gate — no pass means no delivery. Activate after implementation is complete.
Install this agent skill to your Project
npx add-skill https://github.com/Fr-e-d/GAAI-framework/tree/main/.gaai/core/skills/delivery/qa-review
Metadata
Additional technical details for this skill
- id
- SKILL-QA-REVIEW-001
- track
- delivery
- author
- gaai-framework
- status
- stable
- version
- 1.0
- category
- delivery
- updated at
- 1772064000
SKILL.md
QA Review
Purpose / When to Activate
Activate after implementation is complete. This is a hard quality gate.
No pass → no delivery.
Process
1. Story Compliance Check
- Parse Story YAML frontmatter
- Extract acceptance criteria
- Validate each criterion is demonstrably satisfied in code
- Any criterion unclear or unmet → FAIL immediately
2. Scope Integrity Check
- Only files within Story scope were modified
- No feature creep introduced
- No unrelated refactors included
- Unexpected changes → FAIL
3. Rule Enforcement
- Confirm compliance with each applicable rule
- Surface violations explicitly
- Any broken rule → FAIL
4. Regression Scan
- Broken tests → FAIL
- Behavior drift → FAIL
- Known risk patterns from memory → FAIL
5. Quality Checks
- Error-prone operations lack error handling → FAIL
- External input enters functions without validation → FAIL
- Identifiers are ambiguous or non-descriptive → FAIL
- A function or module handles more than one responsibility without decomposition → FAIL
- Dead code or unreachable branches present → FAIL
- Tests were disabled or skipped to make the suite pass → FAIL
Outputs
If PASS:
status: PASS
validated_stories:
- E01S01
notes:
- All acceptance criteria satisfied
- No rule violations
- No regressions detected
If FAIL:
status: FAIL
blocking_issues:
- Story E01S01: acceptance criterion #2 not satisfied
- Rule code-style violated in services/api/user.ts
- Unexpected file modified: services/payments/
recommended_actions:
- Fix acceptance behavior
- Revert out-of-scope change
- Apply code rule formatting
Hard Rules
This skill must NEVER:
- Modify code
- Reinterpret Stories
- Negotiate acceptance criteria
- Approve partial conformance
If it's not explicitly validated → it's broken. If it's broken → it doesn't ship.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ci-watch-and-fix
Watch GitHub Actions CI after PR creation, detect failures, extract logs, apply minimal fixes, and re-push — keeping the delivery session alive until CI resolves or escalating after 3 cycles. Activate immediately after gh pr create and before marking the story done.
compose-team
Assemble the context bundles for each sub-agent based on evaluate-story output. Produces spawn-ready packages for Planning, Implementation, QA, or MicroDelivery sub-agents. Activate after evaluate-story, before spawning any sub-agent.
coordinate-handoffs
Validate sub-agent handoff artefacts, sequence phase transitions, and manage retry and escalation logic. Activate after each sub-agent terminates to determine next action.
implement
Generate correct, minimal, maintainable code that satisfies a validated Story's acceptance criteria against an execution plan. Activate when a Story is validated, a plan exists, and all prerequisites are unambiguous.
delivery-high-level-plan
Transform validated Stories into a clear, minimal, governed execution plan. Used by the Planning Sub-Agent as the first planning pass before prepare-execution-plan for Tier 2/3, or as the sole planning output for simple Stories.
prepare-execution-plan
Decompose a high-level delivery plan into a precise, file-level execution sequence with explicit ordering, edge cases, and test checkpoints. Activate after delivery-high-level-plan for complex or multi-phase Stories before implementation begins.
Didn't find tool you were looking for?