c4-audit-system

Audit software system documentation against source code implementations.

2|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/Vinedine/structurizr-mkdocs-generatr --skill c4-audit-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: c4-audit-system
Source: https://github.com/Vinedine/structurizr-mkdocs-generatr/tree/main/.claude/skills/c4-audit-system
Command: npx skills add https://github.com/Vinedine/structurizr-mkdocs-generatr --skill c4-audit-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the common problem of documentation drift, where the architectural intent described in documentation diverges from the actual implementation in the codebase.

Core Features & Use Cases

  • Drift Detection: Automatically compares documented entities in 0000-introduction.md against actual code repositories.
  • Naming Compliance: Identifies inconsistencies between container display names and variable naming conventions.
  • Relationship Auditing: Verifies if the documented relationship (Manage vs Consume) accurately reflects the code's behavior.

Quick Start

Ask the skill to audit the entities for your specific software system to generate a report of discrepancies between your documentation and the source code.

Frequently Asked Questions about c4-audit-system

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

FAQPage Schema
How do I detect documentation drift between my architecture docs and source code?

To detect documentation drift, you audit software documentation by comparing documented entities against actual source code implementations to identify naming, relationship, and missing entity mismatches. This requires repository code and workspace DSL files.

How do I audit C4 architecture diagrams for naming compliance?

You audit C4 architecture diagrams for naming compliance by comparing container display names against variable naming conventions in the source code. This identifies inconsistencies between documented architectural intent and implemented bounded contexts.

Does the architecture audit work with Structurizr workspace DSL files?

Yes, the architecture audit works with Structurizr workspace DSL files. It requires access to these DSL files alongside repository code to perform structural analysis and generate a drift report across bounded contexts.

How can I verify if documented relationships match the code's behavior?

You verify documented relationships by performing relationship auditing, which checks if documented interactions like Manage versus Consume accurately reflect the code's actual behavior. This ensures your architectural documentation matches the implementation.

What do I need to generate a structural drift report for bounded contexts?

To generate a structural drift report for bounded contexts, you need access to your repository code and workspace DSL files. The audit compares these against documented entities to identify missing entities and relationship mismatches.