FlowBoardMermaid slop: cara meninjau dan memperbaiki diagram buatan AI sebelum dipublikasikan
Tim FlowBoardDitulis dengan bantuan AI13 menit bacaRingkasan:
- "Mermaid slop" adalah nama yang populer pada 2026 untuk diagram buatan AI yang sintaksisnya valid tetapi tidak terbaca atau bahkan keliru; istilah ini berasal dari proyek Diagram Design, yang memperkenalkan diri dengan slogan "no Figma, no generic rounded boxes, no Mermaid-slop" dan sudah melampaui 11.000 bintang di GitHub pada Agustus 2026 (explainX, 16-08-2026).
- Masalahnya membesar bersama distribusi: VS Code 1.121 (20-05-2026) merender Mermaid secara native di pratinjau Markdown, tanpa ekstensi, dan asisten AI membuatnya secara default (Visual Studio Code).
- Sebuah model mengoptimalkan validitas tata bahasa, bukan kebenaran sistem:
.mmdberhasil diurai, tetapi menduplikasi node, melewatkan cabang "tidak" dari sebuah keputusan, atau membalik arah data. - Memeriksa diagram dengan membaca baris
-->tidak berhasil: cacat yang penting bersifat topologis dan hanya terlihat saat digambar. - Siklus yang berhasil: impor
.mmdke kanvas, susun ulang per lapisan, beri catatan pada yang meragukan dengan tautan ke kode atau tiket yang membuktikannya, perbaiki secara manual, dan ekspor kembali agar versi yang sudah diperbaiki yang masuk ke repositori.
Sejak pertengahan 2026, pertanyaan di tim rekayasa bukan lagi bagaimana membuat diagram, melainkan siapa yang bertanggung jawab atasnya. Agen menulis Mermaid secara spontan, GitHub dan VS Code merendernya tanpa konfigurasi, dan hasilnya masuk ke README dengan kewajaran yang sama seperti blok kode. Yang kurang adalah lapisan audit. Artikel ini menelusuri cacat yang khas, alasan teknis kemunculannya, dan siklus tinjauan yang bisa diulang yang berakhir di kanvas visual —dalam kasus kami, FlowBoard, papan tulis tanpa batas untuk diagram dari AIsToHire, yang mengimpor dan mengekspor kembali Mermaid— agar diagram yang dipublikasikan adalah yang sudah diperbaiki, bukan yang pertama kali dimuntahkan model.

Apa sebenarnya "Mermaid slop" itu?
Mermaid slop adalah diagram buatan AI yang dikompilasi tanpa galat namun tetap tidak berguna: kotak bersudut bulat yang identik untuk konsep berbeda, panah tanpa label atau dengan label yang kabur, warna default yang tidak mengatakan apa-apa, dan pembuatan yang refleksif —digambar karena diminta, bukan karena perlu—. Definisinya ditetapkan oleh ulasan explainX tentang istilah ini (16-08-2026), yang menelusurinya hingga proyek Diagram Design karya Cathryn Lavery.
Nuansa pentingnya adalah ada dua lapisan "slop" dan keduanya sering tertukar:
| Lapisan | Yang gagal | Terdeteksi | Biaya memperbaikinya |
|---|---|---|---|
| Estetika | Bentuk generik, palet default, semuanya sama | Sekilas pandang | Rendah: tema, bentuk, pengelompokan |
| Semantik | Diagram menggambarkan sistem yang tidak ada | Hanya dengan membandingkan dengan kode asli | Tinggi: harus membuka kembali repositori |
Percakapan publik 2026 hampir seluruhnya berfokus pada yang pertama. Alat-alat yang muncul —dari skill diagram editorial hingga generator yang menghasilkan elemen Excalidraw native alih-alih teks Mermaid— terutama menyerang tampilan. Lapisan kedua, yang membuat diagram berbohong tentang arsitektur Anda, tetap pekerjaan manusia.
Mengapa LLM menghasilkan Mermaid yang sempurna secara sintaksis tetapi lemah secara semantik?
Karena itu dua tujuan berbeda dan hanya satu yang memiliki sinyal pelatihan melimpah. Tata bahasa Mermaid tertutup, kecil, dan sangat banyak terwakili di GitHub: model mereproduksinya nyaris tanpa gagal. Kebenaran diagram, sebaliknya, bergantung pada sistem tertentu yang biasanya belum dibaca utuh oleh model, sehingga ia mengisi celah dengan bentuk paling umum dari diagram arsitektur, bukan milik Anda.
Ditambah tiga efek praktis:
- Prompt adalah satu-satunya sumber. Jika Anda menjelaskan sistem dalam tiga kalimat, agen mengembalikan diagram dengan granularitas tiga kalimat lalu menghiasnya sampai tampak lengkap. Seperti yang diringkas Mermaid sendiri saat membahas vibe diagramming, "diagram yang dihasilkan dari prompt yang kabur akan mencerminkan kekaburan prompt itu" (Mermaid, 24-03-2026).
- Tidak ada kompiler semantik. Tes yang merah memberi tahu Anda; diagram yang salah dirender sama indahnya dengan yang benar. Tidak ada padanan
tscuntuk "layanan ini tidak ada". - Tata letak ditentukan mesin, bukan penulis. Mermaid menempatkan node dengan algoritmanya dan tidak menawarkan cara mudah untuk memperbaiki tata letak setelah dirender. Jika hierarki sebenarnya tidak cocok dengan yang digambar auto-layout, Anda kalah berdebat dengan alatnya.
Dan konteks industri mengatakan verifikasi bukan pilihan. Survei pengembang 2026 dari Stack Overflow (terbit 06-10-2026, lebih dari 30.000 jawaban di 169 negara) menemukan bahwa hampir separuh mempercayai keluaran AI hanya ketika dapat memverifikasinya dengan mudah, dan hanya 6,6% yang menganggapnya layak untuk keputusan penting. Diagram arsitektur dalam dokumentasi resmi, hampir menurut definisinya, adalah keputusan penting.
Tujuh cacat berulang pada diagram buatan AI
Inilah tujuh yang muncul berulang kali saat mengaudit .mmd buatan agen. Semuanya berhasil diurai; semuanya salah. Pola umumnya adalah model mengisi struktur yang masuk akal di tempat ia kekurangan informasi domain.

