C4 Architecture
Schreibt C4 Kontext-/Container-/Komponenten-/Deployment-Diagramme als Mermaid in docs/architecture/
Funktioniert mit Setup
Was es kann
Generiert Softwarearchitektur-Dokumentation als Mermaid C4-Diagramme auf vier Abstraktionsebenen (Context, Container, Component, Deployment) sowie dynamische Anfragefluss-Diagramme und schreibt diese unter einer festen Namenskonvention in docs/architecture/. Es enthält die vollständige Mermaid C4-Element- und Beziehungs-Syntax, eine nach Zielgruppe gegliederte Ebenenauswahl-Tabelle und Regeln wie unidirektionale Pfeile, Aktionsverb-Kantenbeschriftungen, Technologie-Tags an jeder Beziehung und eine Obergrenze von 20 Elementen pro Diagramm. Wird ausgelöst bei Anfragen zur Erstellung eines Architekturdiagramms, C4-Diagramms, Systemkontext-, Container-, Komponenten- oder Deployment-Diagramms oder zur Dokumentation oder Visualisierung der Systemarchitektur.
Testbericht
skills/c4-architecture/SKILL.md (295 Zeilen) wurde über die GitHub tree API gefunden; frontmatter wird mit name+description geparst, und alle drei im Text referenzierten Dateien wurden mit HTTP 200 abgerufen (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), ebenso wie README.md. Reines Markdown, keine Skripte; grep nach curl|wget|base64|eval|api_key|"ignore previous" über SKILL.md und alle Referenzen ergab nichts, und der einzige Pfad, in den es schreibt, ist das relative docs/architecture/. Trigger-Formulierungen bewertet: SOLLTE auslösen — „Zeichne ein C4-Container-Diagramm für die Dienste dieses Repositories“, „Ich muss die Architektur unserer Zahlungsplattform für neue Mitarbeiter dokumentieren“, „Kannst du ein Deployment-Diagramm erstellen, das unser ECS + RDS Setup zeigt“ (alle ja, 3/3 korrekt); SOLLTE NICHT auslösen — „Refaktorisiere OrderService, um die zirkuläre Abhängigkeit zwischen Modulen zu entfernen“ (Codeänderung, kein Diagramm) und „Zeichne ein Sequenzdiagramm in Mermaid für den Checkout-Flow“ (Mermaid, aber keine C4-Ebene; die Beschreibung zählt nur Context/Container/Component/Deployment auf) — beide korrekt abgelehnt, 5/5. Output-Test: Ich habe ein Baseline C4Container-Diagramm für einen URL-Shortener geschrieben, bevor ich den Text geöffnet habe, und es dann unter dem Skill neu erstellt; die Skill-Version fügte das vorgeschriebene Kontextdiagramm als zweite Datei unter der dokumentierten c4-context.md / c4-containers.md-Benennung hinzu, ersetzte 3 generische Kantenbeschriftungen („Uses“, „Calls“, „Reads/Writes“) durch Aktionsverb-Beschriftungen mit einem Technologie-Tag an allen 5 Kanten, aktualisierte Aliase von web/api/db/cache zu aussagekräftigen und fügte UpdateLayoutConfig hinzu — eine echte, aber begrenzte Verbesserung, da die Baseline bereits gültiges renderbares Mermaid war. Die Dokumentation verliert einen Punkt, weil die README behauptet, sie „wählt automatisch die richtige Detailtiefe für Ihr Publikum“, obwohl dies eine Nachschlagetabelle ist, die das Modell konsultiert, keine Automatisierung.
Getestet am: 2026-07-21 · Claude Code 2.x (agent harness)
Installation
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.
Befehle & Beispiel-Prompts
/c4-architectureSchreibt C4 Kontext-/Container-/Komponenten-/Deployment-Diagramme als Mermaid in docs/architecture/
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
Create a C4 context diagram for this systemDocument our architecture with a container diagramGenerate a component diagram for this service