FlowBoardMermaid slop : comment réviser et corriger les diagrammes générés par l'IA avant de les publier
Équipe de FlowBoardRédigé avec l'aide de l'IA17 min de lectureEn résumé :
- "Mermaid slop" est le nom qui s'est popularisé en 2026 pour les diagrammes générés par IA qui sont valides en syntaxe mais illisibles ou directement faux ; le terme est issu du projet Diagram Design, qui se présentait avec le slogan "pas de Figma, pas de boîtes arrondies génériques, pas de Mermaid-slop" et qui avait déjà dépassé les 11 000 étoiles sur GitHub en août 2026 (explainX, 16-08-2026).
- Le problème a grandi avec la distribution : VS Code 1.121 (20-05-2026) rend Mermaid de manière native dans l'aperçu Markdown, sans extension, et les assistants le génèrent par défaut (Visual Studio Code).
- Un modèle optimise validité grammaticale, pas correction du système : le
.mmdparse, mais duplique des nœuds, laisse la branche "non" d'une décision ou inverse la direction des données. - Réviser un diagramme en lisant des lignes de
-->ne fonctionne pas : les défauts qui importent sont topologiques et ne se voient que dessinés. - Le cycle qui fonctionne : importer le
.mmdsur une toile, réorganiser par couches, annoter ce qui est douteux avec un lien vers le code ou le ticket qui le prouve, corriger manuellement et réexporter pour que la version corrigée soit celle qui entre dans le dépôt.
Depuis le milieu de 2026, la question dans les équipes d'ingénierie n'est plus comment générer un diagramme, mais qui en est responsable. Les agents écrivent Mermaid à la volée, GitHub et VS Code le peignent sans configuration et le résultat entre dans le README avec la même naturalité qu'un bloc de code. Ce qui manque, c'est la couche d'audit. Cet article parcourt les défauts typiques, la raison technique pour laquelle ils apparaissent et un cycle de révision reproductible qui se clôt sur une toile visuelle —dans notre cas, FlowBoard, la toile infinie pour diagrammes de AIsToHire, qui importe et réexporte Mermaid— pour que le diagramme publié soit le corrigé et non le premier que le modèle a craché.

Qu'est-ce que le "Mermaid slop" ?
Le Mermaid slop est un diagramme généré par IA qui compile sans erreurs et pourtant ne sert à rien : des boîtes arrondies identiques pour des concepts différents, des flèches sans étiquette ou avec des étiquettes vagues, des couleurs par défaut qui ne disent rien et une génération réflexive —on dessine parce qu'on l'a demandé, pas parce que c'est nécessaire—. La définition est fixée par le récapitulatif de explainX sur le terme (16-08-2026), qui le retrace jusqu'au projet Diagram Design de Cathryn Lavery.
Le point important est qu'il y a deux couches de "slop" qui sont souvent confondues :
| Couche | Ce qui échoue | Se détecte | Coût de la réparation |
|---|---|---|---|
| Esthétique | Formes génériques, palette par défaut, tout identique | À première vue | Faible : thème, formes, regroupement |
| Sémantique | Le diagramme décrit un système qui n'existe pas | Seulement en comparant avec le code réel | Élevé : il faut rouvrir le dépôt |
La conversation publique de 2026 s'est presque entièrement concentrée sur la première. Les outils qui ont émergé —des skills de diagrammation éditoriale aux générateurs qui produisent des éléments natifs d'Excalidraw au lieu de texte Mermaid— attaquent surtout cet aspect. La seconde couche, celle qui fait qu'un diagramme ment sur votre architecture, reste du travail humain.
Pourquoi un LLM produit-il du Mermaid parfait en syntaxe et pauvre en sémantique ?
Parce que ce sont deux objectifs distincts et qu'un seul a un signal d'entraînement abondant. La grammaire de Mermaid est fermée, petite et massivement représentée sur GitHub : un modèle la reproduit presque sans échec. La correction du diagramme, en revanche, dépend d'un système concret que le modèle n'a généralement pas lu en entier, donc il remplit les lacunes avec la forme la plus fréquente d'un diagramme d'architecture, pas avec la vôtre.
À cela s'ajoutent trois effets pratiques :
- Le prompt est la seule source. Si vous décrivez le système en trois phrases, l'agent renvoie un diagramme avec la granularité de trois phrases et l'orne jusqu'à ce qu'il semble complet. Comme le résume Mermaid elle-même en parlant de vibe diagramming, "un diagramme généré à partir d'un prompt vague reflétera la vagueness du prompt" (Mermaid, 24-03-2026).
- Il n'y a pas de compilateur sémantique. Un test rouge vous avertit ; un diagramme incorrect se rend aussi beau qu'un diagramme correct. Il n'existe pas d'équivalent de
tscpour "ce service n'existe pas". - La mise en page est décidée par le moteur, pas par l'auteur. Mermaid place les nœuds avec son algorithme et ne vous offre pas un moyen pratique de corriger la disposition après le rendu. Si la hiérarchie réelle ne correspond pas à ce que l'auto-layout dessine, vous perdez la discussion avec l'outil.
Et le contexte du secteur dit que la vérification n'est pas optionnelle. La sondage auprès des développeurs 2026 de Stack Overflow (publiée le 06-10-2026, plus de 30 000 réponses dans 169 pays) a révélé qu'environ la moitié fait confiance à la sortie de l'IA uniquement lorsqu'elle peut la vérifier facilement, et qu'à peine 6,6 % la considérerait comme bonne pour des décisions importantes. Un diagramme d'architecture dans la documentation officielle est, presque par définition, une décision importante.
Les sept défauts récurrents d'un diagramme généré par IA
Voici les sept qui apparaissent encore et encore lors de l'audit des fichiers .mmd générés par des agents. Tous analysent ; tous sont erronés. Le schéma commun est que le modèle remplit une structure plausible là où il manque des informations du domaine.

