FlowBoardMermaid 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
.mmdse 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
.mmdna 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.

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:
| Vrstva | Co selhává | Jak se pozná | Cena opravy |
|---|---|---|---|
| Estetická | Generické tvary, výchozí paleta, všechno stejné | Na první pohled | Nízká: motiv, tvary, seskupení |
| Sémantická | Diagram popisuje systém, který neexistuje | Jen porovnáním se skutečným kódem | Vysoká: 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
tscpro „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.

| # | Vada | Příznak v .mmd | Důsledek |
|---|---|---|---|
| 1 | Duplicitní uzly | Dvě různá ID s podobnými popisky pro stejnou službu | Vypadá to, že komponenty jsou dvě, ačkoli je jedna |
| 2 | Rozhodnutí bez větve „ne“ | Kosočtverec s jedinou výstupní hranou | Chybová cesta zůstane nezdokumentovaná |
| 3 | Tok bez ukončení | Řetězce, které končí procesním uzlem | Není jasné, kdy případ užití končí |
| 4 | Obrácený směr | Šipka míří ke zdroji dat | Obrátí se, kdo koho volá |
| 5 | Generická krabice | Jediný uzel „Databáze“ | Skrývá tři úložiště s různými zárukami |
| 6 | Falešná hloubka | Vrstvy nebo subgraph, které v kódu neexistují | Dává autoritu vymyšlené architektuře |
| 7 | Popisky z promptu | Uzly opakují tvá slova, ne slovník domény | Diagram 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ý.

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.

- 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. - 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.
- 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é.
- 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ů.
- Exportovat zpět. Výsledek vyexportovat do
.mmda 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.
- Jedinečnost: žádná skutečná komponenta se neobjevuje jako dva uzly. Jedno ID na službu, název z repozitáře nebo nasazení.
- Úplná rozhodnutí: každý kosočtverec má alespoň dvě pojmenované výstupní hrany a chybová větev má cíl.
- Ukončení: každá cesta končí explicitním koncovým uzlem; nejsou tu řetězce, které se přeruší na procesním kroku.
- 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.
- 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.
- Skutečné vrstvy: každý
subgraphodpovídá hranici, která existuje (nasazení, repozitář, účet, síť), ne učebnicové abstrakci. - 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.
- 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.
- Čitelné ve velikosti, v jaké se publikuje: je srozumitelné v šířce
READMEnebo portálu dokumentace, ne jen po přiblížení. - Dohledatelnost: každý neočividný prvek má poznámku s odkazem na kód, tiket nebo ADR, který ho dokládá; a
.mmdv 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.Číst dál
Zobrazit všechny články →
Symboly vývojového diagramu: co který znamená a jak nakreslit vlastní krok za krokem

Hádka přes WhatsApp, nebo rozhovor osobně: co říká věda o partnerských konfliktech přes zprávy

Myšlenková mapa, pojmová mapa a osnova: rozdíly a kdy použít kterou