| # | Cacat | Gejala di .mmd | Akibat |
|---|---|---|---|
| 1 | Node duplikat | Dua ID berbeda dengan label mirip untuk layanan yang sama | Tampak ada dua komponen padahal hanya satu |
| 2 | Keputusan tanpa cabang "tidak" | Belah ketupat dengan satu sisi keluar | Jalur galat tidak terdokumentasi |
| 3 | Alur tanpa terminator | Rantai yang berakhir di node proses | Tidak diketahui kapan kasus penggunaan selesai |
| 4 | Arah terbalik | Panah menunjuk ke asal data | Terbalik siapa yang memanggil siapa |
| 5 | Kotak generik | Satu node "Basis data" | Menyembunyikan tiga penyimpanan dengan jaminan berbeda |
| 6 | Kedalaman palsu | Lapisan atau subgraph yang tidak ada di kode | Memberi wibawa pada arsitektur rekaan |
| 7 | Label dari prompt | Node mengulang kata-kata Anda, bukan kosakata domain | Diagram tidak bisa dicari dan tidak dikenali |
1. Node duplikat yang sebenarnya layanan yang sama
Model melihat "auth" dan "layanan autentikasi" di dua kalimat berbeda lalu membuat dua node.
flowchart LR
API[API Gateway] --> AUTH[Auth]
API --> AUTHSVC[Layanan autentikasi]
AUTH --> DB[(Basis data)]
AUTHSVC --> DB
Diperbaiki: satu node, satu ID, nama yang dipakai tim.
flowchart LR
API[API Gateway] --> AUTH[auth-service]
AUTH --> USERS[(postgres: users)]
2. Keputusan tanpa cabang "tidak"
flowchart TD
REQ[Permintaan] --> Q{Token valid?}
Q -->|Ya| OK[Proses]
Belah ketupat dengan satu jalur keluar bukan keputusan: itu hiasan. Setiap kondisi membutuhkan dua jalurnya dan jalur galat membutuhkan tujuan.
flowchart TD
REQ[Permintaan] --> Q{Token valid?}
Q -->|ya| OK[Proses]
Q -->|tidak| R401[Balas 401]
OK --> FIN([Selesai])
R401 --> FIN
3. Panah yang membalik arah data
Klasik pada antrean dan webhook: model menggambar hierarki organisasi, bukan alur sebenarnya.
flowchart LR
WORKER[Worker] --> QUEUE[Antrean pekerjaan]
Worker tidak mendorong ke antrean: ia mengonsumsi darinya. Menggambar arah ini dengan salah mengubah desain pull menjadi push, yang merupakan sistem lain dengan jaminan lain.
flowchart LR
API[API] -->|masukkan antrean| QUEUE[Antrean pekerjaan]
QUEUE -->|konsumsi| WORKER[Worker]
4. Kotak generik "Basis data"
Ini cacat yang paling mahal, karena yang hilang adalah persis informasi yang dicari orang saat membuka diagram. Node [(Basis data)] yang sebenarnya adalah Postgres untuk transaksi, Redis untuk sesi, dan S3 untuk lampiran tidak mendokumentasikan: ia menyembunyikan. Aturan praktisnya: jika dua penyimpanan memiliki jaminan durabilitas berbeda, itu dua node.
5, 6, dan 7: lapisan rekaan dan label pinjaman
subgraph bernama "Lapisan presentasi", "Lapisan bisnis", dan "Lapisan data" biasanya templat mental model, bukan struktur repositori Anda. Begitu pula label: jika node bernama "modul pemrosesan pembayaran" dan di kode namanya billing-worker, tidak ada yang bisa mencocokkan diagram dengan proyek. Dan jika terminatornya tidak ada, pembaca tidak tahu apakah alurnya berakhir di situ atau modelnya berhenti di tengah jalan.
Mengapa meninjau diagram dalam bentuk teks tidak berhasil?
Karena cacat yang penting bersifat topologis dan teks tidak memperlihatkannya. Dengan membaca daftar baris A --> B Anda bisa memverifikasi bahwa setiap sisi masuk akal satu per satu, tetapi Anda tidak akan melihat bahwa dua panah bersilangan, bahwa sebuah node yatim, bahwa hierarkinya terbalik, atau bahwa ada siklus tiga lompatan. Sifat-sifat itu hanya terlihat ketika grafnya digambar dan ditempatkan.

Ada alasan kedua yang lebih halus: saat membaca .mmd Anda memeriksa apa yang ditulis penulis; saat melihat hasil render Anda memeriksa apa yang akan dipahami pembaca. Keduanya berbeda. Diagram dengan lima belas sisi yang benar dan auto-layout yang menumpuknya secara teknis benar tetapi secara komunikasi rusak, dan itulah persis yang disetujui peninjau pull request tanpa melihat karena "blok mermaid-nya terbentuk dengan baik".
Industri sendiri telah bergerak ke arah itu. Anthropic meluncurkan Claude Whiteboards dalam versi beta pada 10-11-2026: kanvas waktu nyata tempat asisten mengubah diskusi menjadi papan, mengelompokkan catatan per topik, dan memungkinkan membawanya ke Lucid, Miro, atau Vani dari Zoho (unite.ai). Dan Miro, dalam acara Canvas 26, menyatakan bahwa mereka sudah "tidak berbisnis papan tulis" dan ingin menjadi "lapisan pengambilan keputusan kolaboratif untuk perusahaan agentik" (Forrester, 01-06-2026). Keluaran alami AI sedang menjadi kanvas, bukan blok teks. Bagi yang mengaudit diagram, ini kabar baik: tinjauan berada di tempat bentuknya terlihat.
Siklus tinjauan: dari .mmd ke kanvas dan kembali ke .mmd
Siklus ini punya lima langkah dan sifat kuncinya adalah ia menutup: yang masuk ke repositori adalah diagram yang sudah diperbaiki di kanvas, bukan yang asli dari agen. Jika perbaikan berhenti di tangkapan layar atau di komentar pull request, .mmd yang keliru tetap bertahan dan kembali memberi masukan ke agen berikutnya.

