C4 Architecture

Tworzy diagramy C4 Context/Container/Component/Deployment w formacie Mermaid do docs/architecture/

Autor: softaworks · softaworks/agent-toolkit

Działa po konfiguracji ★ 7.6/10

C4 Architecture — Tworzy diagramy C4 Context/Container/Component/Deployment w formacie Mermaid do docs/architecture/

Co robi ten skill

Generuje dokumentację architektury oprogramowania jako diagramy Mermaid C4 na czterech poziomach abstrakcji (Context, Container, Component, Deployment) plus dynamiczne diagramy przepływu żądań, i zapisuje je do docs/architecture/ zgodnie z ustaloną konwencją nazewnictwa. Zawiera pełną składnię elementów i relacji Mermaid C4, tabelę wyboru poziomu dostosowaną do odbiorcy, oraz zasady takie jak jednokierunkowe strzałki, etykiety krawędzi z czasownikami akcji, tagi technologiczne dla każdej relacji i limit 20 elementów na diagram. Uruchamia się na żądania utworzenia diagramu architektury, diagramu C4, kontekstu systemu, diagramu kontenera, komponentu lub wdrożenia, lub w celu udokumentowania lub wizualizacji architektury systemu.

Raport z testu

Zlokalizowano skills/c4-architecture/SKILL.md (295 linii) za pośrednictwem GitHub tree API; frontmatter parsowany z name+description, i wszystkie trzy pliki referencyjne pobrane HTTP 200 (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), podobnie jak README.md. Czysty markdown, zero skryptów; grep dla curl|wget|base64|eval|api_key|"ignore previous" w SKILL.md i wszystkich referencjach nie zwrócił nic, a jedyna ścieżka, do której zapisuje, to względna docs/architecture/. Frazy wyzwalające ocenione: POWINIEN zadziałać — "Narysuj diagram kontenerów C4 dla usług tego repozytorium", "Muszę udokumentować architekturę naszej platformy płatniczej dla nowych pracowników", "Czy możesz stworzyć diagram wdrożenia pokazujący naszą konfigurację ECS + RDS" (wszystkie tak, 3/3 poprawne); NIE POWINIEN zadziałać — "Zrefaktoryzuj OrderService, aby usunąć cykliczną zależność między modułami" (zmiana kodu, brak diagramu) i "Narysuj diagram sekwencji w Mermaid dla przepływu realizacji zamówienia" (Mermaid, ale nie poziom C4; opis wymienia tylko context/container/component/deployment) — oba poprawnie odrzucone, 5/5. Test wyjścia: napisałem bazowy diagram C4Container dla skracacza URL przed otwarciem treści, a następnie przerobiłem go za pomocą umiejętności; wersja umiejętności dodała wymagany diagram Context jako drugi plik zgodnie z udokumentowanym nazewnictwem c4-context.md / c4-containers.md, zastąpiła 3 ogólne etykiety krawędzi ("Uses", "Calls", "Reads/Writes") etykietami z czasownikami akcji zawierającymi tag technologiczny na wszystkich 5 krawędziach, ulepszyła aliasy z web/api/db/cache na bardziej znaczące i dodała UpdateLayoutConfig — rzeczywista, ale ograniczona poprawa, ponieważ bazowa wersja była już poprawnym, renderowalnym Mermaid. Dokumentacja traci punkt za twierdzenie w README, że "automatycznie wybiera odpowiedni poziom szczegółowości dla Twojej publiczności", podczas gdy jest to tabela wyszukiwania, którą model konsultuje, a nie automatyzacja.

Testowano: 2026-07-21 · Claude Code 2.x (agent harness)

Instalacja

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.

Komendy i przykładowe prompty

/c4-architectureTworzy diagramy C4 Context/Container/Component/Deployment w formacie Mermaid do docs/architecture/

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →