architecture-validator

Validate architecture descriptions against domain policies and PRD quality.

1|Updated Apr 12, 2026

Search Tags:#architecture #validation #adr #reporting #sdlc #policies

Ready to run

npx skills add https://github.com/mytechsonamy/VibeFlow --skill architecture-validator-mytechsonamy

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture-validator
Source: https://github.com/mytechsonamy/VibeFlow/tree/main/skills/architecture-validator
Command: npx skills add https://github.com/mytechsonamy/VibeFlow --skill architecture-validator-mytechsonamy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates a proposed software architecture against domain policies, the approved PRD, and (optionally) the current codebase's import graph. Writes .vibeflow/reports/architecture-report.md and one .vibeflow/reports/adr-NNN-<slug>.md per accepted decision. Blocks advance if any criticalPolicyViolations > 0. PIPELINE-1 step 2.

Core Features & Use Cases

The validator reads the policy catalog and architecture description, producing deterministic, explainable findings aligned to domain rules.
It auto-generates Architecture Decision Records (ADRs) for new decisions and records them in the ADR archive.
It outputs a formal architecture report and ADR artifacts under .vibeflow/reports and .vibeflow/artifacts/adr, respectively, to gate feature progression.

Quick Start

Run the architecture validator against the architecture description, PRD quality report, domain config, and risk tolerance to obtain a verdict and remediation guidance.

Frequently Asked Questions about architecture-validator

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

FAQPage Schema

How do I validate a software architecture against domain policies and ADRs?▼

Architecture validation evaluates your architecture description against domain policies, PRD quality, and ADRs to determine compliance. It applies universal and domain-specific policies from the policy catalog to generate a formal report with deterministic verdicts and remediation guidance.

What is an architecture decision record and when do I need to create one?▼

An Architecture Decision Record (ADR) documents a significant architectural choice. You need to create one when new decisions are identified during architecture validation; the validator auto-generates ADR files and records them in the ADR archive to maintain explainable design history.

How do I generate an architecture report with a compliance verdict and remediation guidance?▼

To generate an architecture report, run the validator against your architecture description, PRD quality report, domain config, and risk tolerance. It outputs a formal architecture report under .vibeflow/reports containing the compliance verdict and remediation guidance.

Does architecture validation block feature progression if critical policy violations are found?▼

Yes, architecture validation blocks feature progression if any criticalPolicyViolations are greater than zero. The validator gates advancement by evaluating the architecture against the policy catalog and producing a formal report to ensure compliance before proceeding.

Can I evaluate an architecture description against the current codebase import graph?▼

Yes, you can optionally evaluate an architecture description against the current codebase import graph. The validator reads the policy catalog and architecture description to produce deterministic findings aligned to domain rules and approved PRD.

What is the best way to ensure architecture compliance during the software development lifecycle?▼

The best way to ensure architecture compliance is applying universal and domain-specific policies from a policy catalog during validation. This produces deterministic, explainable findings and auto-generates ADRs for new decisions to gate feature progression securely.