260224:1606 20260224:1600 V1.8.0

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

@@ -0,0 +1,93 @@
+---
+name: speckit.validate
+description: Validate that implementation matches specification requirements.
+version: 1.0.0
+depends-on:
+  - speckit.implement
+---
+
+## User Input
+
+```text
+$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**:
+   ```markdown
+   # 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