FlowBoardFlowBoard

Mermaid slop: jak zkontrolovat a opravit diagramy od AI před jejich zveřejněním

Tým FlowBoardNapsáno s pomocí AI13 min čtení

Ve zkratce:

  • „Mermaid slop“ je název, který se v roce 2026 vžil pro diagramy generované AI, které jsou syntakticky platné, ale nečitelné nebo přímo nepravdivé; termín vzešel z projektu Diagram Design, který se prezentoval heslem „no Figma, no generic rounded boxes, no Mermaid-slop“ a v srpnu 2026 už měl přes 11 000 hvězdiček na GitHubu (explainX, 16. 8. 2026).
  • Problém rostl s rozšířením: VS Code 1.121 (20. 5. 2026) vykresluje Mermaid nativně v náhledu Markdownu, bez rozšíření, a asistenti ho generují ve výchozím nastavení (Visual Studio Code).
  • Model optimalizuje gramatickou platnost, ne správnost systému: soubor .mmd se zparsuje, ale zdvojí uzly, vynechá větev „ne“ rozhodnutí nebo obrátí směr dat.
  • Kontrola diagramu čtením řádků s --> nefunguje: vady, na kterých záleží, jsou topologické a vidět jsou jen na nakresleném diagramu.
  • Cyklus, který funguje: importovat .mmd na plátno, uspořádat do vrstev, pochybné části okomentovat odkazem na kód nebo tiket, který je dokládá, opravit ručně a znovu exportovat, aby do repozitáře putovala opravená verze.

Od poloviny roku 2026 se v inženýrských týmech už neptáme, jak diagram vygenerovat, ale kdo za něj ručí. Agenti píšou Mermaid za běhu, GitHub a VS Code ho vykreslí bez konfigurace a výsledek se dostane do README stejně přirozeně jako blok kódu. Chybí vrstva auditu. Tento článek prochází typické vady, technický důvod, proč vznikají, a opakovatelný revizní cyklus, který se uzavírá ve vizuálním plátně — v našem případě v FlowBoardu, nekonečné tabuli na diagramy od AIsToHire, která importuje a znovu exportuje Mermaid — aby publikovaný diagram byl ten opravený, a ne první, který model vyplivl.

Nečitelný diagram vytvořený AI na obrazovce vedle téhož diagramu uspořádaného do vrstev na vizuálním plátně
Nečitelný diagram vytvořený AI na obrazovce vedle téhož diagramu uspořádaného do vrstev na vizuálním plátně

Co přesně je „Mermaid slop“?

Mermaid slop je diagram vytvořený AI, který se zkompiluje bez chyb a přesto je k ničemu: stejné zaoblené krabice pro různé pojmy, šipky bez popisku nebo s vágními popisky, výchozí barvy, které nic neříkají, a reflexivní generování — kreslí se, protože se o to požádalo, ne proto, že je to potřeba. Definici stanovuje přehled explainX o tomto termínu (16. 8. 2026), který ho vystopoval až k projektu Diagram Design Cathryn Lavery.

Důležitý je rozdíl, že existují dvě vrstvy „slopu“, které se často pletou:

VrstvaCo selháváJak se poznáCena opravy
EstetickáGenerické tvary, výchozí paleta, všechno stejnéNa první pohledNízká: motiv, tvary, seskupení
SémantickáDiagram popisuje systém, který neexistujeJen porovnáním se skutečným kódemVysoká: je nutné znovu otevřít repozitář

Veřejná debata roku 2026 se téměř celá soustředila na první vrstvu. Nástroje, které se objevily — od editorských skills pro diagramy až po generátory, které místo textu Mermaid tvoří nativní prvky Excalidraw — míří hlavně na vzhled. Druhá vrstva, ta, kvůli které diagram lže o tvé architektuře, zůstává lidskou prací.

Proč LLM vytváří Mermaid syntakticky dokonalý, ale sémanticky chudý?

Protože jde o dva různé cíle a jen jeden z nich má hojný trénovací signál. Gramatika Mermaidu je uzavřená, malá a na GitHubu masivně zastoupená: model ji reprodukuje téměř bez chyb. Správnost diagramu naproti tomu závisí na konkrétním systému, který model obvykle nečetl celý, takže mezery vyplňuje nejčastější podobou architektonického diagramu, ne tou tvojí.

