openspec-verify-change

Verify software implementations against OpenSpec change artifacts and output a prioritized markdown report.

18|3|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/igamenovoer/houmao --skill openspec-verify-change-igamenovoer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/igamenovoer/houmao/tree/main/tests/fixtures/plain-agent-def/skills/openspec-verify-change
Command: npx skills add https://github.com/igamenovoer/houmao --skill openspec-verify-change-igamenovoer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec.

What problem does it solve?

Verifies that a proposed implementation actually matches the change artifacts (specs, tasks, and design), reducing the risk of incomplete, incorrect, or mismatched work before archiving.

Core Features & Use Cases

  • Change selection with validation: Lists available OpenSpec changes and forces the user to select when the change name is missing or ambiguous.
  • Completeness checks: Validates task completion by reading tasks checkboxes and verifies spec requirements presence from delta spec files.
  • Correctness and coherence checks: Detects potential divergence between requirement intent and code evidence, checks scenario coverage via tests, and verifies adherence to design decisions when design.md is present.
  • Actionable, priority-based report: Produces a structured verification report with CRITICAL, WARNING, and SUGGESTION issues and specific recommendations.

Quick Start

Ask the agent to verify a change by running openspec-verify-change with the change name you want to archive.

Frequently Asked Questions about openspec-verify-change

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

FAQPage Schema
How do I verify that my code implementation matches OpenSpec change artifacts?

Spec verification for change management assesses whether your implementation satisfies OpenSpec tasks, delta specs, and design decisions. It performs static evidence checks to detect divergences between requirement intent and code, ensuring coherence before archiving.

What is requirements traceability and how does it apply to spec-driven development?

Requirements traceability in spec-driven development tracks whether each requirement and scenario in a change artifact has corresponding code evidence and test coverage. It ensures that implementation changes match the intended design decisions and spec deltas completely before archiving.

How do I check test coverage and scenario completeness for spec changes before archiving?

You check test coverage by scanning the implementation for scenario evidence and verifying that all task checkboxes in the change artifacts are complete. The verification process then outputs a prioritized markdown report highlighting critical coverage gaps and warnings before archiving.

Can I use static evidence checks to detect divergence between requirements and code?

Yes, static evidence checks can detect potential divergence between requirement intent and code evidence by analyzing delta spec files and design documents. This correctness and coherence check identifies mismatches and generates actionable recommendations with critical, warning, and suggestion priorities.

Do I need OpenSpec installed to run spec verification on my implementation?

Yes, you need OpenSpec installed because the verification process applies OpenSpec instructions to load change artifacts, parse tasks, and scan for requirement evidence. The dependency is required to select unambiguous changes and generate the completeness assessment.

What are the limitations of automated spec verification for change management?

Automated spec verification relies on static evidence checks and parsed task checkboxes, meaning it may not fully evaluate complex runtime behaviors or subjective design coherence. It outputs warnings and suggestions but requires human review to confirm the final archiving decision for nuanced changes.