C4 Architecture

Skriver C4 Context/Container/Component/Deployment-diagram som Mermaid till docs/architecture/

av softaworks · softaworks/agent-toolkit

Fungerar med konfiguration ★ 7.6/10

C4 Architecture — Skriver C4 Context/Container/Component/Deployment-diagram som Mermaid till docs/architecture/

Vad den gör

Genererar programvaruarkitekturdokumentation som Mermaid C4-diagram på fyra abstraktionsnivåer (Context, Container, Component, Deployment) plus dynamiska request-flow-diagram, och skriver dem till docs/architecture/ under en fast namngivningskonvention. Den innehåller den fullständiga Mermaid C4-element- och relationssyntaxen, en nivåvalstabell kopplad till målgruppen, och regler som enkelriktade pilar, action-verb edge labels, tekniktaggar på varje relation, och ett tak på 20 element per diagram. Utlöses vid förfrågningar om att skapa ett arkitekturdiagram, C4-diagram, systemkontext, container-, komponent- eller deployment-diagram, eller för att dokumentera eller visualisera systemarkitektur.

Testrapport

Hittade skills/c4-architecture/SKILL.md (295 rader) via GitHub tree API; frontmatter parsas med name+description, och alla tre kroppsrefererade filer hämtades HTTP 200 (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), liksom README.md. Ren markdown, noll skript; grep efter curl|wget|base64|eval|api_key|"ignore previous" över SKILL.md och alla referenser returnerade ingenting, och den enda sökvägen den skriver till är den relativa docs/architecture/. Trigger-fraseringar bedömdes: SKA utlösas — "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" (alla ja, 3/3 korrekta); SKA INTE utlösas — "Refactor OrderService to remove the circular dependency between modules" (kodändring, inget diagram) och "Draw a sequence diagram in Mermaid for the checkout flow" (Mermaid men inte en C4-nivå; beskrivningen räknar endast upp context/container/component/deployment) — båda korrekt avvisade, 5/5. Output-test: Jag skrev ett baslinje C4Container-diagram för en URL-förkortare innan jag öppnade brödtexten, sedan gjorde jag om det med skickligheten; skicklighetsversionen lade till det obligatoriska Context-diagrammet som en andra fil under den dokumenterade c4-context.md / c4-containers.md-namngivningen, ersatte 3 generiska edge labels ("Uses", "Calls", "Reads/Writes") med action-verb labels som bar en tekniktagg på alla 5 kanter, uppgraderade alias från web/api/db/cache till meningsfulla, och lade till UpdateLayoutConfig — verklig men begränsad förbättring, eftersom baslinjen redan var ett giltigt renderbart Mermaid. Dokumentationen förlorar en poäng för att README hävdar att den "automatically selects the right level of detail for your audience" när det är en uppslagstabell som modellen konsulterar, inte automatisering.

Testad: 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.

Kommandon och exempelprompter

/c4-architectureSkriver C4 Context/Container/Component/Deployment-diagram som Mermaid till docs/architecture/

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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

Läs hela rapporten →