skills.rest
windyroad
windyroadOFFICIAL
Explore all skills by this author →
WebsiteGitHub

wr-c4:check

Validate C4 architecture diagrams against source code and governance policy.

4|1|Updated Apr 7, 2026
Search Tags:#automation#architecture#validation#model#diagram#c4#conformance
One-click install
npx skills add https://github.com/windyroad/agent-plugins --skill wr-c4-check
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wr-c4:check
Source: https://github.com/windyroad/agent-plugins/tree/main/packages/c4/skills/check
Command: npx skills add https://github.com/windyroad/agent-plugins --skill wr-c4-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Keeps C4 architecture diagrams in sync with the codebase by validating the generated model against the repository's components.json and ensuring governance conformance.

Core Features & Use Cases

  • Generate and compare the current architecture model from source to the documented components.
  • Detect drift between architecture diagrams and code, surface actionable failures with guidance to update diagrams or policy.
  • Enforce architecture conformance by validating against governance policy and failing builds when violations are detected.

Quick Start

Regenerate and validate the C4 model against the repository and report any drift or policy violations.

Frequently Asked Questions about wr-c4:check

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

FAQPage Schema
How do I validate that my C4 architecture diagrams match the source code?▼

To validate C4 architecture diagrams against source code, this Skill builds a model from your repository using c4-lib.mjs and compares it to the generated components.json to detect drift. It outputs a PASS or FAIL report with actionable details.

How does C4 diagram conformance checking work with a governance policy?▼

C4 diagram conformance checking works by validating the built architecture model against a governance policy file named architecture-conformance-policy.json, failing the build when policy violations are detected.

What file paths do I need to set up for C4 model validation?▼

For C4 model validation, you need to store generated diagrams at docs/architecture/generated/components.json and your governance policy at governance/architecture-conformance-policy.json.

Can I automate architecture drift detection in my codebase?▼

Yes, you can automate architecture drift detection by running this validation process during your build to compare the generated source code model against documented C4 components and enforce conformance policies.

What happens when C4 diagrams are out of sync with code changes?▼

When C4 diagrams are out of sync with code changes, the validation reports a FAIL status and surfaces actionable failures with guidance to update your architecture diagrams or governance policy.

Related Skills

Explore More Software Engineering Skills→
anderson-0anderson-0
4

architecture-map

Generate Mermaid architecture diagrams from source code with dependency analysis.

Community
Advanced
shep-aishep-ai
241

mermaid-diagrams

Create and render Mermaid diagrams from text for software design documentation.

Official
Advanced
fragments-sdkfragments-sdk
1

fragments/policy

Create and manage Fragments design governance policies from natural language.

Official
Intermediate
manuelbrandner85manuelbrandner85

diagramming-code

Generate Mermaid diagrams from Trailmark code graphs.

Community
Intermediate