specops-spec-conformance

Identify gaps between analysis and implementation specs and patch the implementation.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill specops-spec-conformance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: specops-spec-conformance
Source: https://github.com/ryan-mahoney/ryan-llm-skills/tree/main/skills/specops-spec-conformance
Command: npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill specops-spec-conformance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit and reconcile a SpecOps analysis spec with its implementation spec to identify gaps, ensure traceability, and patch the implementation so it faithfully preserves analysis behavior.

Core Features & Use Cases

  • Gap discovery: locate missing, altered, or contradicted requirements between analysis and implementation specs.
  • Patch generation: produce precise changes to the implementation spec to restore conformance and document rationale.
  • Parallel consultation: leverage subagents to review gaps in parallel, accelerating resolution.
  • Audit reporting: emit an implementation-conformance report alongside the updated spec for traceability.

Quick Start

Provide the analysis and implementation spec paths and run the conformance audit to produce patches and an audit log.

Frequently Asked Questions about specops-spec-conformance

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

FAQPage Schema
How do I audit gaps between an analysis spec and its implementation?

To audit gaps between an analysis spec and its implementation, provide the file paths for both specs. The audit identifies missing, altered, or contradicted requirements and generates patches to restore conformance.

How does spec conformance patching work for traceability?

Spec conformance patching works by verifying traceability, edge cases, and open questions against the analysis spec. It then outputs precise implementation patches and a conformance report file to document the rationale.

What is the best way to reconcile an implementation spec with analysis behavior?

The best way to reconcile an implementation spec with analysis behavior is to run a conformance audit. It locates gaps and applies patches to the implementation spec, ensuring it faithfully preserves the original analysis requirements.

Can I parallelize spec gap discovery and resolution?

Yes, you can parallelize spec gap discovery and resolution. The audit leverages subagents to review identified gaps in parallel, accelerating the resolution and patching process.

Does spec conformance patching handle deferred design decisions?

Yes, spec conformance patching handles deferred design decisions. The audit log produced alongside the updated implementation spec explicitly documents any deferred design decisions for later review.

What files are generated after running a spec conformance audit?

After running a spec conformance audit, you get patched implementation specs and an audit log. A single conformance report file is also emitted next to the implementation spec for traceability.