FlowBoardMermaid slop: как да прегледате и поправите диаграмите, които ИИ ви генерира, преди да ги публикувате
Екипът на FlowBoardНаписано с помощта на ИИ14 мин четенеНакратко:
- „Mermaid slop“ е името, наложило се през 2026 г. за диаграмите, генерирани от ИИ, които са синтактично валидни, но нечетими или направо неверни; терминът води началото си от проекта Diagram Design, представян с мотото „no Figma, no generic rounded boxes, no Mermaid-slop“, който през август 2026 г. вече надхвърляше 11 000 звезди в GitHub (explainX, 16 август 2026 г.).
- Проблемът нарасна с разпространението: VS Code 1.121 (20 май 2026 г.) визуализира Mermaid нативно в прегледа на Markdown, без разширение, а асистентите го генерират по подразбиране (Visual Studio Code).
- Моделът оптимизира граматична валидност, а не коректност на системата:
.mmdсе парсва, но дублира възли, пропуска клона „не“ на дадено решение или обръща посоката на данните. - Прегледът на диаграма чрез четене на редове с
-->не работи: дефектите, които имат значение, са топологични и се виждат само когато диаграмата е нарисувана. - Цикълът, който наистина работи: импортирате
.mmdв платно, пренареждате по слоеве, отбелязвате съмнителното с връзка към кода или тикета, който го доказва, поправяте на ръка и експортирате обратно, така че в хранилището да попадне коригираната версия.
От средата на 2026 г. въпросът в инженерните екипи вече не е как да се генерира диаграма, а кой отговаря за нея. Агентите пишат Mermaid в движение, GitHub и VS Code го рисуват без настройка и резултатът влиза в README със същата лекота, с която влиза блок с код. Липсва слоят за одит. Тази статия разглежда типичните дефекти, техническата причина за появата им и възпроизводим цикъл на преглед, който се затваря във визуално платно – в нашия случай FlowBoard, безкрайната дъска за диаграми на AIsToHire, която импортира и експортира обратно Mermaid – така че публикуваната диаграма да е коригираната, а не първата, която моделът е изплюл.

Какво точно е „Mermaid slop“?
Mermaid slop е диаграма, генерирана от ИИ, която се компилира без грешки и въпреки това е безполезна: еднакви заоблени кутии за различни понятия, стрелки без етикет или с неясни етикети, цветове по подразбиране, които не казват нищо, и рефлексивно генериране – рисува се, защото е поискано, а не защото е нужно. Определението е фиксирано от прегледа на explainX за термина (16 август 2026 г.), който го проследява до проекта Diagram Design на Cathryn Lavery.
Важният нюанс е, че има два слоя „slop“ и често се бъркат:
| Слой | Какво не е наред | Как се открива | Цена на поправката |
|---|---|---|---|
| Естетически | Общи форми, палитра по подразбиране, всичко еднакво | С просто око | Ниска: тема, форми, групиране |
| Семантичен | Диаграмата описва система, която не съществува | Само чрез сравнение с реалния код | Висока: трябва да се отвори отново хранилището |
Публичният разговор през 2026 г. се съсредоточи почти изцяло върху първия. Инструментите, които се появиха – от skills за редакторско диаграмиране до генераторите, които създават нативни елементи на Excalidraw вместо Mermaid текст – атакуват най-вече външния вид. Вторият слой, който кара диаграмата да лъже за вашата архитектура, си остава човешка работа.
Защо един LLM създава Mermaid с безупречен синтаксис, но слаба семантика?
Защото това са две различни цели и само за едната има изобилие от обучаващ сигнал. Граматиката на Mermaid е затворена, малка и масово представена в GitHub: моделът я възпроизвежда почти без грешки. Коректността на диаграмата, напротив, зависи от конкретна система, която моделът обикновено не е прочел цялата, така че запълва празнините с най-честата форма на архитектурна диаграма, а не с вашата.
Към това се добавят три практически ефекта:
- Промптът е единственият източник. Ако опишете системата в три изречения, агентът връща диаграма с детайлността на три изречения и я украсява, докато заприлича на пълна. Както самият Mermaid обобщава, говорейки за vibe diagramming: „диаграма, генерирана от неясен промпт, ще отразява неяснотата на промпта“ (Mermaid, 24 март 2026 г.).
- Няма семантичен компилатор. Червеният тест ви предупреждава; грешната диаграма се визуализира също толкова красиво, колкото и вярната. Няма еквивалент на
tscза „тази услуга не съществува“. - Подредбата се определя от двигателя, а не от автора. Mermaid разполага възлите със своя алгоритъм и не ви предлага удобен начин да коригирате разположението след визуализацията. Ако реалната йерархия не съвпада с това, което рисува авто-подредбата, губите спора с инструмента.
А контекстът в бранша показва, че проверката не е по избор. Анкетата сред разработчици 2026 на Stack Overflow (публикувана на 6 октомври 2026 г., над 30 000 отговора от 169 държави) установи, че близо половината се доверяват на изхода на ИИ само когато могат лесно да го проверят, а едва 6,6 % биха го приели за добър при важни решения. Архитектурна диаграма в официалната документация е, почти по дефиниция, важно решение.
Седемте повтарящи се дефекта на една диаграма, генерирана от ИИ
Това са седемте, които се появяват отново и отново при одит на .mmd файлове, генерирани от агенти. Всички се парсват; всички са грешни. Общият модел е, че моделът запълва правдоподобна структура там, където му липсва информация за домейна.

| # | Дефект | Симптом в .mmd | Последица |
|---|---|---|---|
| 1 | Дублирани възли | Два различни ID с подобни етикети за една и съща услуга | Изглежда, че има два компонента там, където има един |
| 2 | Решение без клон „не“ | Ромб с един-единствен изходящ ръб | Пътят на грешката остава недокументиран |
| 3 | Поток без терминатор | Вериги, които завършват във възел за процес | Не се знае кога свършва случаят на употреба |
| 4 | Обърната посока | Стрелката сочи към източника на данните | Обръща се кой кого извиква |
| 5 | Обща кутия | Един-единствен възел „База данни“ | Скрива три хранилища с различни гаранции |
| 6 | Фалшива дълбочина | Слоеве или subgraph, които не съществуват в кода | Придава авторитет на измислена архитектура |
| 7 | Етикети от промпта | Възлите повтарят вашите думи, а не речника на домейна | Диаграмата не може да се търси и не се разпознава |
1. Дублирани възли, които са една и съща услуга
Моделът е видял „auth“ и „услуга за автентикация“ в две различни изречения и е създал два възела.
flowchart LR
API[API Gateway] --> AUTH[Auth]
API --> AUTHSVC[Servicio de autenticacion]
AUTH --> DB[(Base de datos)]
AUTHSVC --> DB
Поправено: един възел, един ID, името, което използва екипът.
flowchart LR
API[API Gateway] --> AUTH[auth-service]
AUTH --> USERS[(postgres: users)]
2. Решения без клон „не“
flowchart TD
REQ[Peticion] --> Q{Token valido?}
Q -->|Si| OK[Procesar]
Ромб с един изход не е решение: той е украшение. Всяко условие се нуждае от двата си пътя, а пътят на грешката се нуждае от местоназначение.
flowchart TD
REQ[Peticion] --> Q{Token valido?}
Q -->|si| OK[Procesar]
Q -->|no| R401[Responder 401]
OK --> FIN([Fin])
R401 --> FIN
3. Стрелки, които обръщат посоката на данните
Класика при опашките и webhook-овете: моделът рисува организационната йерархия вместо реалния поток.
flowchart LR
WORKER[Worker] --> QUEUE[Cola de trabajos]
Worker-ът не бута към опашката: той консумира от нея. Грешната посока превръща дизайн pull в дизайн push, който е друга система с други гаранции.
flowchart LR
API[API] -->|encola| QUEUE[Cola de trabajos]
QUEUE -->|consume| WORKER[Worker]
4. Общата кутия „База данни“
Това е най-скъпият дефект, защото изчезва точно информацията, заради която някой отваря диаграмата. Възел [(Base de datos)], зад който всъщност стоят Postgres за транзакции, Redis за сесии и S3 за прикачени файлове, не документира: скрива. Практическото правило: ако две хранилища имат различни гаранции за трайност, те са два възела.
5, 6 и 7: измислени слоеве и заети етикети
subgraph с имена „Презентационен слой“, „Бизнес слой“ и „Слой за данни“ обикновено са мисловен шаблон на модела, а не структура на вашето хранилище. Същото важи и за етикетите: ако възелът се казва „модул за обработка на плащания“, а в кода е billing-worker, никой няма да може да свърже диаграмата с проекта. А ако липсва терминаторът, читателят не знае дали потокът свършва там, или моделът е спрял по средата.
Защо прегледът на диаграма в текстов вид не работи?
Защото дефектите, които имат значение, са топологични, а текстът не ги разкрива. Четейки списък от редове A --> B, можете да проверите, че всеки ръб е правдоподобен поотделно, но няма да видите, че две стрелки се пресичат, че един възел е останал сирак, че йерархията е обърната или че има цикъл от три прехода. Тези свойства са видими само когато графът е нарисуван и разположен.

