C4 Architecture

Skriver C4 kontekst-/container-/komponent-/utplasseringsdiagrammer som Mermaid til docs/architecture/

av softaworks · softaworks/agent-toolkit

Krever oppsett ★ 7.6/10

C4 Architecture — Skriver C4 kontekst-/container-/komponent-/utplasseringsdiagrammer som Mermaid til docs/architecture/

Hva den gjør

Genererer programvarearkitekturdokumentasjon som Mermaid C4-diagrammer på fire abstraksjonsnivåer (Context, Container, Component, Deployment) pluss dynamiske forespørselsflytdiagrammer, og skriver dem til docs/architecture/ under en fast navnekonvensjon. Den inneholder full Mermaid C4-element- og relasjonssyntaks, en nivåvalgstabell nøklet til publikum, og regler som enveis piler, handlingsverb-kantetiketter, teknologimerker på hver relasjon, og et tak på 20 elementer per diagram. Utløses ved forespørsler om å lage et arkitekturdiagram, C4-diagram, systemkontekst, container-, komponent- eller utplasseringsdiagram, eller for å dokumentere eller visualisere systemarkitektur.

Testrapport

Fant skills/c4-architecture/SKILL.md (295 linjer) via GitHub tree API; frontmatter parses med name+description, og alle tre kroppsrefererte filer hentet HTTP 200 (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), det samme gjorde README.md. Ren markdown, null skript; grep etter curl|wget|base64|eval|api_key|"ignore previous" på tvers av SKILL.md og alle referanser returnerte ingenting, og den eneste stien den skriver til er den relative docs/architecture/. Triggerfraser vurdert: BØR utlø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 korrekte); BØR IKKE utløses — "Refactor OrderService to remove the circular dependency between modules" (kodeendring, ingen diagram) og "Draw a sequence diagram in Mermaid for the checkout flow" (Mermaid, men ikke et C4-nivå; beskrivelsen nevner kun context/container/component/deployment) — begge korrekt avvist, 5/5. Utgangstest: Jeg skrev et grunnlinje C4Container-diagram for en URL-forkorter før jeg åpnet kroppen, og gjorde det deretter om under ferdigheten; ferdighetsversjonen la til det pålagte Context-diagrammet som en andre fil under den dokumenterte c4-context.md / c4-containers.md-navngivningen, erstattet 3 generiske kantetiketter ("Uses", "Calls", "Reads/Writes") med handlingsverb-etiketter som bar en teknologimerke på alle 5 kantene, oppgraderte aliaser fra web/api/db/cache til meningsfulle, og la til UpdateLayoutConfig — reell, men begrenset forbedring, siden grunnlinjen allerede var gyldig renderbar Mermaid. Dokumentasjonen mister et poeng for at README hevder den "automatically selects the right level of detail for your audience" når det er en oppslagstabell modellen konsulterer, ikke automatisering.

Testet på: 2026-07-21 · Claude Code 2.x (agent harness)

Installer

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 kontekst-/container-/komponent-/utplasseringsdiagrammer som Mermaid til docs/architecture/

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

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

Full rapport →