C4 Architecture

Genera diagrammi C4 Context/Container/Component/Deployment come Mermaid in docs/architecture/

di softaworks · softaworks/agent-toolkit

Richiede configurazione ★ 7.6/10

C4 Architecture — Genera diagrammi C4 Context/Container/Component/Deployment come Mermaid in docs/architecture/

Cosa fa

Genera documentazione di architettura software come diagrammi Mermaid C4 a quattro livelli di astrazione (Context, Container, Component, Deployment) più diagrammi di flusso di richiesta dinamici, e li scrive in docs/architecture/ secondo una convenzione di denominazione fissa. Contiene la sintassi completa degli elementi e delle relazioni Mermaid C4, una tabella di selezione del livello in base al pubblico, e regole come frecce unidirezionali, etichette di bordo con verbi d'azione, tag tecnologici su ogni relazione e un limite di 20 elementi per diagramma. Si attiva su richieste di creazione di un diagramma di architettura, diagramma C4, contesto di sistema, diagramma di container, componente o deployment, o per documentare o visualizzare l'architettura di sistema.

Rapporto di test

Localizzato skills/c4-architecture/SKILL.md (295 righe) tramite l'API di GitHub; il frontmatter è parsabile con name+description, e tutti e tre i file referenziati nel corpo sono stati recuperati con HTTP 200 (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), così come README.md. Puro markdown, zero script; la ricerca di curl|wget|base64|eval|api_key|"ignore previous" in SKILL.md e in tutti i riferimenti non ha restituito nulla, e l'unico percorso in cui scrive è il relativo docs/architecture/. Frasi trigger giudicate: DOVREBBE attivarsi — "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" (tutti sì, 3/3 corretti); NON DOVREBBE attivarsi — "Refactor OrderService to remove the circular dependency between modules" (cambio di codice, nessun diagramma) e "Draw a sequence diagram in Mermaid for the checkout flow" (Mermaid ma non un livello C4; la descrizione enumera solo context/container/component/deployment) — entrambi correttamente rifiutati, 5/5. Test di output: ho scritto un diagramma C4Container di base per un URL shortener prima di aprire il corpo, poi l'ho rifatto con la skill; la versione della skill ha aggiunto il diagramma Context obbligatorio come secondo file sotto la denominazione documentata c4-context.md / c4-containers.md, ha sostituito 3 etichette di bordo generiche ("Uses", "Calls", "Reads/Writes") con etichette di verbi d'azione che portano un tag tecnologico su tutti e 5 i bordi, ha aggiornato gli alias da web/api/db/cache a nomi significativi, e ha aggiunto UpdateLayoutConfig — un miglioramento reale ma limitato, dato che la baseline era già un Mermaid valido e renderizzabile. La documentazione perde un punto perché il README afferma che "automatically selects the right level of detail for your audience" quando si tratta di una tabella di ricerca che il modello consulta, non di automazione.

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

Installazione

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.

Comandi e prompt di esempio

/c4-architectureGenera diagrammi C4 Context/Container/Component/Deployment come Mermaid in docs/architecture/

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →