C4 Architecture
Skriver C4 Context/Container/Component/Deployment-diagrammer som Mermaid til docs/architecture/
Virker med opsætning
Hvad det gør
Genererer softwarearkitekturdokumentation som Mermaid C4-diagrammer på fire abstraktionsniveauer (Context, Container, Component, Deployment) plus dynamiske anmodningsflow-diagrammer og skriver dem til docs/architecture/ under en fast navnekonvention. Den indeholder den fulde Mermaid C4-element- og relationssyntaks, en niveauselektionstabel nøglet til publikum og regler som ensrettede pile, handlingsverbum-kantetiketter, teknologitags på hver relation og et loft på 20 elementer pr. diagram. Udløses ved anmodninger om at oprette et arkitekturdiagram, C4-diagram, systemkontekst, container-, komponent- eller deployment-diagram eller til at dokumentere eller visualisere systemarkitektur.
Testrapport
Fandt skills/c4-architecture/SKILL.md (295 linjer) via GitHub tree API; frontmatter parses med name+description, og alle tre kropsrefererede filer blev hentet HTTP 200 (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), ligesom README.md. Ren markdown, nul scripts; grep efter curl|wget|base64|eval|api_key|"ignore previous" på tværs af SKILL.md og alle referencer returnerede intet, og den eneste sti, den skriver til, er den relative docs/architecture/. Trigger-fraseringer bedømt: SKAL udløses — "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" (alle ja, 3/3 korrekt); SKAL IKKE udløses — "Refactor OrderService to remove the circular dependency between modules" (kodeændring, intet diagram) og "Draw a sequence diagram in Mermaid for the checkout flow" (Mermaid, men ikke et C4-niveau; beskrivelsen opregner kun context/container/component/deployment) — begge korrekt afvist, 5/5. Output-test: Jeg skrev et baseline C4Container-diagram for en URL-forkorter, før jeg åbnede kroppen, og gentog det derefter under skill'en; skill-versionen tilføjede det påkrævede Context-diagram som en anden fil under den dokumenterede c4-context.md / c4-containers.md navngivning, erstattede 3 generiske kantetiketter ("Uses", "Calls", "Reads/Writes") med handlingsverbum-etiketter, der bærer et teknologitag på alle 5 kanter, opgraderede aliaser fra web/api/db/cache til meningsfulde, og tilføjede UpdateLayoutConfig — reel, men begrænset forbedring, da baseline allerede var gyldig renderbar Mermaid. Dokumentation mister et point, fordi README hævder, at den "automatically selects the right level of detail for your audience", når det er en opslagstabel, som modellen konsulterer, ikke automatisering.
Testet: 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.
Kommandoer og eksempelprompter
/c4-architectureSkriver C4 Context/Container/Component/Deployment-diagrammer som Mermaid til docs/architecture/
Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):
Create a C4 context diagram for this systemDocument our architecture with a container diagramGenerate a component diagram for this service