Agent skill

implementation-verify

Verifies implementation against specifications by checking requirement fulfillment, task completion, and contract implementation. Generates a fulfillment report with coverage metrics. Always run after /speckit.implement completes.

Stars 3
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/drillan/speckit-gates/tree/main/src/skills/implementation-verify

Metadata

Additional technical details for this skill

author
drillan
category
quality-gate

SKILL.md

implementation-verify

Verifies implementation against specifications after /speckit.implement completes.

Purpose

This skill automatically verifies that your implementation fulfills the specified requirements. It checks:

  • FR requirement fulfillment: How many FR-XXX requirements are addressed by completed tasks
  • Task completion rate: Percentage of tasks marked complete in tasks.md
  • Contract implementation: API endpoints implemented as specified (if contracts/ exists)
  • Test coverage alignment: Implementation aligns with test requirements

Output

The skill outputs a Fulfillment Report with:

  • Coverage metrics (FR, task, contract percentages)
  • List of unimplemented requirements
  • Recommended actions to improve coverage

Usage

This skill runs automatically after /speckit.implement. You can also run it manually:

bash
npx skills run implementation-verify

Exit Codes

Code Status Meaning
0 Complete 100% fulfillment
1 Partial >80% fulfillment
2 Low <80% fulfillment
3 Error Required files missing

Checks Performed

Task Completion Analysis

  1. Parse tasks.md for all task items
  2. Count completed tasks (marked with [X] or [x])
  3. Calculate completion percentage per phase
  4. Identify blocked or incomplete tasks

FR Fulfillment Analysis

  1. Extract all FR-XXX references from spec.md
  2. Cross-reference with completed tasks
  3. Identify FRs without corresponding completed tasks
  4. Calculate fulfillment percentage

Contract Implementation (if contracts/ exists)

  1. Parse contract files for endpoint definitions
  2. Check if corresponding implementation exists
  3. Calculate contract coverage percentage

Metrics Explained

Metric Formula Interpretation
FR Coverage Implemented FRs / Total FRs Requirements addressed
Task Completion Completed Tasks / Total Tasks Work progress
Contract Coverage Implemented Endpoints / Total Endpoints API completeness

Recommendations

After receiving low coverage:

  1. Review unimplemented requirements list
  2. Check for blocked tasks and resolve blockers
  3. Ensure task completion is properly marked in tasks.md
  4. Re-run /speckit.implement for remaining work
  5. Run implementation-verify again to verify progress

Didn't find tool you were looking for?

Be as detailed as possible for better results