- Impor. Tempel
.mmdyang diberikan agen ke kanvas visual, atau muat sebagai berkas. Tujuan: memisahkan tinjauan dari editor kode, tempat godaannya adalah membaca alih-alih melihat. - Sebarkan dan susun ulang. Tempatkan node dalam lapisan horizontal menurut tanggung jawab (masukan, orkestrasi, domain, penyimpanan). Hampir semua cacat arah dan kedalaman palsu terbongkar di sini: panah yang naik dua lapisan biasanya panah yang terbalik.
- Tandai yang meragukan. Setiap node atau konektor yang tidak bisa Anda pastikan dengan membaca kode diberi catatan, dan catatan itu membawa tautan ke buktinya: berkas, tiket, ADR. Diagram yang diaudit bukanlah yang tanpa keraguan, melainkan yang keraguannya diberi label dan dilacak.
- Perbaiki secara manual. Menyatukan node duplikat, memecah kotak generik menjadi penyimpanan sebenarnya, menambah cabang "tidak", menutup dengan terminator, mengganti jenis bentuk agar belah ketupat menjadi belah ketupat dan penyimpanan menjadi silinder, serta mengaitkan ulang konektor ke titik yang tepat.
- Ekspor kembali. Keluarkan hasilnya ke
.mmddan gantikan berkas asli di repositori, dalam commit yang sama dengan tinjauannya. Itulah langkah yang dilewati kebanyakan tim dan yang mencegah galat masuk kembali.
Dalam praktiknya, langkah 3 adalah yang mengubah ini menjadi proses rekayasa dan bukan sesi penataan. Catatan samping dengan tautan ke berkas tertentu yang membuktikan bahwa worker mengonsumsi dari antrean adalah dokumentasi yang dapat diverifikasi; "kayaknya panah ini terbalik" di utas Slack bukan.
Daftar periksa: 10 pemeriksaan sebelum merge diagram buatan AI
Daftar tertutup, dirancang untuk ditempel di templat pull request. Jika ada yang gagal, diagram tidak masuk.
- Keunikan: tidak ada komponen nyata yang muncul sebagai dua node. Satu ID per layanan, nama repositori atau penerapannya.
- Keputusan lengkap: setiap belah ketupat punya setidaknya dua sisi keluar, berlabel, dan cabang galat punya tujuan.
- Terminator: setiap jalur berakhir di node terminal yang eksplisit; tidak ada rantai yang terputus di langkah proses.
- Arah data: setiap panah mengikuti arah perjalanan informasi, bukan arah hierarki organisasi. Periksa terutama antrean, webhook, dan polling.
- Penyimpanan terurai: tidak ada kotak generik seperti "Basis data", "Layanan", atau "Infrastruktur". Satu node per penyimpanan dengan teknologi dan isinya.
- Lapisan nyata: setiap
subgraphsesuai dengan batas yang ada (penerapan, repositori, akun, jaringan), bukan abstraksi buku teks. - Kosakata domain: label memakai nama yang ditulis tim di kode dan tiket, bukan kata-kata dari prompt Anda.
- Tanpa yatim dan silang yang bisa dihindari: tidak ada node terputus, dan persilangan yang tersisa dapat dibenarkan dan tidak bisa diperbaiki dengan menyusun ulang.
- Terbaca pada ukuran saat dipublikasikan: dipahami pada lebar
READMEatau portal dokumentasi, bukan hanya dengan zoom. - Keterlacakan: setiap elemen yang tidak jelas punya catatan dengan tautan ke kode, tiket, atau ADR yang mendukungnya; dan
.mmddi repositori adalah hasil ekspor setelah perbaikan.
Spec-driven development: jika diagramnya salah, kodenya mewarisi galat
Inilah alasan audit berhenti menjadi kosmetik pada 2026. Dalam pengembangan berbasis spesifikasi, spesifikasi dalam Markdown —dengan diagram Mermaid arsitektur dan urutannya— adalah artefak yang menjadi sumber agen membuat implementasi, bukan komentar tentangnya. Diagram yang salah di dalam spesifikasi itu bukan lagi dokumentasi usang: ia masukan yang cacat pada generator kode.
Pendekatannya tercantum di Spec Kit milik GitHub sendiri, yang tesisnya adalah bahwa "spesifikasi tidak melayani kode; kodelah yang melayani spesifikasi", dan rencana implementasi yang dihasilkannya memuat diagram arsitektur dan urutan dalam Mermaid di samping model data dan mode kegagalan.
Diterjemahkan ke keseharian: belah ketupat tanpa cabang "tidak" dalam spesifikasi, dengan kemungkinan besar, adalah kasus galat yang tidak diimplementasikan dalam kode yang dihasilkan. Panah terbalik antara API dan antrean adalah desain push di tempat yang Anda inginkan pull. Dan kotak "Basis data" yang menutupi Postgres, Redis, dan S3 menjadi satu repositori dengan tiga tanggung jawab. Diagram berubah dari foto sistem menjadi bagian dari cetak biru, dan cetak biru ditinjau.
Pertanyaan yang sering diajukan
Apa arti "Mermaid slop"?
Diagram buatan AI dengan sintaksis Mermaid yang valid tetapi tanpa nilai komunikatif: bentuk generik dan identik, palet default, panah yang salah label, dan dalam kasus terburuk, komponen atau hubungan yang tidak ada dalam sistem. Istilah ini dipopulerkan dari proyek Diagram Design dan didokumentasikan oleh ulasan explainX pada Agustus 2026.
Bisakah diagram Mermaid buatan AI divalidasi secara otomatis?
Hanya sebagian. Linter atau parser itu sendiri mendeteksi galat sintaksis, dan pemeriksaan struktural bisa diotomatisasi: node yatim, belah ketupat dengan satu sisi keluar, jalur tanpa terminator, atau ID dengan label yang mencurigakan mirip. Yang tidak bisa diverifikasi alat mana pun sendirian adalah apakah diagram menggambarkan sistem Anda; itu menuntut pencocokan dengan kode, dan karena itu daftar periksa di artikel ini memadukan pemeriksaan yang bisa diotomatisasi dengan tinjauan manusia.
Mengapa tidak cukup meninjau blok mermaid di pull request?
Karena di diff Anda membaca sisi satu per satu sedangkan cacat yang relevan ada pada grafnya secara utuh: persilangan, hierarki terbalik, siklus, node terisolasi, kepadatan yang tidak terbaca. Selain itu, dengan membaca teks Anda menilai maksud penulis dan bukan apa yang akan dilihat pembaca hasil render. Tinjauan yang berguna dilakukan pada diagram yang digambar.
Alat apa yang saya pakai untuk memperbaiki diagram Mermaid secara manual?
Anda memerlukan kanvas yang menempuh perjalanan penuh: mengimpor .mmd, membiarkan Anda memindahkan dan mengubah bentuk serta konektor, memberi catatan pada elemen, dan mengekspor lagi ke Mermaid. Langkah terakhir itulah yang dibuang kebanyakan penampil, yang merender tetapi tidak mengembalikan kode yang sudah diperbaiki. FlowBoard mencakup siklusnya: mengimpor Mermaid dari berkas atau dengan menempel kode, menyebarkan diagram di kanvas tanpa batas dengan zoom dan geser, memungkinkan memperbaiki bentuk, konektor, dan jangkar secara manual dengan magnet ke titik jangkar, menambahkan catatan samping dengan tautan per elemen, dan mengekspor kembali ke Mermaid.
Berapa lama mengaudit diagram buatan AI?
Tergantung ukurannya, tetapi orde besarannya untuk diagram 15-25 node adalah 20 sampai 40 menit pada kali pertama, dan jauh lebih sedikit ketika tim sudah menginternalisasi daftar periksa dan nama-nama domain sudah ditetapkan. Dibandingkan dengan biaya arsitektur yang salah masuk ke dokumentasi resmi —atau, dalam alur berbasis spesifikasi, ke kode yang dihasilkan—, ini murah.
Haruskah berhenti memakai AI untuk membuat diagram?
Tidak. Membuat draf pertama dengan agen menghemat pekerjaan membosankan mengetik node dan sisi, dan berguna untuk menjelajahi sistem yang belum dikenal. Yang tidak boleh dilewati adalah langkah berikutnya: tidak ada diagram buatan AI yang dipublikasikan tanpa melewati kanvas dan daftar periksa. AI membuat draf; tanggung jawab atas diagram tetap pada tim yang menandatanganinya.
Penutup: diagram yang Anda publikasikan adalah yang sudah Anda audit
Perubahan 2026 bukan bahwa AI menggambar diagram, melainkan bahwa ia menggambarnya lebih cepat daripada kita meninjaunya. Selama VS Code merendernya tanpa konfigurasi, Claude mengubahnya menjadi papan, dan spesifikasi dalam Markdown memberi masukan pada generator kode, satu-satunya kendali mutu yang tersisa adalah manusia: melihat bentuknya, menandai yang tidak bisa dibuktikan, dan mengembalikan versi yang sudah diperbaiki ke repositori. Sepuluh pemeriksaan dan satu siklus yang menutup sudah cukup agar diagram kembali menjadi dokumentasi yang andal, bukan dekorasi yang meyakinkan.
Siklus itu membutuhkan tempat untuk berlangsung. Di AIsToHire kami menyelesaikannya dengan FlowBoard, papan tulis tanpa batas kami untuk diagram: .mmd dari agen ditempel atau diimpor, disebar di kanvas tanpa batas, bentuk —persegi panjang, elips, belah ketupat keputusan, dokumen, catatan tempel, dan teks— dan konektor dengan panah lurus atau ortogonal ditata ulang, setiap sambungan dikaitkan dengan magnet ke titik elemen, yang meragukan diberi catatan samping dan tautan verifikasi, lalu diekspor kembali ke Mermaid. Papan tersimpan sendiri, sehingga auditnya tercatat dan bisa dilanjutkan.
Buka FlowBoard, tempel .mmd yang diberikan agen, dan audit diagramnya di tempat yang benar-benar terlihat: susun ulang per lapisan, perbaiki bentuk dan konektor secara manual, beri catatan pada yang meragukan dengan tautan verifikasi, dan ekspor kembali ke Mermaid. Mulai papan pertama Anda gratis.
Buka FlowBoard, tempel .mmd yang diberikan agen, dan audit diagramnya di tempat yang benar-benar terlihat: susun ulang per lapisan, perbaiki bentuk dan konektor secara manual, beri catatan pada yang meragukan dengan tautan verifikasi, dan ekspor kembali ke Mermaid. Mulai papan pertama Anda gratis.Lanjutkan membaca
Lihat semua artikel →
Simbol Diagram Alur: Arti Setiap Simbol dan Cara Menggambar Diagram Anda Langkah demi Langkah

Bertengkar lewat WhatsApp atau bicara langsung: apa kata ilmu pengetahuan tentang konflik pasangan lewat pesan

Peta pikiran, peta konsep, dan kerangka: perbedaan dan kapan memakai masing-masing
