acceptance-validation

Verify user story acceptance criteria with evidence-backed code mapping.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/gleeb/ai-registry --skill acceptance-validation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: acceptance-validation
Source: https://github.com/gleeb/ai-registry/tree/main/systems/sdlc/skills/acceptance-validation
Command: npx skills add https://github.com/gleeb/ai-registry --skill acceptance-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents incomplete or incorrect implementations by verifying that each acceptance criterion from a user story was actually implemented, with fresh, checkable evidence.

Core Features & Use Cases

  • Layered scoping for traceability: Uses git diff and the staging document to narrow where to look, with a full codebase fallback if needed.
  • Evidence-backed criterion mapping: Maps every acceptance criterion to specific implementing code references (file:line) and records verification outputs and exit codes.
  • Read-only acceptance gate: Runs verification commands and inspection only, producing actionable failure guidance when evidence is missing or unclear.

Quick Start

Dispatch the sdlc-engineering-acceptance-validator mode to validate a completed story by extracting its acceptance criteria from story.md, locating the implementing code via git diff and the staging doc, running fresh verifications, and generating a validation report with an INCOMPLETE/COMPLETE verdict.

Frequently Asked Questions about acceptance-validation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify acceptance criteria with code mapping after a user story integration?▼

Verify acceptance criteria by mapping each story requirement to specific file:line references using git diff and staging-doc scoping. The validator runs read-only commands to produce evidence-backed validation reports with COMPLETE or INCOMPLETE verdicts.

What is evidence verification in SDLC acceptance validation?▼

Evidence verification confirms every acceptance criterion was actually implemented with fresh, checkable outputs. It records verification command exit codes and maps criteria to specific code references, preventing incomplete or incorrect story implementations from passing the quality gate.

How do I trace acceptance criteria to code using git diff?▼

Trace acceptance criteria by using git diff and staging-doc references for layered scoping to narrow the search area. This maps each criterion to exact file:line locations, falling back to a full codebase scan if the scoped search lacks sufficient evidence.

Does acceptance validation work when story implementation evidence is missing or unclear?▼

Acceptance validation handles missing evidence by producing actionable failure guidance. When verification commands cannot confirm a criterion, the report provides specific fail and unable-to-verify instructions to resolve the gap before user acceptance.

When do I need to run acceptance validation in the software development lifecycle?▼

Run acceptance validation after story integration passes and before user acceptance. It serves as an SDLC quality gate for architects to confirm story completeness, ensuring every acceptance criterion has fresh evidence and correct code implementation.

Can I generate validation reports for incomplete story implementations?▼

Validation reports explicitly handle incomplete implementations by detailing which acceptance criteria failed verification. The report maps evidence gaps, records command outputs, and provides actionable guidance to fix missing or unclear implementation evidence.