speckit-version-guard-validate

Scan changed source files for API patterns conflicting with locked dependency versions.

Updated May 18, 2026
One-click install
npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-version-guard-validate-kamijeong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-version-guard-validate
Source: https://github.com/KamiJeong/tech-bridge-book/tree/main/.agents/skills/speckit-version-guard-validate
Command: npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-version-guard-validate-kamijeong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill scans implementation files for API patterns that conflict with locked dependency versions, helping teams catch compatibility problems before they become runtime issues.

Core Features & Use Cases

  • Compatibility Validation: Checks changed source files against version-guard rules and flags incompatible imports, methods, and usage patterns.
  • Project-Aware Fallbacks: Works with Spec Kit project structure, version-guard reports, and graceful degradation when reports or source-file metadata are missing.
  • Use Case: A developer finishes an implementation and wants a quick advisory scan for version-specific API misuse before merging the change.

Quick Start

Ask the skill to validate the latest implementation for version-incompatible API patterns and report any advisory findings.

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 validate changed source files against locked dependency versions?

To validate changed source files against locked dependency versions, you scan implementation files for API patterns that conflict with locked rules. This flags incompatible imports and methods to catch compatibility problems before merging.

What are version-guard rules and when do I need them for compatibility validation?

Version-guard rules are compatibility tables defining forbidden API patterns for specific dependency versions. You need them during implementation workflows to prevent version-specific API misuse from becoming runtime issues.

How do I scan implementation files for incompatible API patterns before merge?

To scan implementation files for incompatible API patterns before merge, parse version-guard reports and rule tables. The scan locates source files and produces advisory validation output flagging version-specific misuse.

Does the Spec Kit version-guard validation work without existing version-guard reports?

Yes, the Spec Kit version-guard validation works without existing reports by utilizing project-aware graceful degradation fallbacks. It continues scanning source files and producing advisory output even when report metadata is missing.

What's the best way to catch version mismatches in API imports during development?

The best way to catch version mismatches in API imports during development is performing an advisory source scan against locked dependency versions. This checks changed files for incompatible patterns and reports findings before runtime issues occur.

Why does my implementation fail compatibility checks with locked dependency versions?

Your implementation fails compatibility checks with locked dependency versions because source files contain API and import patterns conflicting with locked version-guard rules. Scanning locates these incompatible usages and produces advisory validation findings.