K tomu se přidávají tři praktické efekty:

  • Prompt je jediný zdroj. Pokud systém popíšeš třemi větami, agent vrátí diagram s detailností tří vět a ozdobí ho, dokud nebude vypadat úplně. Jak o vibe diagrammingu shrnuje sám Mermaid, „diagram vygenerovaný z vágního promptu odrazí vágnost promptu“ (Mermaid, 24. 3. 2026).
  • Neexistuje sémantický kompilátor. Červený test tě upozorní; nesprávný diagram se vykreslí stejně hezky jako správný. Neexistuje obdoba tsc pro „tato služba neexistuje“.
  • Rozložení určuje engine, ne autor. Mermaid umisťuje uzly svým algoritmem a po vykreslení nenabízí pohodlný způsob, jak rozložení opravit. Pokud skutečná hierarchie neodpovídá tomu, co automatické rozložení nakreslí, spor s nástrojem prohraješ.

A kontext odvětví říká, že ověřování není volitelné. Průzkum mezi vývojáři 2026 od Stack Overflow (zveřejněný 6. 10. 2026, více než 30 000 odpovědí ze 169 zemí) zjistil, že zhruba polovina důvěřuje výstupu AI jen tehdy, když ho může snadno ověřit, a že pouhých 6,6 % by ho přijalo jako dobrý podklad pro důležitá rozhodnutí. Architektonický diagram v oficiální dokumentaci je téměř z definice důležité rozhodnutí.

Sedm opakujících se vad diagramu vytvořeného AI

Těchto sedm se objevuje stále dokola při auditu souborů .mmd vytvořených agenty. Všechny se zparsují; všechny jsou špatně. Společným vzorem je, že model doplňuje věrohodnou strukturu tam, kde mu chybí informace z domény.

Šest ilustrací opakujících se vad diagramů vytvořených AI: duplicitní uzly, rozhodnutí bez větve ne, tok bez ukončení, obrácené šipky, generická krabice skrývající několik úložišť a vymyšlené vrstvy
Šest ilustrací opakujících se vad diagramů vytvořených AI: duplicitní uzly, rozhodnutí bez větve ne, tok bez ukončení, obrácené šipky, generická krabice skrývající několik úložišť a vymyšlené vrstvy
#VadaPříznak v .mmdDůsledek
1Duplicitní uzlyDvě různá ID s podobnými popisky pro stejnou službuVypadá to, že komponenty jsou dvě, ačkoli je jedna
2Rozhodnutí bez větve „ne“Kosočtverec s jedinou výstupní hranouChybová cesta zůstane nezdokumentovaná
3Tok bez ukončeníŘetězce, které končí procesním uzlemNení jasné, kdy případ užití končí
4Obrácený směrŠipka míří ke zdroji datObrátí se, kdo koho volá
5Generická krabiceJediný uzel „Databáze“Skrývá tři úložiště s různými zárukami
6Falešná hloubkaVrstvy nebo subgraph, které v kódu neexistujíDává autoritu vymyšlené architektuře
7Popisky z promptuUzly opakují tvá slova, ne slovník doményDiagram nelze vyhledat ani poznat

1. Duplicitní uzly, které jsou touž službou

Model viděl „auth“ a „autentizační služba“ ve dvou různých větách a vytvořil dva uzly.

flowchart LR
  API[API Gateway] --> AUTH[Auth]
  API --> AUTHSVC[Autentizační služba]
  AUTH --> DB[(Databáze)]
  AUTHSVC --> DB

Opraveno: jeden uzel, jedno ID, název, který používá tým.

flowchart LR
  API[API Gateway] --> AUTH[auth-service]
  AUTH --> USERS[(postgres: users)]

2. Rozhodnutí bez větve „ne“

flowchart TD
  REQ[Požadavek] --> Q{Platný token?}
  Q -->|Ano| OK[Zpracovat]

Kosočtverec s jediným výstupem není rozhodnutí: je to ozdoba. Každá podmínka potřebuje obě cesty a chybová cesta potřebuje cíl.

flowchart TD
  REQ[Požadavek] --> Q{Platný token?}
  Q -->|ano| OK[Zpracovat]
  Q -->|ne| R401[Odpovědět 401]
  OK --> FIN([Konec])
  R401 --> FIN

3. Šipky, které obracejí směr dat

Klasika u front a webhooků: model nakreslí organizační hierarchii místo skutečného toku.

flowchart LR
  WORKER[Worker] --> QUEUE[Fronta úloh]

Worker do fronty neposílá: odebírá z ní. Špatné nakreslení tohoto směru promění návrh typu pull v návrh typu push, což je jiný systém s jinými zárukami.

flowchart LR
  API[API] -->|zařadí do fronty| QUEUE[Fronta úloh]
  QUEUE -->|odebírá| WORKER[Worker]

