speckit-version-guard-validate

Detects version-incompatible API patterns in source files using Compatibility Rules.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-version-guard-validate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-version-guard-validate
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-version-guard-validate
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-version-guard-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents broken builds by scanning newly generated or modified code for API patterns that conflict with the project's locked dependency versions.

Core Features & Use Cases

  • Post-implementation compatibility validation: Compares changed files against Compatibility Rules to find incompatible API usage.
  • Artifact-aware scanning: Reads the version-guard report produced by an earlier check (or uses in-memory fallback when disk artifacts are missing).
  • Security awareness for locked versions: Surfaces critical/high CVEs from the Known Issues section to remind reviewers to assess risk.

Quick Start

Ask your agent to run speckit-version-guard-validate after implementation to produce an advisory compatibility report for the files changed during that phase.

Frequently Asked Questions about speckit-version-guard-validate

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

FAQPage Schema
How do I check for version-incompatible API patterns after implementation?

You can validate API compatibility by scanning newly modified source files against Compatibility Rules. This process detects version-incompatible API patterns based on your project's locked dependencies without blocking the workflow.

What is static scanning for API compatibility and how does it work?

Static API compatibility scanning parses mandatory constraint rules and reviews changed source files to identify mismatched API patterns. It relies on a version-guard report but applies an in-memory fallback when disk artifacts are missing.

Does version guard validation block my workflow when it finds incompatible code?

Version guard validation does not block your workflow. It outputs advisory findings that highlight incompatible API patterns and surfaces critical CVEs from Known Issues, allowing reviewers to assess risk without halting the pipeline.

Can I scan TypeScript and JavaScript files for dependency locking issues?

Yes, you can scan TypeScript and JavaScript files for dependency locking issues. The validation applies to source files within your project, reading the feature directory to compare changed code against locked dependency versions.

What happens if the version-guard report artifact is missing during code validation?

If the version-guard report artifact is missing, the code validation uses an in-memory fallback to continue scanning. This ensures the post-implementation compatibility check still runs and surfaces advisory findings for your changed files.

Why do I need to run compatibility checks after generating new code?

You need to run compatibility checks after generating new code to prevent broken builds. Scanning modified files ensures newly introduced API patterns do not conflict with the project's locked dependency versions or known security issues.