Има и втора, по-тънка причина: когато четете .mmd, проверявате това, което авторът е написал; когато гледате визуализацията, проверявате това, което читателят ще разбере. Това са различни неща. Диаграма с петнадесет верни ръба и авто-подредба, която ги трупа накуп, е технически наред и комуникативно счупена, и точно такава е тази, която рецензентът на pull request одобрява, без да гледа, защото „mermaid блокът е добре оформен“.
Самата индустрия се движи в тази посока. Anthropic пусна Claude Whiteboards в бета на 10 ноември 2026 г.: платно в реално време, където асистентът превръща дискусията в табло, групира бележките по теми и позволява след това да се пренесе в Lucid, Miro или Vani на Zoho (unite.ai). А Miro на събитието си Canvas 26 заяви, че вече „не е в бизнеса с дъски“ и че иска да бъде „съвместният слой за вземане на решения за агентното предприятие“ (Forrester, 1 юни 2026 г.). Естественият изход на ИИ става платното, а не текстовият блок. За този, който одитира диаграми, това е добра новина: прегледът принадлежи на мястото, където се вижда формата.
Цикълът на преглед: от .mmd към платното и обратно към .mmd
Цикълът има пет стъпки и ключовото му свойство е, че се затваря: в хранилището влиза диаграмата, коригирана в платното, а не оригиналът на агента. Ако поправката остане в екранна снимка или в коментар към pull request, грешният .mmd оцелява и отново храни следващия агент.

