C4 Architecture

Genereert C4 Context/Container/Component/Deployment diagrammen als Mermaid in docs/architecture/

Door softaworks · softaworks/agent-toolkit

Werkt met setup ★ 7.6/10

C4 Architecture — Genereert C4 Context/Container/Component/Deployment diagrammen als Mermaid in docs/architecture/

Wat het doet

Genereert softwarearchitectuurdocumentatie als Mermaid C4-diagrammen op vier abstractieniveaus (Context, Container, Component, Deployment) plus dynamische request-flow diagrammen, en schrijft deze naar docs/architecture/ onder een vaste naamgevingsconventie. Het bevat de volledige Mermaid C4 element- en relatiesyntaxis, een niveau-selectietabel gekoppeld aan het publiek, en regels zoals unidirectionele pijlen, actie-werkwoord randlabels, technologietags op elke relatie, en een limiet van 20 elementen per diagram. Activeert op verzoeken om een architectuurdiagram, C4-diagram, systeemcontext-, container-, component- of deploymentdiagram te maken, of om systeemarchitectuur te documenteren of te visualiseren.

Testrapport

skills/c4-architecture/SKILL.md (295 regels) gevonden via de GitHub tree API; frontmatter parset met name+description, en alle drie in de body genoemde bestanden opgehaald HTTP 200 (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), evenals README.md. Pure markdown, geen scripts; grep naar curl|wget|base64|eval|api_key|"ignore previous" in SKILL.md en alle referenties leverde niets op, en het enige pad waar het naar schrijft is het relatieve docs/architecture/. Triggerzinnen beoordeeld: MOET activeren — "Draw a C4 container diagram for this repo's services", "I need to document the architecture of our payment platform for new hires", "Can you make a deployment diagram showing our ECS + RDS setup" (allemaal ja, 3/3 correct); MOET NIET activeren — "Refactor OrderService to remove the circular dependency between modules" (codewijziging, geen diagram) en "Draw a sequence diagram in Mermaid for the checkout flow" (Mermaid maar geen C4-niveau; de beschrijving somt alleen context/container/component/deployment op) — beide correct geweigerd, 5/5. Outputtest: Ik schreef een baseline C4Container-diagram voor een URL-verkorter voordat ik de body opende, en deed het daarna opnieuw met de skill; de skill-versie voegde het verplichte Context-diagram toe als een tweede bestand onder de gedocumenteerde c4-context.md / c4-containers.md naamgeving, verving 3 generieke randlabels ("Uses", "Calls", "Reads/Writes") door actie-werkwoordlabels met een technologietag op alle 5 randen, upgrade aliassen van web/api/db/cache naar betekenisvolle, en voegde UpdateLayoutConfig toe — een echte maar begrensde verbetering, aangezien de baseline al geldige renderbare Mermaid was. Docs verliezen een punt omdat de README beweert dat het "automatically selects the right level of detail for your audience" terwijl dat een opzoektabel is die het model raadpleegt, geen automatisering.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/softaworks/agent-toolkit.git /tmp/c4-architecture-src
mkdir -p ~/.claude/skills
cp -R /tmp/c4-architecture-src/skills/c4-architecture ~/.claude/skills/c4-architecture
# Claude Code plugin instead: /plugin marketplace add softaworks/agent-toolkit
# then /plugin install c4-architecture@agent-toolkit
# Pure markdown, no scripts or extra dependencies.

Commando's en voorbeeldprompts

/c4-architectureGenereert C4 Context/Container/Component/Deployment diagrammen als Mermaid in docs/architecture/

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

Create a C4 context diagram for this system
Document our architecture with a container diagram
Generate a component diagram for this service

Volledig rapport (Engels) →