validate-design

Compare design docs with backend and frontend code and generate a remediation report.

1|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/kasiopeiya/oidc-learning-sandbox --skill validate-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-design
Source: https://github.com/kasiopeiya/oidc-learning-sandbox/tree/main/.claude/skills/validate-design
Command: npx skills add https://github.com/kasiopeiya/oidc-learning-sandbox --skill validate-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Aligns design documentation with actual application implementation by automatically detecting mismatches between design docs and code in backend/ and frontend/.

Core Features & Use Cases

  • Reads and structures design documents (docs/backend-design.md, docs/frontend-design.md) and traverses code in backend/ and frontend/.
  • Compares API endpoints, data schemas, environment variables, and error handling to surface inconsistencies.
  • Generates a remediation-focused report that guides engineers on what to fix.

Quick Start

Run the validation command to verify that the design documents align with the implementation and generate a mismatch report.

Frequently Asked Questions about validate-design

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

FAQPage Schema
How do I check if my design documentation aligns with the implemented backend and frontend code?

To validate design consistency, you can automatically compare markdown design docs in the docs/ directory against the actual codebase in backend/ and frontend/ directories to identify structural mismatches. This process surfaces inconsistencies between the documented architecture and the implementation.

What is the best way to detect mismatches between API endpoints in design docs and application code?

Detecting API endpoint mismatches is done by parsing markdown design documents to extract verification items and comparing them against the implemented backend and frontend code. This comparison targets API endpoints, data schemas, and error handling to find discrepancies.

Do I need specific markdown files to validate design consistency in my repository?

Yes, validating design consistency requires access to specific markdown files: docs/backend-design.md and docs/frontend-design.md. The tool parses the markdown structure of these files to extract sections, tables, and verification items for comparison against the codebase.

How do I generate a remediation report for design doc and code inconsistencies?

You generate a remediation-focused report by running a validation command that compares your design documentation with your app implementation. The resulting report guides engineers on exactly what design or code areas need to be fixed to resolve the detected mismatches.

Can I use design validation to compare environment variables and data schemas across my stack?

Yes, design validation compares environment variables and data schemas by reading structured design documents and traversing the backend and frontend code. It checks these specific technical artifacts against the documented expectations to ensure full stack alignment.