- Импортиране. Поставете
.mmd, който ви е дал агентът, във визуално платно или го заредете като файл. Цел: да отделите прегледа от редактора на код, където изкушението е да четете вместо да гледате. - Разпределяне и пренареждане. Разположете възлите на хоризонтални слоеве по отговорност (вход, оркестрация, домейн, съхранение). Почти всички дефекти на посоката и фалшивата дълбочина се издават тук: стрелка, която се изкачва с два слоя, обикновено е обърната стрелка.
- Отбелязване на съмнителното. Всеки възел или конектор, който не можете да потвърдите, като четете кода, се бележи, а бележката носи връзка към доказателството: файла, тикета, ADR. Одитираната диаграма не е такава без съмнения, а такава, в която съмненията са етикетирани и проследими.
- Ръчна поправка. Обединяване на дублираните възли, разделяне на общата кутия на реалните хранилища, добавяне на клона „не“, затваряне с терминатор, смяна на типа форма, така че ромбът да е ромб, а хранилището – цилиндър, и пренасочване на конекторите към правилните точки.
- Експортиране обратно. Изкарване на резултата в
.mmdи замяна на оригиналния файл в хранилището, в същия commit като прегледа. Това е стъпката, която повечето екипи пропускат и която предотвратява повторното въвеждане на грешката.
На практика стъпка 3 превръща всичко това в инженерен процес, а не в сесия по оформление. Странична бележка с връзка към конкретния файл, който доказва, че worker-ът консумира от опашката, е проверяема документация; „мисля, че тази стрелка е обърната“ в нишка в Slack не е.
Контролен списък: 10 проверки преди merge на диаграма, генерирана от ИИ
Затворен списък, предназначен за поставяне в шаблона на pull request. Ако някоя проверка пропадне, диаграмата не влиза.
- Уникалност: нито един реален компонент не се появява като два възела. Един ID на услуга, името от хранилището или от внедряването.
- Пълни решения: всеки ромб има поне два изходящи ръба, с етикети, а клонът на грешката има местоназначение.
- Терминатори: всеки път завършва в изричен краен възел; няма вериги, които прекъсват на стъпка за процес.
- Посока на данните: всяка стрелка върви в посоката, в която пътува информацията, а не в тази на организационната йерархия. Проверете особено опашките, webhook-овете и polling.
- Разделени хранилища: никаква обща кутия от типа „База данни“, „Услуги“ или „Инфраструктура“. Един възел на хранилище с технология и съдържание.
- Реални слоеве: всеки
subgraphсъответства на граница, която съществува (внедряване, хранилище, акаунт, мрежа), а не на учебникарска абстракция. - Речник на домейна: етикетите използват имената, които екипът пише в кода и в тикетите, а не думите от вашия промпт.
- Без сираци и избежими пресичания: никакъв несвързан възел, а оставащите пресичания са обосновани и не се решават с пренареждане.
- Четимост в размера на публикуване: разбира се в ширината на
READMEили на портала за документация, а не само с увеличение. - Проследимост: всеки неочевиден елемент има бележка с връзка към кода, тикета или ADR, който го подкрепя; а
.mmdв хранилището е експортираният след поправката.
Spec-driven development: ако диаграмата е грешна, кодът наследява грешката
Това е причината, поради която одитът престана да бъде козметичен през 2026 г. При разработката, управлявана от спецификация, спецификацията в Markdown – с нейните Mermaid диаграми на архитектурата и последователностите – е артефактът, от който агентът генерира имплементацията, а не коментар върху нея. Неправилна диаграма в такава спецификация вече не е остаряла документация: тя е дефектен вход за генератор на код.
Подходът е описан в самия Spec Kit на GitHub, чиято теза е, че „спецификациите не служат на кода; кодът служи на спецификациите“, а плановете за имплементация, които създава, включват диаграми на архитектурата и последователностите в Mermaid заедно с модела на данните и режимите на отказ.
Преведено в ежедневието: ромб без клон „не“ в спецификацията е, с голяма вероятност, неимплементиран случай на грешка в генерирания код. Обърната стрелка между API и опашка е дизайн push, където сте искали pull. А кутия „База данни“, която прикриваше Postgres, Redis и S3, се превръща в едно-единствено хранилище с три отговорности. Диаграмата от снимка на системата стана част от чертежа, а чертежите се преглеждат.
Често задавани въпроси
Какво означава „Mermaid slop“?
Това е диаграма, генерирана от ИИ, с валиден Mermaid синтаксис, но без комуникативна стойност: общи и еднакви форми, палитра по подразбиране, зле етикетирани стрелки и, в най-лошите случаи, компоненти или връзки, които не съществуват в системата. Терминът се наложи от проекта Diagram Design и е документиран в прегледа на explainX от август 2026 г.
Може ли диаграма Mermaid, генерирана от ИИ, да се валидира автоматично?
Само отчасти. Linter или самият парсер открива синтактични грешки и могат да се автоматизират структурни проверки: възли-сираци, ромбове с един изход, пътища без терминатор или ID с подозрително сходни етикети. Това, което никой инструмент не може да провери сам, е дали диаграмата описва вашата система; това изисква сверяване с кода, и затова контролният списък в тази статия съчетава автоматизируеми проверки с човешки преглед.
Защо не стига да прегледам mermaid блока в pull request?
Защото в diff-а четете ръбовете един по един, а релевантните дефекти са на целия граф: пресичания, обърнати йерархии, цикли, изолирани възли, нечетима гъстота. Освен това, като четете текста, оценявате намерението на автора, а не това, което ще види читателят на визуализацията. Полезният преглед се прави върху нарисуваната диаграма.
Какъв инструмент да използвам, за да поправя на ръка диаграма Mermaid?
Нуждаете се от платно, което да извърши пълното пътуване: импортиране на .mmd, възможност да местите и сменяте форми и конектори, да отбелязвате елементи и да експортирате отново към Mermaid. Тази последна стъпка е това, което повечето визуализатори не могат – те рисуват, но не връщат коригирания код. FlowBoard покрива цикъла: импортира Mermaid от файл или чрез поставяне на кода, разполага диаграмата на безкрайно платно с мащабиране и придвижване, позволява ръчна поправка на форми, конектори и котви с магнетизъм към котвените точки, добавяне на странични бележки с връзки за всеки елемент и експортиране обратно към Mermaid.
Колко време отнема одитът на диаграма, генерирана от ИИ?
Зависи от размера, но редът на големина за диаграма с 15–25 възела е от 20 до 40 минути първия път и значително по-малко, когато екипът вече е усвоил контролния списък и има фиксирани имена на домейна. В сравнение с цената на това една грешна архитектура да попадне в официалната документация – или, при работен процес, управляван от спецификация, в генерирания код – е евтино.
Трябва ли да спрем да използваме ИИ за диаграми?
Не. Генерирането на първата чернова с агент спестява досадната работа по писане на възли и ръбове, а за изследване на непозната система е полезно. Това, което не бива да се пропуска, е следващата стъпка: никоя диаграма, генерирана от ИИ, не се публикува, без да мине през платното и през контролния списък. ИИ прави черновата; отговорността за диаграмата остава на екипа, който я подписва.
Заключение: диаграмата, която публикувате, е тази, която сте одитирали
Промяната през 2026 г. не е, че ИИ рисува диаграми, а че ги рисува по-бързо, отколкото ги преглеждаме. Докато VS Code ги рисува без настройка, Claude ги превръща в табла, а спецификациите в Markdown захранват генератори на код, единственият останал контрол на качеството е човешкият: да погледнете формата, да отбележите това, което не може да се докаже, и да върнете в хранилището коригираната версия. Десет проверки и един цикъл, който се затваря, са достатъчни, за да стане диаграмата отново надеждна документация, а не правдоподобна декорация.
Този цикъл се нуждае от място, където да се случи. В AIsToHire го решаваме с FlowBoard, нашата безкрайна дъска за диаграми: .mmd на агента се поставя или импортира, разполага се на безкрайно платно, пренареждат се форми – правоъгълници, елипси, ромбове за решения, документи, лепящи се бележки и текст – и конектори с прави или ортогонални стрелки, всяка връзка се закотвя с магнетизъм към точките на елементите, съмнителното се отбелязва със странични бележки и връзки за проверка и се експортира обратно към Mermaid. Таблото се запазва само, така че одитът остава записан и може да се продължи.
Отворете FlowBoard, поставете .mmd файла, който ви е дал агентът, и одитирайте диаграмата там, където наистина се вижда: пренаредете по слоеве, поправете форми и конектори на ръка, отбележете съмнителното с връзки за проверка и го експортирайте обратно към Mermaid. Започнете първото си табло безплатно.
Отворете FlowBoard, поставете .mmd файла, който ви е дал агентът, и одитирайте диаграмата там, където наистина се вижда: пренаредете по слоеве, поправете форми и конектори на ръка, отбележете съмнителното с връзки за проверка и го експортирайте обратно към Mermaid. Започнете първото си табло безплатно.Продължете да четете
Всички статии →
Символи на блок-схема: какво означава всеки от тях и как да нарисувате своята стъпка по стъпка

Караница по WhatsApp или разговор на живо: какво казва науката за конфликтите в двойката по съобщения

Ментална карта, концептуална карта и план: разлики и кога да използвате всяка
