
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.
C4 Architecture Model skill for Paivot's machinery workflow. Pure documentation — no scripts, no executable code. Defines role map and ceremonies for maintaining Structurizr DSL workspace and architecture contracts. Well-structured but heavily coupled to Paivot's proprietary toolchain (pvg, machinery binary), making it inaccessible outside that ecosystem.
No scripts to audit. Skill is a documentation/reference artifact for a specific platform workflow. Clean from a security perspective — no commands, no network calls, no credentials. Quality is decent but assumes deep Paivot context that isn't self-contained.