Ein C4-Diagramm aus deinem Agenten exportieren: Mermaid oder PlantUML
Ein Architektur-Export ist nie vollständig: Die Zielgrammatik hat endlich viele Plätze, das Modell hat mehr. Dieser Leitfaden zeigt, welches der beiden C4-Formate was behält, was beide zurücklassen — und warum OrgGen es dir ansagt, statt es dich im Architektur-Review entdecken zu lassen.
Der vollständige Text dieses Leitfadens liegt derzeit nur auf Französisch vor. Titel und Zusammenfassung oben sind übersetzt.
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é.
Probiere es an deinem eigenen Fall
Beschreibe deine Situation in einem Satz — OrgGen baut das Diagramm und rechnet.
Probiere es an deinem eigenen Fall