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.

Stars 123
Forks 27

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.

Expand your agent's capabilities with these related and highly-rated skills.

Fr-e-d/GAAI-framework

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.

123 27
Explore
Fr-e-d/GAAI-framework

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.

123 27
Explore
Fr-e-d/GAAI-framework

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.

123 27
Explore
Fr-e-d/GAAI-framework

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.

123 27
Explore
Fr-e-d/GAAI-framework

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.

123 27
Explore
Fr-e-d/GAAI-framework

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.

123 27
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results