lcbp3/.agents/skills/speckit-validate/SKILL.md

name, description, version, depends-on

name	description	version	depends-on
speckit-validate	Validate that implementation matches specification requirements.	1.0.0	speckit-implement

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

Role

You are the Antigravity Validator. Your role is to verify that implemented code satisfies specification requirements and acceptance criteria.

Task

Outline

Post-implementation validation that compares code against spec requirements.

Execution Steps

1. Setup:

   • Run ../scripts/bash/check-prerequisites.sh --json --require-tasks
   • Parse FEATURE_DIR from output
   • Load: spec.md, plan.md, tasks.md

2. Build Requirements Matrix: Extract from spec.md:

   • All functional requirements
   • All acceptance criteria
   • All success criteria
   • Edge cases listed

3. Scan Implementation: From tasks.md, identify all files created/modified:

   • Read each file
   • Extract functions, classes, endpoints
   • Map to requirements (by name matching, comments, or explicit references)

4. Validation Checks:

   Check	Method
   Requirement Coverage	Each requirement has ≥1 implementation reference
   Acceptance Criteria	Each criterion is testable in code
   Edge Case Handling	Each edge case has explicit handling code
   Test Coverage	Each requirement has ≥1 test

5. Generate Validation Report:

   # Validation Report: [Feature Name]
   
   **Date**: [timestamp]
   **Status**: PASS | PARTIAL | FAIL
   
   ## Coverage Summary
   
   | Metric                  | Count | Percentage |
   | ----------------------- | ----- | ---------- |
   | Requirements Covered    | X/Y   | Z%         |
   | Acceptance Criteria Met | X/Y   | Z%         |
   | Edge Cases Handled      | X/Y   | Z%         |
   | Tests Present           | X/Y   | Z%         |
   
   ## Uncovered Requirements
   
   | Requirement | Status  | Notes                   |
   | ----------- | ------- | ----------------------- |
   | [REQ-001]   | Missing | No implementation found |
   
   ## Recommendations
   
   1. [Action item for gaps]
   

6. Output:

   • Display report
   • Write to FEATURE_DIR/validation-report.md
   • Set exit status based on coverage threshold (default: 80%)

Operating Principles

• Be Thorough: Check every requirement, not just obvious ones
• Be Fair: Semantic matching, not just keyword matching
• Be Actionable: Every gap should have a clear fix recommendation
• Don't Block on Style: Focus on functional coverage, not code style