Sortir un diagramme C4 depuis ton agent : Mermaid ou PlantUML

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.

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é.