Modèle d'Architecture C4

Ce que cela fait

Cette compétence apprend aux agents à maintenir un modèle d'architecture C4 canonique (workspace.dsl) parallèlement à un document narratif ARCHITECTURE.md et un Contrat d'Architecture vérifiable par machine. Elle fournit des conseils et des exemples pour l'écriture du Structurizr DSL, la génération de diagrammes (Mermaid/PlantUML) et l'encodage de règles de dépendance afin que les agents puissent vérifier les limites, détecter les imports illégaux et maintenir les diagrammes synchronisés avec les modifications du code.

Quand l'utiliser

Utilisez cette compétence lorsqu'un projet adopte architecture.c4 ou lorsqu'un agent est sollicité pour produire ou valider des diagrammes de système, de contexte, de conteneur ou de composant, imposer des limites d'architecture ou mettre à jour un Contrat d'Architecture. Elle s'applique lors des tâches de conception, de revue de code et de déploiement où la dérive architecturale ou les dépendances trans-frontières sont préoccupantes.

Ce qui est inclus

• Scripts : aucun script déclaré dans l'instantané du dépôt (has_scripts=false)
• Références : aucune référence groupée (has_references=false)
• Instructions : conseils procéduraux clairs pour maintenir workspace.dsl, intégrer un bloc YAML de Contrat d'Architecture dans ARCHITECTURE.md, exporter des diagrammes via Structurizr CLI ou Mermaid, et ajouter des vérifications aux flux de revue. La compétence inclut un exemple minimal de Structurizr DSL, des extraits de vue et de style, ainsi que des règles de contrat recommandées.

Agents compatibles

Idéalement utilisé par des agents disposant de capacités de lecture de code et d'édition de fichiers (ex. agents de style Claude Code, agents flavor Copilot/Codex, ou tout autre exécuteur d'agent capable de modifier des fichiers de dépôt et d'exécuter des outils CLI). Les agents pouvant exécuter Structurizr CLI ou générer du Mermaid sont particulièrement adaptés aux étapes d'exportation de diagrammes.