speckit-blueprint-validate

Validate scaffold output against blueprint.md and referenced files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken or inconsistent feature scaffolds by validating that generated files align with the blueprint expectations.

Core Features & Use Cases

  • Blueprint presence validation: Confirms blueprint.md exists before checking generated output.
  • Scaffold file existence checks: Ensures all files referenced by the blueprint were actually created on disk.
  • Scaffold-mode integrity checks: Verifies TODO markers exist where scaffold mode expects placeholder business logic, and detects suspiciously complete implementations that look over-implemented.

Quick Start

Run the validation from the repository root for your feature directory by executing: bash .specify/extensions/blueprint/scripts/bash/validate-scaffold.sh "specs/{feature}/".

Frequently Asked Questions about speckit-blueprint-validate

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

FAQPage Schema
How do I validate generated scaffold files against a blueprint?

You can validate scaffold files by running the validate-scaffold.sh script from the repository root, passing the feature directory path or letting it resolve from the current git branch prefix under specs/.

What does scaffold validation check for in feature creation workflows?

Scaffold validation checks for blueprint.md presence, verifies all referenced scaffold files exist on disk, and ensures scaffold-mode TODO markers remain intact while detecting suspiciously complete implementations that look over-implemented.

Do I need a git branch to run scaffold validation on feature directories?

You do not strictly need a git branch if you pass the feature directory as an argument. The script resolves FEATURE_DIR from the argument or automatically from the current git branch directory prefix under specs/.

Why does scaffold validation detect over-implemented files?

Scaffold validation detects over-implemented files because scaffold mode expects placeholder business logic marked by TODOs. Suspiciously complete implementations indicate the generated scaffold may have deviated from the intended blueprint structure.

Can I check repository consistency for feature scaffolds without a blueprint?

No, you cannot check repository consistency without a blueprint. Blueprint presence validation is the first step; the script confirms blueprint.md exists before checking that generated output and referenced files align with it.