
de paivot-graph9
Maintenir un modèle d'architecture C4 vérifiable par machine (Structurizr DSL) parallèlement à ARCHITECTURE.md pour imposer des limites, générer des diagrammes et garantir la cohérence de l'architecture
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.
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.
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.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.
Compétence sur le modèle d'architecture C4 pour le flux de travail de la machinerie de Paivot. Documentation pure — pas de scripts, pas de code exécutable. Définit la carte des rôles et les cérémonies pour maintenir l'espace de travail Structurizr DSL et les contrats d'architecture. Bien structuré mais fortement couplé à la chaîne d'outils propriétaire de Paivot (pvg, binaire machinery), ce qui le rend inaccessible en dehors de cet écosystème.
Aucun script à auditer. La compétence est un artefact de documentation/référence pour un flux de travail de plateforme spécifique. Sûr d'un point de vue sécurité — pas de commandes, pas d'appels réseau, pas d'identifiants. La qualité est correcte mais suppose un contexte Paivot approfondi qui n'est pas autonome.