from paivot-graph9
Maintain a machine-checkable C4 architecture model (Structurizr DSL) alongside ARCHITECTURE.md to enforce boundaries, generate diagrams, and ensure architecture
This skill teaches agents to maintain a canonical C4 architecture model (workspace.dsl) alongside a narrative ARCHITECTURE.md and a machine-checkable Architecture Contract. It provides guidance and examples for writing Structurizr DSL, generating diagrams (Mermaid/PlantUML), and encoding dependency rules so agents can verify boundaries, detect illegal imports, and keep diagrams in sync with code changes.
Use this skill when a project opts into architecture.c4 or when an agent is asked to produce or validate system/context/container/component diagrams, enforce architecture boundaries, or update an Architecture Contract. It applies during design, code review, and release tasks where architecture drift or cross-boundary dependencies are a concern.
workspace.dsl, embedding an Architecture Contract YAML block in ARCHITECTURE.md, exporting diagrams via Structurizr CLI or Mermaid fallback, and adding checks to review flows. The skill includes a minimal Structurizr DSL example, view and style snippets, and recommended contract rules.Best used by agents with code-reading and file-editing capabilities (eg. Claude Code-style agents, Copilot/Codex-flavored agents, or other agent runners that can edit repo files and run CLI tools). Agents that can run Structurizr CLI or generate Mermaid are particularly suited to diagram export steps.
This skill has not been reviewed by our automated audit pipeline yet.