4. Generická krabice „Databáze“

Je to nejdražší vada, protože zmizí přesně ta informace, kvůli které někdo diagram otevírá. Uzel [(Databáze)], za kterým se ve skutečnosti skrývá Postgres pro transakce, Redis pro relace a S3 pro přílohy, nedokumentuje: skrývá. Praktické pravidlo: pokud mají dvě úložiště různé záruky trvanlivosti, jsou to dva uzly.

5, 6 a 7: vymyšlené vrstvy a vypůjčené popisky

Podgrafy subgraph nazvané „Prezentační vrstva“, „Byznys vrstva“ a „Datová vrstva“ bývají mentální šablonou modelu, ne strukturou tvého repozitáře. Stejně tak popisky: pokud se uzel jmenuje „modul zpracování plateb“ a v kódu je to billing-worker, nikdo nebude moci diagram propojit s projektem. A pokud chybí ukončení, čtenář neví, jestli tok tam opravdu končí, nebo se model zastavil v půlce.

Proč kontrola diagramu v textu nefunguje?

Protože vady, na kterých záleží, jsou topologické a text je neukáže. Čtením seznamu řádků A --> B můžeš ověřit, že je každá hrana jednotlivě věrohodná, ale neuvidíš, že se dvě šipky kříží, že uzel zůstal osiřelý, že je hierarchie obrácená nebo že existuje cyklus o třech skocích. Tyto vlastnosti jsou vidět, až když je graf nakreslený a rozmístěný.

Srovnání kontroly diagramu čtením řádků kódu a jeho prohlížením v nakreslené podobě, kde je vidět křížení šipek a duplicitní uzel
Srovnání kontroly diagramu čtením řádků kódu a jeho prohlížením v nakreslené podobě, kde je vidět křížení šipek a duplicitní uzel

Existuje druhý, jemnější důvod: čtením .mmd kontroluješ to, co autor napsal; pohledem na vykreslený výstup kontroluješ to, čemu bude rozumět čtenář. To jsou různé věci. Diagram s patnácti správnými hranami a automatickým rozložením, které je nahází na hromadu, je technicky v pořádku a komunikačně rozbitý, a přesně takový recenzent pull requestu schválí bez pohledu, protože „blok mermaid je správně utvořený“.

Do tohoto směru se posunulo i celé odvětví. Anthropic 10. 11. 2026 spustil v betě Claude Whiteboards: plátno v reálném čase, na kterém asistent promění diskusi v tabuli, seskupí poznámky podle témat a umožní ji pak přenést do Lucidu, Mira nebo Vani od Zoho (unite.ai). A Miro na své akci Canvas 26 prohlásilo, že už „nepodniká v oboru tabulí“ a chce být „kolaborativní rozhodovací vrstvou pro agentní podnik“ (Forrester, 1. 6. 2026). Přirozeným výstupem AI se stává plátno, ne textový blok. Pro toho, kdo diagramy auditují, je to dobrá zpráva: revize patří tam, kde je vidět tvar.

Revizní cyklus: z .mmd na plátno a zpět do .mmd

Cyklus má pět kroků a jeho klíčovou vlastností je, že se uzavírá: do repozitáře putuje diagram opravený na plátně, ne originál od agenta. Pokud oprava zůstane ve snímku obrazovky nebo v komentáři k pull requestu, chybný .mmd přežije a znovu nakrmí dalšího agenta.

Pětikrokový cyklus auditu diagramu: importovat kód, rozmístit ho na plátně, uspořádat do vrstev, označit pochybné a exportovat zpět
Pětikrokový cyklus auditu diagramu: importovat kód, rozmístit ho na plátně, uspořádat do vrstev, označit pochybné a exportovat zpět
  1. Importovat. Vlož .mmd, který ti agent dal, do vizuálního plátna nebo ho načti jako soubor. Cíl: oddělit revizi od editoru kódu, kde je pokušení číst místo dívat se.
  2. Rozmístit a uspořádat. Rozlož uzly do vodorovných vrstev podle odpovědnosti (vstup, orchestrace, doména, úložiště). Téměř všechny vady směru a falešné hloubky se tu prozradí: šipka, která stoupá o dvě vrstvy, je obvykle obrácená šipka.
  3. Označit pochybné. Každý uzel nebo spoj, který nemůžeš potvrdit čtením kódu, se okomentuje a poznámka obsahuje odkaz na důkaz: soubor, tiket, ADR. Auditovaný diagram není ten bez pochybností, ale ten, kde jsou pochybnosti označené a dohledatelné.
  4. Opravit ručně. Sjednotit duplicitní uzly, rozdělit generickou krabici na skutečná úložiště, přidat větev „ne“, uzavřít ukončením, změnit typ tvaru, aby kosočtverec byl kosočtverec a úložiště válec, a znovu ukotvit spoje do správných bodů.
  5. Exportovat zpět. Výsledek vyexportovat do .mmd a nahradit původní soubor v repozitáři, ve stejném commitu jako revize. To je krok, který většina týmů přeskakuje a který brání tomu, aby se chyba znovu zavlekla.

