Exportar un diagrama C4 desde tu agente: Mermaid o PlantUML
Un export de arquitectura nunca es completo: la gramática de destino tiene un número finito de huecos y el modelo tiene más. Esta guía indica qué conserva cada uno de los dos formatos C4, qué dejan atrás ambos y por qué OrgGen te lo anuncia en vez de dejar que lo descubras en una revisión de arquitectura.
El texto completo de esta guía existe por ahora solo en francés. El título y el resumen de arriba sí están traducidos.
Deux grammaires, et une seule différence
OrgGen exporte un diagramme d'architecture dans deux grammaires C4 : Mermaid et PlantUML. Le choix n'est pas cosmétique — les deux ne transportent pas la même quantité d'information, et l'écart tient à une seule chose.
| mermaid-c4 | plantuml-c4 | |
|---|---|---|
| Type C4 (personne, système, conteneur…) | oui | oui |
| Technologie | oui | oui |
| Frontière de confiance | oui | oui |
| Description du composant | NON — perdue | oui |
La cause est dans la macro elle-même. En C4-PlantUML, un conteneur s'écrit avec quatre paramètres — identifiant, nom, technologie, description — et le quatrième existe. En Mermaid, l'étiquette d'un nœud combine le nom et la technologie ; il n'y a pas de quatrième logement où poser la description.
Ce qu'aucune des deux ne transporte
Les deux grammaires dépensent leurs trois logements sur le type C4, la technologie et la frontière de confiance. Tout ce que ton modèle porte au-delà reste dans OrgGen — et il faut le savoir avant de traiter le fichier exporté comme la source de vérité.
- Les blocs de contenu : notes, listes, checklists d'actions, liens attachés à un composant.
- Les personnes et leurs rôles — qui est responsable de quel composant.
- L'état d'avancement d'un bloc (en cours, futur, abandonné…).
- Les documents attachés. C'est structurel et non un manque de place : un document vit hors du schéma, aucun sérialiseur de diagramme ne le voit jamais.
- Le rattachement à un autre projet OrgGen — « ce composant est en réalité un projet à part entière » n'est pas une notion que C4 sache exprimer.
- L'étiquette de bloc, faute d'un quatrième logement disponible.
Aucune de ces pertes n'est un défaut à corriger : ce sont des dimensions que la grammaire de destination ne sait pas exprimer. Ce qui serait un défaut, c'est de ne pas le dire.
L'export te dit ce qu'il a laissé derrière
Chaque export d'architecture renvoie, à côté du fichier, la liste de ce qu'il n'a pas pu emporter — avec le nombre d'éléments concernés dans TON projet.
Le format Mermaid C4 (flowchart) ne transporte pas les descriptions de bloc (7 dans ce projet).
Le format Mermaid C4 (flowchart) ne transporte pas les blocs de contenu (12 dans ce projet).
Le format Mermaid C4 (flowchart) ne transporte pas l'état d'avancement des blocs (4 dans ce projet).Le comptage n'est pas décoratif : il porte sur ce que ton projet contient RÉELLEMENT. Une dimension que ton schéma ne porte pas ne produit aucun avertissement — un projet sans document n'est jamais prévenu qu'un document ne passerait pas.
Le faire depuis ton agent
L'export est un outil, disponible aussi bien dans le chat d'OrgGen que depuis ton propre client MCP — Claude Desktop, Cursor, VS Code, ou un agent maison. Le connecteur se branche sur le point d'entrée MCP d'OrgGen ; l'agent découvre alors les outils, dont les formats d'architecture disponibles.
export_arch_diagram({ format: "plantuml-c4" })Le trajet inverse existe aussi : un diagramme d'architecture peut être IMPORTÉ dans un projet OrgGen, ce qui permet de partir d'un fichier déjà écrit plutôt que d'une page blanche. Et parce qu'un agent distant ne devine pas les règles du produit, le serveur MCP lui remet à la connexion les règles qui s'appliquent aux types de diagrammes réellement présents dans le projet connecté.
Pruébalo con tu propio caso
Describe tu situación en una frase — OrgGen construye el diagrama y hace el cálculo.
Pruébalo con tu propio caso