C4 Architecture

Zapisuje C4 Context/Container/Component/Deployment diagramy jako Mermaid do docs/architecture/

od softaworks · softaworks/agent-toolkit

Funguje s nastavením ★ 7.6/10

C4 Architecture — Zapisuje C4 Context/Container/Component/Deployment diagramy jako Mermaid do docs/architecture/

Co umí

Generuje dokumentaci softwarové architektury jako Mermaid C4 diagramy na čtyřech úrovních abstrakce (Context, Container, Component, Deployment) plus dynamické diagramy toku požadavků a zapisuje je do docs/architecture/ pod pevnou konvencí pojmenování. Obsahuje kompletní syntaxi Mermaid C4 prvků a vztahů, tabulku výběru úrovní klíčovanou podle publika a pravidla jako jednosměrné šipky, akční slovesné popisky hran, technologické tagy na každém vztahu a limit 20 prvků na diagram. Spouští se na požadavky na vytvoření architektonického diagramu, C4 diagramu, systémového kontextu, kontejneru, komponenty nebo diagramu nasazení, nebo na dokumentaci či vizualizaci systémové architektury.

Testovací report

Nalezeno skills/c4-architecture/SKILL.md (295 řádků) přes GitHub tree API; frontmatter se parsuje s name+description a všechny tři soubory odkazované v těle byly načteny HTTP 200 (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), stejně jako README.md. Čistý markdown, žádné skripty; grep pro curl|wget|base64|eval|api_key|"ignore previous" napříč SKILL.md a všemi referencemi nevrátil nic a jediná cesta, kam zapisuje, je relativní docs/architecture/. Spouštěcí fráze posouzeny: MĚLO by se spustit — "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" (vše ano, 3/3 správně); NEMĚLO by se spustit — "Refactor OrderService to remove the circular dependency between modules" (změna kódu, žádný diagram) a "Draw a sequence diagram in Mermaid for the checkout flow" (Mermaid, ale ne úroveň C4; popis uvádí pouze context/container/component/deployment) — obě správně odmítnuty, 5/5. Test výstupu: Napsal jsem základní C4Container diagram pro zkracovač URL před otevřením těla, pak jsem ho předělal pod dovedností; verze dovednosti přidala povinný Context diagram jako druhý soubor pod dokumentovaným pojmenováním c4-context.md / c4-containers.md, nahradila 3 generické popisky hran ("Uses", "Calls", "Reads/Writes") akčními slovesnými popisky s technologickým tagem na všech 5 hranách, upgradovala aliasy z web/api/db/cache na smysluplné a přidala UpdateLayoutConfig — skutečné, ale omezené zlepšení, protože základ byl již platný renderovatelný Mermaid. Dokumentace ztrácí bod za tvrzení v README, že "automatically selects the right level of detail for your audience", když se jedná o vyhledávací tabulku, kterou model konzultuje, nikoli o automatizaci.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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.

Příkazy a ukázkové prompty

/c4-architectureZapisuje C4 Context/Container/Component/Deployment diagramy jako Mermaid do docs/architecture/

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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

Kompletní testovací report (anglicky) →