C4 Architecture
Écrit des diagrammes C4 Contexte/Conteneur/Composant/Déploiement au format Mermaid dans docs/architecture/
Fonctionne avec configuration
Ce que fait
Génère de la documentation d'architecture logicielle sous forme de diagrammes Mermaid C4 à quatre niveaux d'abstraction (Contexte, Conteneur, Composant, Déploiement) ainsi que des diagrammes de flux de requêtes dynamiques, et les écrit dans docs/architecture/ selon une convention de nommage fixe. Il contient la syntaxe complète des éléments et relations Mermaid C4, un tableau de sélection de niveau indexé par public, et des règles telles que les flèches unidirectionnelles, les étiquettes d'arêtes verbes d'action, les balises technologiques sur chaque relation et un plafond de 20 éléments par diagramme. Se déclenche sur les demandes de création d'un diagramme d'architecture, d'un diagramme C4, d'un diagramme de contexte système, de conteneur, de composant ou de déploiement, ou pour documenter ou visualiser l'architecture système.
Rapport de test
SKILL.md (295 lignes) localisé via l'API GitHub tree ; le frontmatter est parsé avec name+description, et les trois fichiers référencés dans le corps sont récupérés HTTP 200 (references/c4-syntax.md 14564 B, common-mistakes.md 12441 B, advanced-patterns.md 18346 B), ainsi que README.md. Markdown pur, zéro scripts ; grep pour curl|wget|base64|eval|api_key|"ignore previous" sur SKILL.md et toutes les références n'a rien retourné, et le seul chemin d'écriture est le relatif docs/architecture/. Phrases de déclenchement jugées : DEVRAIT se déclencher — "Dessine un diagramme de conteneur C4 pour les services de ce dépôt", "J'ai besoin de documenter l'architecture de notre plateforme de paiement pour les nouvelles recrues", "Peux-tu faire un diagramme de déploiement montrant notre configuration ECS + RDS" (tous oui, 3/3 corrects) ; NE DEVRAIT PAS se déclencher — "Refactoriser OrderService pour supprimer la dépendance circulaire entre les modules" (changement de code, pas de diagramme) et "Dessine un diagramme de séquence en Mermaid pour le flux de paiement" (Mermaid mais pas un niveau C4 ; la description n'énumère que contexte/conteneur/composant/déploiement) — tous deux correctement refusés, 5/5. Test de sortie : j'ai écrit un diagramme C4Container de base pour un raccourcisseur d'URL avant d'ouvrir le corps, puis je l'ai refait avec la compétence ; la version de la compétence a ajouté le diagramme de Contexte obligatoire comme deuxième fichier sous la dénomination documentée c4-context.md / c4-containers.md, a remplacé 3 étiquettes d'arêtes génériques ("Uses", "Calls", "Reads/Writes") par des étiquettes verbes d'action portant une balise technologique sur les 5 arêtes, a mis à niveau les alias de web/api/db/cache vers des alias significatifs, et a ajouté UpdateLayoutConfig — une amélioration réelle mais limitée, car la base de référence était déjà un Mermaid valide et rendu. La documentation perd un point car le README prétend qu'elle "sélectionne automatiquement le bon niveau de détail pour votre public" alors qu'il s'agit d'un tableau de correspondance que le modèle consulte, pas d'une automatisation.
Testé le: 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.
Commandes et exemples de prompts
/c4-architectureÉcrit des diagrammes C4 Contexte/Conteneur/Composant/Déploiement au format Mermaid dans docs/architecture/
Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :
Create a C4 context diagram for this systemDocument our architecture with a container diagramGenerate a component diagram for this service