V praxi je právě krok 3 tím, co z toho dělá inženýrský proces, a ne grafickou úpravu. Boční poznámka s odkazem na konkrétní soubor, který dokazuje, že worker odebírá z fronty, je ověřitelná dokumentace; „myslím, že tahle šipka je obráceně“ ve vlákně na Slacku není.

Checklist: 10 kontrol před mergem diagramu vytvořeného AI

Uzavřený seznam určený k vložení do šablony pull requestu. Pokud některá kontrola selže, diagram neprojde.

  1. Jedinečnost: žádná skutečná komponenta se neobjevuje jako dva uzly. Jedno ID na službu, název z repozitáře nebo nasazení.
  2. Úplná rozhodnutí: každý kosočtverec má alespoň dvě pojmenované výstupní hrany a chybová větev má cíl.
  3. Ukončení: každá cesta končí explicitním koncovým uzlem; nejsou tu řetězce, které se přeruší na procesním kroku.
  4. Směr dat: každá šipka míří tím směrem, kterým putují informace, ne směrem organizační hierarchie. Zvlášť zkontroluj fronty, webhooky a polling.
  5. Rozdělená úložiště: žádná generická krabice typu „Databáze“, „Služby“ nebo „Infrastruktura“. Jeden uzel na úložiště s technologií a obsahem.
  6. Skutečné vrstvy: každý subgraph odpovídá hranici, která existuje (nasazení, repozitář, účet, síť), ne učebnicové abstrakci.
  7. Slovník domény: popisky používají názvy, které tým píše v kódu a v tiketech, ne slova z tvého promptu.
  8. Bez osiřelých uzlů a zbytečných křížení: žádný odpojený uzel a křížení, která zbydou, jsou odůvodněná a nedají se vyřešit přeuspořádáním.
  9. Čitelné ve velikosti, v jaké se publikuje: je srozumitelné v šířce README nebo portálu dokumentace, ne jen po přiblížení.
  10. Dohledatelnost: každý neočividný prvek má poznámku s odkazem na kód, tiket nebo ADR, který ho dokládá; a .mmd v repozitáři je ten exportovaný po opravě.

Spec-driven development: když je diagram špatně, kód zdědí chybu

To je důvod, proč přestal být audit v roce 2026 kosmetickou záležitostí. Ve vývoji řízeném specifikací je specifikace v Markdownu — s architektonickými a sekvenčními diagramy Mermaid — artefaktem, ze kterého agent generuje implementaci, ne komentářem k ní. Nesprávný diagram uvnitř takové specifikace už není zastaralá dokumentace: je to vadný vstup do generátoru kódu.

Přístup je zachycen v samotném Spec Kitu od GitHubu, jehož teze zní, že „specifikace neslouží kódu; kód slouží specifikacím“, a implementační plány, které vytváří, obsahují architektonické a sekvenční diagramy v Mermaidu vedle datového modelu a režimů selhání.

V každodenní praxi: kosočtverec bez větve „ne“ ve specifikaci je s velkou pravděpodobností neimplementovaný chybový případ ve vygenerovaném kódu. Obrácená šipka mezi API a frontou je návrh push tam, kde jsi chtěl pull. A krabice „Databáze“, která zakrývala Postgres, Redis a S3, se promění v jediný repozitář se třemi odpovědnostmi. Diagram přestal být fotografií systému a stal se součástí plánu, a plány se kontrolují.

Často kladené otázky

Co znamená „Mermaid slop“?

Je to diagram vytvořený AI s platnou syntaxí Mermaid, ale bez komunikační hodnoty: generické a stejné tvary, výchozí paleta, špatně popsané šipky a v nejhorších případech komponenty nebo vztahy, které v systému neexistují. Termín se vžil z projektu Diagram Design a dokumentuje ho přehled explainX ze srpna 2026.

Dá se diagram Mermaid vytvořený AI validovat automaticky?

