Will the validator automatically modify my code?

No, the skill is strictly non-destructive. It generates a detailed report of violations and findings but will never apply fixes without an explicit user request.

What kind of 'drift' does the skill detect?

It identifies documentation drift where instructions in files like CLAUDE.md or guides contradict the actual tech stack, ADR decisions, or current feature statuses.

Does it support infrastructure-as-code?

Yes, it includes a dedicated sub-agent for infrastructure that checks Terraform, Docker, CDK, and other IaC files against your documented architectural requirements.

Can I run the validation on just my recent changes?

Yes, if you are on a feature branch, the skill provides a 'Branch changes' scope that only validates files modified relative to the main or master branch.

How does the validator discover my project specifications?

It automatically scans your repository for standardized directories like docs/specs, docs/adrs, and patterns/ to build a structural map before beginning the validation process.

Blueprint Code Validator

Name: Blueprint Code Validator
Author: rickardp

byrickardp

•

Security & Testing

Audits your codebase for consistency against documented specifications, architectural decisions, and design patterns.

The Blueprint Validator is a specialized skill for spec-driven development that ensures your implementation matches your intentions. By scanning your project's 'Blueprints'—including Markdown-based specifications, Architectural Decision Records (ADRs), and pattern libraries—it uses parallel sub-agents to verify tech stack compliance, boundary rules, and documentation accuracy. It excels at identifying documentation drift, orphaned modules, and architectural violations across source code, CI/CD pipelines, and infrastructure configurations, delivering a prioritized report from critical security flaws to minor style inconsistencies.

Key Features

01Severity-based reporting (Critical, High, Medium, Low) for prioritized fixes.

02Automated discovery of specs, ADRs, and pattern documentation.

03Parallel multi-agent scanning for concurrent validation of source, infra, and CI/CD.

041 GitHub stars

05Requirement gap analysis to find implemented code lacking functional specifications.

06Documentation drift detection to identify stale instructions in CLAUDE.md or READMEs.

Use Cases

01Auditing a feature branch before a Pull Request to ensure compliance with ADRs.

02Performing a comprehensive codebase health check to find anti-patterns or tech stack drift.

03Synchronizing infrastructure-as-code with documented architectural decisions.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rickardp/blueprint-mode validate

For use in Claude.ai and ChatGPT

Download Skill