| # | Défaut | Symptôme dans le .mmd | Conséquence |
|---|---|---|---|
| 1 | Nœuds dupliqués | Deux IDs distincts avec des étiquettes similaires pour le même service | Il semble qu'il y ait deux composants alors qu'il n'y en a qu'un |
| 2 | Décision sans branche "non" | Un losange avec une seule arête de sortie | Le chemin d'erreur reste non documenté |
| 3 | Flux sans terminator | Chaînes se terminant par un nœud de processus | On ne sait pas quand se termine le cas d'utilisation |
| 4 | Direction inversée | La flèche pointe vers l'origine des données | On inverse qui appelle qui |
| 5 | Boîte générique | Un seul nœud "Base de données" | Cache trois entrepôts avec des garanties différentes |
| 6 | Profondeur fausse | Couches ou subgraph qui n'existent pas dans le code | Donne autorité à une architecture inventée |
| 7 | Étiquettes du prompt | Les nœuds répètent vos mots, pas le vocabulaire du domaine | Le diagramme n'est ni recherchable ni reconnaissable |
1. Nœuds dupliqués qui sont le même service
Le modèle a vu "auth" et "service d'authentification" dans deux phrases distinctes et a créé deux nœuds.
flowchart LR
API[API Gateway] --> AUTH[Auth]
API --> AUTHSVC[Service d'authentification]
AUTH --> DB[(Base de données)]
AUTHSVC --> DB
Corrigé : un nœud, un ID, le nom utilisé par l'équipe.
flowchart LR
API[API Gateway] --> AUTH[auth-service]
AUTH --> USERS[(postgres: users)]
2. Décisions sans branche "non"
flowchart TD
REQ[Demande] --> Q{Token valide ?}
Q -->|Oui| OK[Traiter]
Un losange avec une seule sortie n'est pas une décision : c'est un ornement. Toute condition a besoin de ses deux chemins et le chemin d'erreur a besoin d'une destination.
flowchart TD
REQ[Demande] --> Q{Token valide ?}
Q -->|oui| OK[Traiter]
Q -->|non| R401[Répondre 401]
OK --> FIN([Fin])
R401 --> FIN
3. Flèches qui inversent la direction des données
Classique avec des files d'attente et des webhooks : le modèle dessine la hiérarchie organisationnelle au lieu du flux réel.
flowchart LR
WORKER[Travailleur] --> QUEUE[File d'attente de travaux]
Le travailleur ne pousse pas vers la file : il consomme de celle-ci. Mal dessiner ce sens transforme un design pull en un design push, qui est un autre système avec d'autres garanties.
flowchart LR
API[API] -->|met dans la file| QUEUE[File d'attente de travaux]
QUEUE -->|consomme| WORKER[Travailleur]
4. La boîte générique "Base de données"
C'est le défaut le plus coûteux, car il fait disparaître exactement l'information pour laquelle quelqu'un ouvre le diagramme. Un nœud [(Base de données)] qui en réalité est Postgres pour les transactions, Redis pour les sessions et S3 pour les pièces jointes ne documente pas : il cache. La règle pratique : si deux entrepôts ont des garanties de durabilité différentes, ce sont deux nœuds.
5, 6 et 7 : couches inventées et étiquettes empruntées
Les subgraph appelés "Couche de présentation", "Couche métier" et "Couche de données" sont souvent des modèles mentaux du modèle, pas la structure de votre dépôt. Tout comme les étiquettes : si le nœud s'appelle "module de traitement des paiements" et dans le code c'est billing-worker, personne ne pourra croiser le diagramme avec le projet. Et s'il manque le terminator, le lecteur ne sait pas si le flux s'arrête là ou si le modèle est resté inachevé.
Pourquoi réviser un diagramme en texte ne fonctionne pas ?
Parce que les défauts qui importent sont topologiques et le texte ne les expose pas. En lisant une liste de lignes A --> B, vous pouvez vérifier que chaque arête est plausible une par une, mais vous ne verrez pas que deux flèches se croisent, qu'un nœud est devenu orphelin, que la hiérarchie est inversée ou qu'il y a un cycle de trois sauts. Ces propriétés ne sont visibles que lorsque le graphe est dessiné et placé.

Il y a une deuxième raison, plus subtile : en lisant le fichier .mmd, vous examinez ce que l'auteur a écrit ; en regardant le rendu, vous examinez ce que le lecteur va comprendre. Ce sont des choses différentes. Un diagramme avec quinze arêtes correctes et un auto-layout qui les entasse est techniquement correct et communicativement brisé, et c'est précisément ce qu'un relecteur de pull request approuve sans regarder parce que "le bloc mermaid est bien formé".
L'industrie elle-même s'est déplacée dans cette direction. Anthropic a lancé Claude Whiteboards en bêta le 10-11-2026 : une toile en temps réel où l'assistant transforme une discussion en un tableau, regroupe des notes par sujet et permet de l'emmener ensuite vers Lucid, Miro ou Vani de Zoho (unite.ai). Et Miro, lors de son événement Canvas 26, a déclaré qu'il n'est déjà "plus dans le secteur des tableaux blancs" et qu'il veut être "la couche de prise de décision collaborative pour l'entreprise agéntique" (Forrester, 01-06-2026). La sortie naturelle de l'IA devient la toile, pas le bloc de texte. Pour ceux qui audite des diagrammes, c'est une bonne nouvelle : la révision appartient à l'endroit où l'on voit la forme.
Le cycle de révision : du .mmd au canevas et retour au .mmd
Le cycle comporte cinq étapes et sa propriété clé est qu'il se ferme : ce qui entre dans le dépôt est le diagramme corrigé sur le canevas, pas l'original de l'agent. Si la correction reste dans une capture d'écran ou dans un commentaire de la demande de tirage, le .mmd erroné survit et alimente à nouveau le prochain agent.

- Importer. Collez le
.mmdque l'agent vous a donné sur un canevas visuel, ou chargez-le en tant que fichier. Objectif : séparer la révision de l'éditeur de code, où la tentation est de lire plutôt que de regarder. - Répartir et réorganiser. Placez les nœuds en couches horizontales par responsabilité (entrée, orchestration, domaine, stockage). Presque tous les défauts de direction et de profondeur fausse se révèlent ici : une flèche qui monte de deux couches est généralement une flèche inversée.
- Marquer ce qui est douteux. Chaque nœud ou connecteur que vous ne pouvez pas confirmer en lisant le code est annoté, et l'annotation comporte un lien vers la preuve : le fichier, le ticket, l'ADR. Un diagramme audité n'est pas un diagramme sans doutes, c'est un diagramme où les doutes sont étiquetés et tracés.
- Corriger à la main. Unifiez les nœuds dupliqués, divisez la boîte générique en les entrepôts réels, ajoutez la branche "non", fermez avec un terminator, changez le type de forme pour qu'un losange soit un losange et un entrepôt soit un cylindre, et réancrez les connecteurs aux bons points.
- Exporter à nouveau. Déversez le résultat dans le
.mmdet remplacez le fichier original dans le dépôt, dans le même commit que la révision. C'est l'étape que la plupart des équipes omettent et celle qui empêche l'erreur de se réintroduire.
En pratique, l'étape 3 est celle qui transforme cela en un processus d'ingénierie et non en une session de mise en page. Une note latérale avec un lien vers le fichier concret qui démontre que le travailleur consomme de la file d'attente est une documentation vérifiable ; "je pense que cette flèche est à l'envers" dans un fil Slack, non.
Liste de contrôle : 10 vérifications avant de fusionner un diagramme généré par IA
Liste fermée, conçue pour être collée dans le modèle de demande de tirage. Si l'une échoue, le diagramme n'entre pas.
- Unicité : aucun composant réel n'apparaît comme deux nœuds. Un ID par service, le nom du dépôt ou du déploiement.
- Décisions complètes : chaque losange a au moins deux arêtes de sortie, étiquetées, et la branche d'erreur a une destination.
- Terminators : chaque chemin se termine par un nœud terminal explicite ; il n'y a pas de chaînes qui se coupent à une étape de processus.
- Direction des données : chaque flèche va dans le sens où l'information voyage, pas dans celui de la hiérarchie organisationnelle. Vérifiez particulièrement les files d'attente, les webhooks et le polling.
- Entrepôts désagrégés : aucune boîte générique de type "Base de données", "Services" ou "Infrastructure". Un nœud par entrepôt avec technologie et contenu.
- Couches réelles : chaque
subgraphcorrespond à une limite qui existe (un déploiement, un dépôt, un compte, un réseau), pas à une abstraction de manuel. - Vocabulaire du domaine : les étiquettes utilisent les noms que l'équipe écrit dans le code et dans les tickets, pas les mots de votre prompt.
- Sans orphelins ni croisements évitables : aucun nœud déconnecté, et les croisements qui restent sont justifiés et ne se corrigent pas par réorganisation.
- Lisible à la taille à laquelle il est publié : compréhensible dans la largeur du
READMEou du portail de documentation, pas seulement avec un zoom. - Traçabilité : chaque élément non évident a une note avec un lien vers le code, le ticket ou l'ADR qui le soutient ; et le
.mmddu dépôt est celui exporté après la correction.
Développement dirigé par spécifications : si le diagramme est erroné, le code hérite de l'erreur
C'est la raison pour laquelle l'audit a cessé d'être cosmétique en 2026. Dans le développement dirigé par spécifications, la spécification en Markdown —avec ses diagrammes Mermaid d'architecture et de séquence— est l'artefact à partir duquel l'agent génère l'implémentation, pas un commentaire à son sujet. Un diagramme incorrect dans cette spécification n'est plus une documentation obsolète : c'est une entrée défectueuse dans un générateur de code.
L'approche est reprise dans le propre Spec Kit de GitHub, dont la thèse est que "les spécifications ne servent pas le code ; le code sert les spécifications", et les plans d'implémentation qu'il produit incluent des diagrammes d'architecture et de séquence en Mermaid aux côtés du modèle de données et des modes de défaillance.
Traduit dans le quotidien : un losange sans branche "non" dans la spécification est, avec une probabilité assez élevée, un cas d'erreur non implémenté dans le code généré. Une flèche inversée entre l'API et la file d'attente est un design push où vous vouliez pull. Et une boîte "Base de données" qui couvrait Postgres, Redis et S3 devient un dépôt unique avec trois responsabilités. Le diagramme est passé d'une photo du système à une partie du plan, et les plans sont révisés.
Questions fréquentes
Que signifie "Mermaid slop" ?
C'est un diagramme généré par IA avec une syntaxe Mermaid valide mais sans valeur communicative : formes génériques et identiques, palette par défaut, flèches mal étiquetées et, dans les pires cas, composants ou relations qui n'existent pas dans le système. Le terme s'est popularisé à partir du projet Diagram Design et est documenté par le revue d'explainX d'août 2026.
Peut-on valider automatiquement un diagramme Mermaid généré par IA ?
Seulement en partie. Un linter ou le propre parser détecte les erreurs de syntaxe, et des vérifications structurelles peuvent être automatisées : nœuds orphelins, losanges avec une seule sortie, chemins sans terminator ou IDs avec des étiquettes suspectement similaires. Ce que aucun outil ne peut vérifier seul, c'est si le diagramme décrit votre système ; cela nécessite de le croiser avec le code, et c'est pourquoi la checklist de cet article mélange vérifications automatisables et révision humaine.
Pourquoi ne suffit-il pas de vérifier le bloc mermaid dans la demande de tirage ?
Parce que dans le diff, vous lisez les arêtes une à une et les défauts pertinents concernent le graphe complet : croisements, hiérarchies inversées, cycles, nœuds isolés, densité illisible. De plus, en lisant le texte, vous évaluez l'intention de l'auteur et non ce que verra le lecteur du rendu. La révision utile se fait sur le diagramme dessiné.
Quel outil utiliser pour corriger un diagramme Mermaid à la main ?
Vous avez besoin d'une toile qui fait le voyage complet : importer le .mmd, vous laisser déplacer et changer des formes et des connecteurs, annoter des éléments et exporter à nouveau vers Mermaid. Cette dernière étape est celle qui écarte la plupart des visionneuses, qui rendent mais ne renvoient pas le code corrigé. FlowBoard couvre le cycle : importe Mermaid depuis un fichier ou en collant le code, répartit le diagramme sur une toile infinie avec zoom et défilement, permet de corriger des formes, des connecteurs et des ancrages à la main avec magnétisme aux points d'ancrage, d'ajouter des notes latérales avec des liens par élément et d'exporter de nouveau vers Mermaid.
Combien de temps faut-il pour auditer un diagramme généré par IA ?
Cela dépend de la taille, mais l'ordre de grandeur pour un diagramme de 15-25 nœuds est de 20 à 40 minutes la première fois, et beaucoup moins lorsque l'équipe a déjà intégré la checklist et fixé les noms de domaine. Comparé au coût qu'une architecture erronée entre dans la documentation officielle —ou, dans un flux dirigé par spécification, dans le code généré—, c'est bon marché.
Faut-il cesser d'utiliser l'IA pour faire des diagrammes ?
Non. Générer le premier brouillon avec un agent économise le travail fastidieux de taper des nœuds et des arêtes, et pour explorer un système inconnu, c'est utile. Ce qui ne doit pas être sauté, c'est l'étape suivante : aucun diagramme généré par IA n'est publié sans passer par la toile et par la checklist. L'IA fait le brouillon ; la responsabilité du diagramme reste celle de l'équipe qui le signe.
Conclusion : le diagramme que vous publiez est celui que vous avez audité
Le changement de 2026 n'est pas que l'IA dessine des diagrammes, c'est qu'elle les dessine plus rapidement que nous ne les révisons. Pendant que VS Code les peint sans configuration, Claude les transforme en tableaux et les spécifications en Markdown alimentent des générateurs de code, le seul contrôle qualité qui reste est humain : regarder la forme, marquer ce qui ne peut pas être prouvé et renvoyer au dépôt la version corrigée. Dix vérifications et un cycle qui se ferme suffisent pour qu'un diagramme redevienne une documentation fiable plutôt qu'une décoration plausible.
Ce cycle a besoin d'un endroit où se produire. Chez AIsToHire, nous le résolvons avec FlowBoard, notre tableau infini pour diagrammes : on colle ou on importe le .mmd de l'agent, on le répartit sur un canvas infini, on repositionne des formes — rectangles, ellipses, losanges de décision, documents, notes adhésives et texte — et des connecteurs avec des flèches droites ou orthogonales, on ancre chaque connexion avec magnétisme aux points des éléments, on annotent ce qui est douteux avec des notes latérales et des liens de vérification, et on exporte de nouveau vers Mermaid. Le tableau se sauvegarde automatiquement, donc l'audit est enregistré et peut être repris.
Ouvre FlowBoard, colle le .mmd fourni par l'agent et audite le diagramme où ça se voit vraiment : réorganise par couches, corrige les formes et les connecteurs à la main, note ce qui est douteux avec des liens de vérification et réexporte-le vers Mermaid. Commence ton premier tableau gratuitement.
Ouvre FlowBoard, colle le .mmd fourni par l'agent et audite le diagramme où ça se voit vraiment : réorganise par couches, corrige les formes et les connecteurs à la main, note ce qui est douteux avec des liens de vérification et réexporte-le vers Mermaid. Commence ton premier tableau gratuitement.Continuer la lecture
Voir tous les articles →
Symboles d'un diagramme de flux : que signifie chacun et comment dessiner le vôtre étape par étape

Pourquoi votre assurance automobile a augmenté en 2026 : prime moyenne de 1 412 € et record historique

Discuter par WhatsApp ou en personne : que dit la science sur les conflits de couple par messages