Jen zčásti. Linter nebo samotný parser odhalí syntaktické chyby a lze automatizovat strukturální kontroly: osiřelé uzly, kosočtverce s jediným výstupem, cesty bez ukončení nebo ID s podezřele podobnými popisky. Co žádný nástroj sám neověří, je, zda diagram popisuje tvůj systém; to vyžaduje porovnání s kódem, a proto checklist v tomto článku kombinuje automatizovatelné kontroly s lidskou revizí.

Proč nestačí zkontrolovat blok mermaid v pull requestu?

Protože v diffu čteš hrany jednu po druhé a podstatné vady se týkají celého grafu: křížení, obrácené hierarchie, cykly, izolované uzly, nečitelná hustota. Navíc při čtení textu hodnotíš záměr autora, ne to, co uvidí čtenář vykresleného výstupu. Užitečná revize se dělá na nakresleném diagramu.

Jaký nástroj použít k ruční opravě diagramu Mermaid?

Potřebuješ plátno, které zvládne celou cestu: importovat .mmd, nechat tě přesouvat uzly a měnit tvary a spoje, komentovat prvky a exportovat zpět do Mermaidu. Právě poslední krok vynechává většina prohlížečů, které vykreslují, ale opravený kód nevrátí. FlowBoard pokrývá celý cyklus: importuje Mermaid ze souboru nebo vložením kódu, rozmístí diagram na nekonečném plátně s přibližováním a posouváním, umožňuje ručně opravovat tvary, spoje a kotvy s magnetismem ke kotvicím bodům, přidávat boční poznámky s odkazy ke každému prvku a exportovat zpět do Mermaidu.

Jak dlouho trvá audit diagramu vytvořeného AI?

Záleží na velikosti, ale řádově je to u diagramu o 15–25 uzlech poprvé 20 až 40 minut a výrazně méně, když už tým checklist zvnitřnil a má ustálené názvy z domény. Ve srovnání s cenou za to, že se chybná architektura dostane do oficiální dokumentace — nebo, v toku řízeném specifikací, do vygenerovaného kódu — je to levné.

Mám přestat používat AI na tvorbu diagramů?

Ne. První návrh od agenta ušetří únavné ťukání uzlů a hran a při poznávání neznámého systému je užitečný. Nesmíš ale vynechat následující krok: žádný diagram vytvořený AI se nepublikuje, aniž by prošel plátnem a checklistem. AI dělá návrh; odpovědnost za diagram zůstává týmu, který ho podepisuje.

Závěr: publikovaný diagram je ten, který jsi auditoval

Změnou roku 2026 není, že AI kreslí diagramy, ale že je kreslí rychleji, než je stíháme kontrolovat. Zatímco je VS Code vykresluje bez konfigurace, Claude z nich dělá tabule a specifikace v Markdownu krmí generátory kódu, jedinou kontrolou kvality zůstává ta lidská: podívat se na tvar, označit, co nelze doložit, a vrátit do repozitáře opravenou verzi. Deset kontrol a cyklus, který se uzavírá, stačí na to, aby byl diagram opět spolehlivou dokumentací a ne věrohodnou dekorací.

Tento cyklus potřebuje místo, kde se odehraje. V AIsToHire ho řešíme pomocí FlowBoardu, naší nekonečné tabule na diagramy: vloží se nebo importuje .mmd od agenta, rozmístí se na nekonečném plátně, přeuspořádají se tvary — obdélníky, elipsy, rozhodovací kosočtverce, dokumenty, samolepicí poznámky a text — a spoje s rovnými nebo pravoúhlými šipkami, každé spojení se ukotví s magnetismem k bodům prvků, pochybné se okomentuje bočními poznámkami a ověřovacími odkazy a exportuje se zpět do Mermaidu. Tabule se ukládá sama, takže audit zůstane zaznamenaný a lze na něj navázat.

Otevři FlowBoard, vlož `.mmd`, který ti dal agent, a audituj diagram tam, kde je opravdu vidět: uspořádej ho do vrstev, ručně oprav tvary a spoje, okomentuj pochybné části ověřovacími odkazy a exportuj ho zpět do Mermaidu. Začni svou první tabuli zdarma.

Otevři FlowBoard, vlož `.mmd`, který ti dal agent, a audituj diagram tam, kde je opravdu vidět: uspořádej ho do vrstev, ručně oprav tvary a spoje, okomentuj pochybné části ověřovacími odkazy a exportuj ho zpět do Mermaidu. Začni svou první tabuli zdarma.

↑ Zpět nahoru