openspec-verify-change

Generate structured verification reports for OpenSpec change implementations.

47|2|Updated Oct 30, 2023
One-click install
npx skills add https://github.com/runtime-env/runtime-env --skill openspec-verify-change-runtime-env
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/runtime-env/runtime-env/tree/main/.gemini/skills/openspec-verify-change
Command: npx skills add https://github.com/runtime-env/runtime-env --skill openspec-verify-change-runtime-env

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams ensure that a given change's implementation fully aligns with its change artifacts (specs, tasks, and design) before archiving.

Core Features & Use Cases

  • Artifact-driven verification: compares implementation against openspec delta specs to confirm requirements are addressed.
  • Status-driven analysis: loads context from openspec instructions and reads specs and tasks.
  • Coherence checks: aligns design decisions and patterns with the codebase and reports gaps.
  • Output: generates a comprehensive verification report detailing completeness, correctness, and coherence.

Quick Start

  • Run: openspec list --json to view changes.
  • Then select a change to verify and apply artifacts with: openspec instructions apply --change "<name>" --json
  • Review the verification report and inspect CRITICAL/WARNING/SUGGESTION sections to determine readiness for archiving.

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 change implementations align with specs before archiving?

To verify change implementations align with specs, you parse OpenSpec delta specs and task artifacts to compare the implementation against requirements, generating a structured report covering completeness, correctness, and coherence.

What is artifact-driven verification for software changes?

Artifact-driven verification compares a change's implementation directly against its OpenSpec delta specs, tasks, and design artifacts to ensure requirements are addressed and reports gaps before archiving.

How do I check if my codebase matches OpenSpec delta specs and design decisions?

You check if your codebase matches OpenSpec delta specs by loading the change context and running coherence checks that align design decisions and patterns with the implementation to report any gaps.

Can I use OpenSpec instructions to validate changes before release?

Yes, you can use OpenSpec instructions to validate changes before release by applying the command with a specific change name to load context, then reviewing the generated verification report for readiness.

What does a verification report for OpenSpec change artifacts include?

A verification report for OpenSpec change artifacts includes comprehensive sections detailing completeness, correctness, and coherence, along with CRITICAL, WARNING, and SUGGESTION sections to determine archiving readiness.

When do I need to run a coherence check on my change artifacts?

You need to run a coherence check on your change artifacts when preparing for release to ensure that design decisions and patterns are fully aligned with the codebase and that all tasks are complete.