Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

Add v3.0 Mermaid validation experiment (5 diagrams × 3 versions)

tt-a1ibd93647ef6f2
diff --git a/experiments/v3-mermaid-validation/INDEX.md b/experiments/v3-mermaid-validation/INDEX.md
new file mode 100644
index 00000000..a699e7ca
--- /dev/null
+++ b/experiments/v3-mermaid-validation/INDEX.md
@@ -0,0 +1,37 @@
+# v3.0 Mermaid → Archify Validation — Source Diagrams
+
+5 real-world Mermaid `flowchart` diagrams used as test inputs for the v3.0 visual-quality validation experiment described in `../../ROADMAP.md` (section: Validation experiment).
+
+All diagrams were verified present in their source repositories on **2026-04-16**.
+
+| # | Category | Source | Nodes | Direction | Notes |
+|---|---|---|---:|---|---|
+| 1 | Mermaid official canonical | [mermaid-js/mermaid `flowchart.md`](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/docs/syntax/flowchart.md) | 5 | TD | Decision-loop example from official syntax docs (substituted for the 4-node `examples.md` showcase to meet the ≥5-node floor) |
+| 2 | Kubernetes | [kubernetes/website `observability.md`](https://github.com/kubernetes/website/blob/main/content/en/docs/concepts/cluster-administration/observability.md) | 9 | LR | k8s log aggregation pipeline; uses subgraph for source grouping |
+| 3 | Microservices | [GStones/moke-kit `README.md`](https://github.com/GStones/moke-kit/blob/main/README.md) | 12 | TD | Go game-server toolkit; 5 layered subgraphs; ships with embedded `classDef` colors that we strip for fair comparison |
+| 4 | CI/CD pipeline | [HaroonKhanDotNet/hivenue-cicd `BRD.md`](https://github.com/HaroonKhanDotNet/hivenue-cicd/blob/main/BRD.md) | 10 | TD | Real Hivenue platform pipeline; includes decision diamonds and `<br>` multi-line labels |
+| 5 | 3-tier web app | [broadinstitute/taiga `arch.md`](https://github.com/broadinstitute/taiga/blob/afb4840/arch.md) | 10 | TD | Broad Institute scientific data platform; 4 subgraphs (Client / App / Storage / External) |
+
+## Diversity self-check
+
+- **Node range**: 5 / 9 / 10 / 10 / 12 (small to medium)
+- **Direction**: 4× TD + 1× LR
+- **Complexity coverage**: plain (#1), subgraph (#2 #3 #5), decision diamonds (#4), embedded `classDef` styling (#3), multi-line `<br>` labels (#4)
+
+## Output structure
+
+```
+sources/ — raw .mmd files (this directory's siblings)
+output-A-stock/ — version (A): stock mmdc with default theme
+output-B-themed/— version (B): mmdc with archify-style themeCSS injected
+output-C-archify/ — version (C): hand-ported to archify HTML
+screenshots/ — randomized & deduplicated 15-image set for blind rating
+RESULT.md — rating tables + decision record
+```
+
+## Caveats flagged for transparency
+
+1. **Diagram 1** is from the syntax docs page, not the canonical `examples.md` showcase — that one's only 4 nodes which falls below our 5-node floor. The 5-node decision-loop is the closest "official representative" example.
+2. **Diagram 2** is a *log pipeline* not a *deployment topology* — the original ask was "k8s deployment", but the kubernetes/website repo's most-prominent flowchart is this observability one. Still a real, in-use, k8s-official diagram.
+3. **Diagram 4** is from a relatively unknown personal repo (HaroonKhanDotNet/hivenue-cicd) rather than a canonical CI/CD example like GitHub Actions docs. It is, however, a real CI/CD diagram for a real product, which is what the experiment requires.
+4. **Diagram 3's embedded `classDef`** — for fair comparison across A/B/C, version A and B will be rendered both with and without the embedded styling (so we can see whether moke-kit's hand-tuned colors already meet the bar before archify gets involved).
diff --git a/experiments/v3-mermaid-validation/RESULT.md b/experiments/v3-mermaid-validation/RESULT.md
new file mode 100644
index 00000000..d757df7a
--- /dev/null
+++ b/experiments/v3-mermaid-validation/RESULT.md
@@ -0,0 +1,92 @@
+# v3.0 Mermaid Validation — Results
+
+> **Purpose:** Verify the core hypothesis: "Mermaid input + Claude layout + archify CSS" produces diagrams rated significantly better than stock Mermaid. See `../../ROADMAP.md` for the experiment design.
+
+## Versions
+
+| Code | What it is |
+|---|---|
+| **A** | Stock Mermaid via `mmdc` — default theme, dagre layout, no customization |
+| **B** | Mermaid via `mmdc` + archify-style themeCSS — same dagre layout, archify color palette / font / background |
+| **C** | Hand-placed archify HTML — Claude-assigned semantic classes + hand-placed coordinates + archify CSS |
+
+## How to blind-rate
+
+1. Open each file in `screenshots/` (img-01 through img-15) — they're randomized, labels stripped
+2. Rate each 1–10 for visual quality
+3. After all 15, open `screenshots/manifest.txt` to de-anonymize
+4. Fill in the tables below
+
+## Self-evaluation (project owner)
+
+> Fill this in first. If B clearly doesn't meet the bar, skip the 5-engineer panel.
+
+| Image | Score (1–10) | Notes |
+|---|---|---|
+| img-01-k0di | | |
+| img-02-heh1 | | |
+| img-03-w085 | | |
+| img-04-12c2 | | |
+| img-05-n1tw | | |
+| img-06-hkrq | | |
+| img-07-43uu | | |
+| img-08-weo4 | | |
+| img-09-gzi9 | | |
+| img-10-rnix | | |
+| img-11-2cre | | |
+| img-12-nlmi | | |
+| img-13-5mj4 | | |
+| img-14-plhu | | |
+| img-15-05g2 | | |
+
+### De-anonymized summary (fill after rating)
+
+| Diagram | A score | B score | C score | B closer to C or A? |
+|---|---|---|---|---|
+| 1 (Mermaid canonical) | | | | |
+| 2 (K8s log pipeline) | | | | |
+| 3 (moke-kit microservices) | | | | |
+| 4 (Hivenue CI/CD) | | | | |
+| 5 (Taiga 3-tier) | | | | |
+
+**B average:** ___
+**B closer to C in ___ / 5 diagrams**
+
+## Pass criterion (from ROADMAP.md)
+
+- [ ] B averages ≥ 7/10
+- [ ] B is rated closer to C than to A in at least 4 of 5 diagrams
+
+## Decision
+
+- [ ] **PASS** → Proceed with v3.0 Mermaid-aware architecture (P0 → P3)
+- [ ] **FAIL** → v3.0 collapses to "JSON IR for stable iteration only"; Mermaid input becomes a SKILL.md prompt trick, not a parser
+
+### Notes
+
+_Write decision rationale here after evaluation._
+
+---
+
+## External panel (optional, only if self-eval passes)
+
+### Rater 1: ___
+
+| Image | Score (1–10) |
+|---|---|
+| img-01 through img-15 | |
+
+_(repeat for Raters 2–5)_
+
+### Aggregate
+
+| Diagram | A avg | B avg | C avg | B closer to? |
+|---|---|---|---|---|
+| 1 | | | | |
+| 2 | | | | |
+| 3 | | | | |
+| 4 | | | | |
+| 5 | | | | |
+
+**Panel B average:** ___
+**Panel B closer to C in ___ / 5 diagrams**
diff --git a/experiments/v3-mermaid-validation/output-A-stock/1.png b/experiments/v3-mermaid-validation/output-A-stock/1.png
new file mode 100644
index 00000000..7a153467
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-A-stock/1.png differ
diff --git a/experiments/v3-mermaid-validation/output-A-stock/2.png b/experiments/v3-mermaid-validation/output-A-stock/2.png
new file mode 100644
index 00000000..f8e25624
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-A-stock/2.png differ
diff --git a/experiments/v3-mermaid-validation/output-A-stock/3.png b/experiments/v3-mermaid-validation/output-A-stock/3.png
new file mode 100644
index 00000000..ca635a3c
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-A-stock/3.png differ
diff --git a/experiments/v3-mermaid-validation/output-A-stock/4.png b/experiments/v3-mermaid-validation/output-A-stock/4.png
new file mode 100644
index 00000000..d9ae1b53
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-A-stock/4.png differ
diff --git a/experiments/v3-mermaid-validation/output-A-stock/5.png b/experiments/v3-mermaid-validation/output-A-stock/5.png
new file mode 100644
index 00000000..d0317f8f
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-A-stock/5.png differ
diff --git a/experiments/v3-mermaid-validation/output-B-themed/1.png b/experiments/v3-mermaid-validation/output-B-themed/1.png
new file mode 100644
index 00000000..5f12383b
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-B-themed/1.png differ
diff --git a/experiments/v3-mermaid-validation/output-B-themed/2.png b/experiments/v3-mermaid-validation/output-B-themed/2.png
new file mode 100644
index 00000000..161093ff
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-B-themed/2.png differ
diff --git a/experiments/v3-mermaid-validation/output-B-themed/3.png b/experiments/v3-mermaid-validation/output-B-themed/3.png
new file mode 100644
index 00000000..06a9673c
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-B-themed/3.png differ
diff --git a/experiments/v3-mermaid-validation/output-B-themed/4.png b/experiments/v3-mermaid-validation/output-B-themed/4.png
new file mode 100644
index 00000000..28e99b8f
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-B-themed/4.png differ
diff --git a/experiments/v3-mermaid-validation/output-B-themed/5.png b/experiments/v3-mermaid-validation/output-B-themed/5.png
new file mode 100644
index 00000000..13fe5283
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-B-themed/5.png differ
diff --git a/experiments/v3-mermaid-validation/output-C-archify/1.html b/experiments/v3-mermaid-validation/output-C-archify/1.html
new file mode 100644
index 00000000..c2e08a58
--- /dev/null
+++ b/experiments/v3-mermaid-validation/output-C-archify/1.html
@@ -0,0 +1,119 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+<head>
+<meta charset="UTF-8">
+<title>Decision Loop — Archify</title>
+<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+<style>
+:root {
+ --bg:#020617; --grid:#1e293b; --text:#fff; --text-muted:#94a3b8; --text-dim:#475569;
+ --panel:rgba(15,23,42,0.5); --panel-border:#1e293b;
+ --arrow:#64748b; --arrow-emphasis:#34d399; --mask:#0f172a;
+ --frontend-fill:rgba(8,51,68,0.4); --frontend-stroke:#22d3ee;
+ --backend-fill:rgba(6,78,59,0.4); --backend-stroke:#34d399;
+ --database-fill:rgba(76,29,149,0.4); --database-stroke:#a78bfa;
+ --cloud-fill:rgba(120,53,15,0.3); --cloud-stroke:#fbbf24;
+ --security-fill:rgba(136,19,55,0.4); --security-stroke:#fb7185;
+ --messagebus-fill:rgba(251,146,60,0.3); --messagebus-stroke:#fb923c;
+ --external-fill:rgba(30,41,59,0.5); --external-stroke:#94a3b8;
+}
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:'JetBrains Mono',ui-monospace,Menlo,monospace;background:var(--bg);min-height:100vh;padding:2rem;color:var(--text)}
+.container{max-width:1400px;margin:0 auto}
+.header{margin-bottom:2rem}
+.header-row{display:flex;align-items:center;gap:1rem;margin-bottom:.5rem}
+.pulse-dot{width:12px;height:12px;background:var(--frontend-stroke);border-radius:50%;animation:pulse 2s infinite}
+@keyframes pulse{0%,100%{opacity:1}50%{opacity:.5}}
+h1{font-size:1.5rem;font-weight:700;letter-spacing:-.025em}
+.subtitle{color:var(--text-muted);font-size:.875rem;margin-left:1.75rem}
+.diagram-container{background:var(--panel);border-radius:1rem;border:1px solid var(--panel-border);padding:1.5rem;overflow-x:auto}
+svg{width:100%;display:block}
+.c-grid{stroke:var(--grid);fill:none}
+.c-mask{fill:var(--mask);stroke:none}
+.c-frontend{fill:var(--frontend-fill);stroke:var(--frontend-stroke)}
+.c-backend{fill:var(--backend-fill);stroke:var(--backend-stroke)}
+.c-database{fill:var(--database-fill);stroke:var(--database-stroke)}
+.c-cloud{fill:var(--cloud-fill);stroke:var(--cloud-stroke)}
+.c-security{fill:var(--security-fill);stroke:var(--security-stroke)}
+.c-messagebus{fill:var(--messagebus-fill);stroke:var(--messagebus-stroke)}
+.c-external{fill:var(--external-fill);stroke:var(--external-stroke)}
+.t-primary{fill:var(--text)}.t-muted{fill:var(--text-muted)}.t-dim{fill:var(--text-dim)}
+.t-frontend{fill:var(--frontend-stroke)}.t-backend{fill:var(--backend-stroke)}
+.t-database{fill:var(--database-stroke)}.t-cloud{fill:var(--cloud-stroke)}
+.t-security{fill:var(--security-stroke)}.t-messagebus{fill:var(--messagebus-stroke)}
+.t-external{fill:var(--external-stroke)}
+.a-default{stroke:var(--arrow);fill:none}.a-emphasis{stroke:var(--arrow-emphasis);fill:none}
+.a-security{stroke:var(--security-stroke);fill:none;stroke-dasharray:5,5}
+.a-dashed{stroke:var(--database-stroke);fill:none;stroke-dasharray:4,4}
+.m-default{fill:var(--arrow)}.m-emphasis{fill:var(--arrow-emphasis)}
+.m-security{fill:var(--security-stroke)}.m-dashed{fill:var(--database-stroke)}
+.c-security-group{fill:transparent;stroke:var(--security-stroke);stroke-dasharray:4,4}
+</style>
+</head>
+<body>
+<div class="container">
+ <div class="header">
+ <div class="header-row"><div class="pulse-dot"></div><h1>Decision Loop</h1></div>
+ <p class="subtitle">Conditional flow with retry path</p>
+ </div>
+ <div class="diagram-container">
+ <svg viewBox="0 0 900 620" xmlns="http://www.w3.org/2000/svg">
+ <defs>
+ <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-default"/></marker>
+ <marker id="arrowhead-emphasis" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-emphasis"/></marker>
+ <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse"><path d="M 40 0 L 0 0 0 40" class="c-grid" stroke-width="0.5"/></pattern>
+ </defs>
+ <rect width="100%" height="100%" fill="url(#grid)"/>
+
+ <!-- Start -->
+ <rect x="380" y="50" width="140" height="56" rx="6" class="c-mask"/>
+ <rect x="380" y="50" width="140" height="56" rx="6" class="c-external" stroke-width="1.5"/>
+ <text x="450" y="76" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Start</text>
+ <text x="450" y="93" class="t-muted" font-size="9" text-anchor="middle">entry point</text>
+
+ <!-- Is it? — diamond decision -->
+ <polygon points="450,170 590,240 450,310 310,240" class="c-mask"/>
+ <polygon points="450,170 590,240 450,310 310,240" class="c-backend" stroke-width="1.5"/>
+ <text x="450" y="237" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Is it?</text>
+ <text x="450" y="254" class="t-muted" font-size="9" text-anchor="middle">decision</text>
+
+ <!-- OK -->
+ <rect x="80" y="350" width="140" height="56" rx="6" class="c-mask"/>
+ <rect x="80" y="350" width="140" height="56" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="150" y="376" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">OK</text>
+ <text x="150" y="393" class="t-muted" font-size="9" text-anchor="middle">accept branch</text>
+
+ <!-- Rethink -->
+ <rect x="80" y="470" width="140" height="56" rx="6" class="c-mask"/>
+ <rect x="80" y="470" width="140" height="56" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="150" y="496" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Rethink</text>
+ <text x="150" y="513" class="t-muted" font-size="9" text-anchor="middle">retry</text>
+
+ <!-- End -->
+ <rect x="680" y="350" width="140" height="56" rx="6" class="c-mask"/>
+ <rect x="680" y="350" width="140" height="56" rx="6" class="c-external" stroke-width="1.5"/>
+ <text x="750" y="376" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">End</text>
+ <text x="750" y="393" class="t-muted" font-size="9" text-anchor="middle">terminal</text>
+
+ <!-- Start -> Is it? -->
+ <line x1="450" y1="106" x2="450" y2="166" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+
+ <!-- Is it? -> OK (Yes) -->
+ <path d="M 310 240 Q 250 240 220 290 L 180 348" class="a-emphasis" stroke-width="1.5" marker-end="url(#arrowhead-emphasis)"/>
+ <text x="225" y="285" class="t-backend" font-size="10" font-weight="600">Yes</text>
+
+ <!-- OK -> Rethink -->
+ <line x1="150" y1="406" x2="150" y2="467" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+
+ <!-- Rethink -> Is it? (loop back) -->
+ <path d="M 220 498 Q 280 498 280 410 Q 280 330 360 280" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" stroke-dasharray="4,3"/>
+ <text x="305" y="450" class="t-muted" font-size="9">loop</text>
+
+ <!-- Is it? -> End (No) -->
+ <path d="M 590 240 Q 650 240 680 290 L 720 348" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <text x="675" y="285" class="t-muted" font-size="10" font-weight="600">No</text>
+ </svg>
+ </div>
+</div>
+</body>
+</html>
diff --git a/experiments/v3-mermaid-validation/output-C-archify/1.png b/experiments/v3-mermaid-validation/output-C-archify/1.png
new file mode 100644
index 00000000..cb74b6f5
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-C-archify/1.png differ
diff --git a/experiments/v3-mermaid-validation/output-C-archify/2.html b/experiments/v3-mermaid-validation/output-C-archify/2.html
new file mode 100644
index 00000000..2df86cef
--- /dev/null
+++ b/experiments/v3-mermaid-validation/output-C-archify/2.html
@@ -0,0 +1,134 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+<head>
+<meta charset="UTF-8">
+<title>K8s Log Pipeline — Archify</title>
+<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+<style>
+:root {
+ --bg:#020617; --grid:#1e293b; --text:#fff; --text-muted:#94a3b8; --text-dim:#475569;
+ --panel:rgba(15,23,42,0.5); --panel-border:#1e293b;
+ --arrow:#64748b; --arrow-emphasis:#34d399; --mask:#0f172a;
+ --frontend-fill:rgba(8,51,68,0.4); --frontend-stroke:#22d3ee;
+ --backend-fill:rgba(6,78,59,0.4); --backend-stroke:#34d399;
+ --database-fill:rgba(76,29,149,0.4); --database-stroke:#a78bfa;
+ --cloud-fill:rgba(120,53,15,0.3); --cloud-stroke:#fbbf24;
+ --security-fill:rgba(136,19,55,0.4); --security-stroke:#fb7185;
+ --messagebus-fill:rgba(251,146,60,0.3); --messagebus-stroke:#fb923c;
+ --external-fill:rgba(30,41,59,0.5); --external-stroke:#94a3b8;
+}
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:'JetBrains Mono',ui-monospace,Menlo,monospace;background:var(--bg);min-height:100vh;padding:2rem;color:var(--text)}
+.container{max-width:1400px;margin:0 auto}
+.header{margin-bottom:2rem}
+.header-row{display:flex;align-items:center;gap:1rem;margin-bottom:.5rem}
+.pulse-dot{width:12px;height:12px;background:var(--frontend-stroke);border-radius:50%;animation:pulse 2s infinite}
+@keyframes pulse{0%,100%{opacity:1}50%{opacity:.5}}
+h1{font-size:1.5rem;font-weight:700;letter-spacing:-.025em}
+.subtitle{color:var(--text-muted);font-size:.875rem;margin-left:1.75rem}
+.diagram-container{background:var(--panel);border-radius:1rem;border:1px solid var(--panel-border);padding:1.5rem;overflow-x:auto}
+svg{width:100%;display:block}
+.c-grid{stroke:var(--grid);fill:none}
+.c-mask{fill:var(--mask);stroke:none}
+.c-frontend{fill:var(--frontend-fill);stroke:var(--frontend-stroke)}
+.c-backend{fill:var(--backend-fill);stroke:var(--backend-stroke)}
+.c-database{fill:var(--database-fill);stroke:var(--database-stroke)}
+.c-cloud{fill:var(--cloud-fill);stroke:var(--cloud-stroke)}
+.c-security{fill:var(--security-fill);stroke:var(--security-stroke)}
+.c-messagebus{fill:var(--messagebus-fill);stroke:var(--messagebus-stroke)}
+.c-external{fill:var(--external-fill);stroke:var(--external-stroke)}
+.t-primary{fill:var(--text)}.t-muted{fill:var(--text-muted)}.t-dim{fill:var(--text-dim)}
+.t-frontend{fill:var(--frontend-stroke)}.t-backend{fill:var(--backend-stroke)}
+.t-database{fill:var(--database-stroke)}.t-cloud{fill:var(--cloud-stroke)}
+.t-security{fill:var(--security-stroke)}.t-messagebus{fill:var(--messagebus-stroke)}
+.t-external{fill:var(--external-stroke)}
+.a-default{stroke:var(--arrow);fill:none}.a-emphasis{stroke:var(--arrow-emphasis);fill:none}
+.a-security{stroke:var(--security-stroke);fill:none;stroke-dasharray:5,5}
+.m-default{fill:var(--arrow)}.m-emphasis{fill:var(--arrow-emphasis)}
+.m-security{fill:var(--security-stroke)}
+.c-region{fill:rgba(251,191,36,0.05);stroke:var(--cloud-stroke);stroke-dasharray:8,4}
+</style>
+</head>
+<body>
+<div class="container">
+ <div class="header">
+ <div class="header-row"><div class="pulse-dot"></div><h1>Kubernetes Log Pipeline</h1></div>
+ <p class="subtitle">Cluster log aggregation through node agent into central store</p>
+ </div>
+ <div class="diagram-container">
+ <svg viewBox="0 0 1300 540" xmlns="http://www.w3.org/2000/svg">
+ <defs>
+ <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-default"/></marker>
+ <marker id="arrowhead-emphasis" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-emphasis"/></marker>
+ <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse"><path d="M 40 0 L 0 0 0 40" class="c-grid" stroke-width="0.5"/></pattern>
+ </defs>
+ <rect width="100%" height="100%" fill="url(#grid)"/>
+
+ <!-- Sources cluster boundary -->
+ <rect x="40" y="60" width="260" height="430" rx="12" class="c-region" stroke-width="1"/>
+ <text x="52" y="84" class="t-cloud" font-size="11" font-weight="600">Sources</text>
+
+ <!-- Source 1: stdout/stderr -->
+ <rect x="60" y="110" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="60" y="110" width="220" height="64" rx="6" class="c-external" stroke-width="1.5"/>
+ <text x="170" y="138" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">Application</text>
+ <text x="170" y="156" class="t-muted" font-size="9" text-anchor="middle">stdout / stderr</text>
+
+ <!-- Source 2: Control plane logs -->
+ <rect x="60" y="240" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="60" y="240" width="220" height="64" rx="6" class="c-external" stroke-width="1.5"/>
+ <text x="170" y="268" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">Control Plane</text>
+ <text x="170" y="286" class="t-muted" font-size="9" text-anchor="middle">component logs</text>
+
+ <!-- Source 3: Audit records -->
+ <rect x="60" y="370" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="60" y="370" width="220" height="64" rx="6" class="c-security" stroke-width="1.5"/>
+ <text x="170" y="398" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">Audit Records</text>
+ <text x="170" y="416" class="t-muted" font-size="9" text-anchor="middle">k8s API audit</text>
+
+ <!-- Node log agent -->
+ <rect x="450" y="240" width="200" height="64" rx="6" class="c-mask"/>
+ <rect x="450" y="240" width="200" height="64" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="550" y="268" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">Node Log Agent</text>
+ <text x="550" y="286" class="t-muted" font-size="9" text-anchor="middle">DaemonSet · per-node</text>
+
+ <!-- Central log store -->
+ <rect x="800" y="240" width="200" height="64" rx="6" class="c-mask"/>
+ <rect x="800" y="240" width="200" height="64" rx="6" class="c-database" stroke-width="1.5"/>
+ <text x="900" y="268" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">Central Log Store</text>
+ <text x="900" y="286" class="t-muted" font-size="9" text-anchor="middle">Loki / ES / etc.</text>
+
+ <!-- Dashboards / SIEM -->
+ <rect x="1110" y="170" width="170" height="64" rx="6" class="c-mask"/>
+ <rect x="1110" y="170" width="170" height="64" rx="6" class="c-frontend" stroke-width="1.5"/>
+ <text x="1195" y="198" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">Dashboards</text>
+ <text x="1195" y="216" class="t-muted" font-size="9" text-anchor="middle">Grafana</text>
+
+ <rect x="1110" y="260" width="170" height="64" rx="6" class="c-mask"/>
+ <rect x="1110" y="260" width="170" height="64" rx="6" class="c-cloud" stroke-width="1.5"/>
+ <text x="1195" y="288" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">Alerting</text>
+ <text x="1195" y="306" class="t-muted" font-size="9" text-anchor="middle">PagerDuty</text>
+
+ <rect x="1110" y="350" width="170" height="64" rx="6" class="c-mask"/>
+ <rect x="1110" y="350" width="170" height="64" rx="6" class="c-security" stroke-width="1.5"/>
+ <text x="1195" y="378" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">SIEM</text>
+ <text x="1195" y="396" class="t-muted" font-size="9" text-anchor="middle">audit + security</text>
+
+ <!-- Arrows: 3 sources -> agent -->
+ <path d="M 280 142 Q 360 142 380 200 L 446 252" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <line x1="280" y1="272" x2="446" y2="272" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <path d="M 280 402 Q 360 402 380 340 L 446 295" class="a-security" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+
+ <!-- agent -> store -->
+ <line x1="650" y1="272" x2="796" y2="272" class="a-emphasis" stroke-width="2" marker-end="url(#arrowhead-emphasis)"/>
+ <text x="723" y="262" class="t-backend" font-size="10" text-anchor="middle">push</text>
+
+ <!-- store -> 3 consumers -->
+ <path d="M 1000 268 Q 1055 268 1080 220 L 1106 200" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <line x1="1000" y1="290" x2="1106" y2="290" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <path d="M 1000 295 Q 1055 295 1080 340 L 1106 380" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ </svg>
+ </div>
+</div>
+</body>
+</html>
diff --git a/experiments/v3-mermaid-validation/output-C-archify/2.png b/experiments/v3-mermaid-validation/output-C-archify/2.png
new file mode 100644
index 00000000..46b8d4e7
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-C-archify/2.png differ
diff --git a/experiments/v3-mermaid-validation/output-C-archify/3.html b/experiments/v3-mermaid-validation/output-C-archify/3.html
new file mode 100644
index 00000000..e3cb07c7
--- /dev/null
+++ b/experiments/v3-mermaid-validation/output-C-archify/3.html
@@ -0,0 +1,174 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+<head>
+<meta charset="UTF-8">
+<title>moke-kit — Archify</title>
+<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+<style>
+:root {
+ --bg:#020617; --grid:#1e293b; --text:#fff; --text-muted:#94a3b8; --text-dim:#475569;
+ --panel:rgba(15,23,42,0.5); --panel-border:#1e293b;
+ --arrow:#64748b; --arrow-emphasis:#34d399; --mask:#0f172a;
+ --frontend-fill:rgba(8,51,68,0.4); --frontend-stroke:#22d3ee;
+ --backend-fill:rgba(6,78,59,0.4); --backend-stroke:#34d399;
+ --database-fill:rgba(76,29,149,0.4); --database-stroke:#a78bfa;
+ --cloud-fill:rgba(120,53,15,0.3); --cloud-stroke:#fbbf24;
+ --security-fill:rgba(136,19,55,0.4); --security-stroke:#fb7185;
+ --messagebus-fill:rgba(251,146,60,0.3); --messagebus-stroke:#fb923c;
+ --external-fill:rgba(30,41,59,0.5); --external-stroke:#94a3b8;
+}
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:'JetBrains Mono',ui-monospace,Menlo,monospace;background:var(--bg);min-height:100vh;padding:2rem;color:var(--text)}
+.container{max-width:1500px;margin:0 auto}
+.header{margin-bottom:2rem}
+.header-row{display:flex;align-items:center;gap:1rem;margin-bottom:.5rem}
+.pulse-dot{width:12px;height:12px;background:var(--backend-stroke);border-radius:50%;animation:pulse 2s infinite}
+@keyframes pulse{0%,100%{opacity:1}50%{opacity:.5}}
+h1{font-size:1.5rem;font-weight:700;letter-spacing:-.025em}
+.subtitle{color:var(--text-muted);font-size:.875rem;margin-left:1.75rem}
+.diagram-container{background:var(--panel);border-radius:1rem;border:1px solid var(--panel-border);padding:1.5rem;overflow-x:auto}
+svg{width:100%;display:block}
+.c-grid{stroke:var(--grid);fill:none}
+.c-mask{fill:var(--mask);stroke:none}
+.c-frontend{fill:var(--frontend-fill);stroke:var(--frontend-stroke)}
+.c-backend{fill:var(--backend-fill);stroke:var(--backend-stroke)}
+.c-database{fill:var(--database-fill);stroke:var(--database-stroke)}
+.c-cloud{fill:var(--cloud-fill);stroke:var(--cloud-stroke)}
+.c-security{fill:var(--security-fill);stroke:var(--security-stroke)}
+.c-messagebus{fill:var(--messagebus-fill);stroke:var(--messagebus-stroke)}
+.c-external{fill:var(--external-fill);stroke:var(--external-stroke)}
+.t-primary{fill:var(--text)}.t-muted{fill:var(--text-muted)}.t-dim{fill:var(--text-dim)}
+.t-frontend{fill:var(--frontend-stroke)}.t-backend{fill:var(--backend-stroke)}
+.t-database{fill:var(--database-stroke)}.t-cloud{fill:var(--cloud-stroke)}
+.t-security{fill:var(--security-stroke)}.t-messagebus{fill:var(--messagebus-stroke)}
+.t-external{fill:var(--external-stroke)}
+.a-default{stroke:var(--arrow);fill:none}.a-emphasis{stroke:var(--arrow-emphasis);fill:none}
+.a-security{stroke:var(--security-stroke);fill:none;stroke-dasharray:5,5}
+.m-default{fill:var(--arrow)}.m-emphasis{fill:var(--arrow-emphasis)}
+.m-security{fill:var(--security-stroke)}
+.c-region{fill:rgba(255,255,255,0.02);stroke:#334155;stroke-dasharray:6,4}
+.layer-label{fill:var(--text-dim);font-size:10px;font-weight:600;text-transform:uppercase;letter-spacing:0.08em}
+</style>
+</head>
+<body>
+<div class="container">
+ <div class="header">
+ <div class="header-row"><div class="pulse-dot"></div><h1>moke-kit</h1></div>
+ <p class="subtitle">Go game-server toolkit — layered server / middleware / storage architecture</p>
+ </div>
+ <div class="diagram-container">
+ <svg viewBox="0 0 1400 880" xmlns="http://www.w3.org/2000/svg">
+ <defs>
+ <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-default"/></marker>
+ <marker id="arrowhead-emphasis" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-emphasis"/></marker>
+ <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse"><path d="M 40 0 L 0 0 0 40" class="c-grid" stroke-width="0.5"/></pattern>
+ </defs>
+ <rect width="100%" height="100%" fill="url(#grid)"/>
+
+ <!-- Layer labels -->
+ <text x="40" y="80" class="layer-label">Application</text>
+ <text x="40" y="220" class="layer-label">Servers</text>
+ <text x="40" y="400" class="layer-label">Middleware</text>
+ <text x="40" y="580" class="layer-label">Storage &amp; Queue</text>
+ <text x="40" y="780" class="layer-label">Integrations</text>
+
+ <!-- Application Layer -->
+ <rect x="600" y="60" width="200" height="70" rx="6" class="c-mask"/>
+ <rect x="600" y="60" width="200" height="70" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="700" y="89" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">App &amp; DI</text>
+ <text x="700" y="108" class="t-muted" font-size="9" text-anchor="middle">fxmain · uber/fx</text>
+
+ <!-- Server Layer (3 servers) -->
+ <rect x="280" y="200" width="200" height="70" rx="6" class="c-mask"/>
+ <rect x="280" y="200" width="200" height="70" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="380" y="229" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">gRPC Server</text>
+ <text x="380" y="248" class="t-muted" font-size="9" text-anchor="middle">RPC services</text>
+
+ <rect x="600" y="200" width="200" height="70" rx="6" class="c-mask"/>
+ <rect x="600" y="200" width="200" height="70" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="700" y="229" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">HTTP Gateway</text>
+ <text x="700" y="248" class="t-muted" font-size="9" text-anchor="middle">REST · gRPC-gateway</text>
+
+ <rect x="920" y="200" width="240" height="70" rx="6" class="c-mask"/>
+ <rect x="920" y="200" width="240" height="70" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="1040" y="229" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">TCP/WS/KCP Server</text>
+ <text x="1040" y="248" class="t-muted" font-size="9" text-anchor="middle">zinx · realtime games</text>
+
+ <!-- Middleware Layer (2) -->
+ <rect x="380" y="380" width="220" height="70" rx="6" class="c-mask"/>
+ <rect x="380" y="380" width="220" height="70" rx="6" class="c-security" stroke-width="1.5"/>
+ <text x="490" y="409" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Auth Middleware</text>
+ <text x="490" y="428" class="t-muted" font-size="9" text-anchor="middle">Firebase Auth</text>
+
+ <rect x="780" y="380" width="320" height="70" rx="6" class="c-mask"/>
+ <rect x="780" y="380" width="320" height="70" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="940" y="405" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Other Middlewares</text>
+ <text x="940" y="424" class="t-muted" font-size="9" text-anchor="middle">Logging · RateLimit · Recovery · OTel</text>
+
+ <!-- Storage Layer (4) -->
+ <rect x="180" y="560" width="200" height="70" rx="6" class="c-mask"/>
+ <rect x="180" y="560" width="200" height="70" rx="6" class="c-database" stroke-width="1.5"/>
+ <text x="280" y="589" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Relational DB</text>
+ <text x="280" y="608" class="t-muted" font-size="9" text-anchor="middle">GORM</text>
+
+ <rect x="430" y="560" width="200" height="70" rx="6" class="c-mask"/>
+ <rect x="430" y="560" width="200" height="70" rx="6" class="c-database" stroke-width="1.5"/>
+ <text x="530" y="589" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">NoSQL DB</text>
+ <text x="530" y="608" class="t-muted" font-size="9" text-anchor="middle">MongoDB</text>
+
+ <rect x="680" y="560" width="200" height="70" rx="6" class="c-mask"/>
+ <rect x="680" y="560" width="200" height="70" rx="6" class="c-database" stroke-width="1.5"/>
+ <text x="780" y="589" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Cache</text>
+ <text x="780" y="608" class="t-muted" font-size="9" text-anchor="middle">Redis · Dragonfly</text>
+
+ <rect x="930" y="560" width="200" height="70" rx="6" class="c-mask"/>
+ <rect x="930" y="560" width="200" height="70" rx="6" class="c-messagebus" stroke-width="1.5"/>
+ <text x="1030" y="589" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Message Queue</text>
+ <text x="1030" y="608" class="t-muted" font-size="9" text-anchor="middle">NATS</text>
+
+ <!-- Integration Layer (2) -->
+ <rect x="430" y="760" width="220" height="70" rx="6" class="c-mask"/>
+ <rect x="430" y="760" width="220" height="70" rx="6" class="c-external" stroke-width="1.5"/>
+ <text x="540" y="789" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">IAP Integration</text>
+ <text x="540" y="808" class="t-muted" font-size="9" text-anchor="middle">App Store · Play Store</text>
+
+ <rect x="780" y="760" width="220" height="70" rx="6" class="c-mask"/>
+ <rect x="780" y="760" width="220" height="70" rx="6" class="c-external" stroke-width="1.5"/>
+ <text x="890" y="789" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Agones</text>
+ <text x="890" y="808" class="t-muted" font-size="9" text-anchor="middle">k8s game-server orchestration</text>
+
+ <!-- App -> 3 servers -->
+ <line x1="660" y1="130" x2="430" y2="198" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <line x1="700" y1="130" x2="700" y2="198" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <line x1="740" y1="130" x2="980" y2="198" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <text x="700" y="170" class="t-muted" font-size="9" text-anchor="middle">initializes</text>
+
+ <!-- 3 servers -> auth (left) -->
+ <path d="M 380 270 Q 380 320 420 378" class="a-security" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <line x1="600" y1="270" x2="500" y2="378" class="a-security" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <path d="M 1000 270 Q 800 290 580 378" class="a-security" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+
+ <!-- 3 servers -> stdmw (right) -->
+ <path d="M 480 270 Q 700 290 870 378" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <line x1="800" y1="270" x2="900" y2="378" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <path d="M 1040 270 Q 1040 320 990 378" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+
+ <!-- middleware -> storage (bundled visual) -->
+ <path d="M 460 450 Q 380 510 290 558" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <path d="M 480 450 Q 510 510 530 558" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <path d="M 540 450 Q 660 510 770 558" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <path d="M 580 450 Q 800 510 1010 558" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+
+ <path d="M 820 450 Q 600 510 320 558" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.5"/>
+ <path d="M 870 450 Q 720 510 560 558" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.5"/>
+ <path d="M 940 450 Q 880 510 800 558" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.5"/>
+ <path d="M 990 450 Q 1010 510 1030 558" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.5"/>
+
+ <!-- middleware -> integrations -->
+ <path d="M 480 450 Q 480 600 530 758" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.6"/>
+ <path d="M 510 450 Q 700 600 870 758" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.6"/>
+ </svg>
+ </div>
+</div>
+</body>
+</html>
diff --git a/experiments/v3-mermaid-validation/output-C-archify/3.png b/experiments/v3-mermaid-validation/output-C-archify/3.png
new file mode 100644
index 00000000..cd94466f
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-C-archify/3.png differ
diff --git a/experiments/v3-mermaid-validation/output-C-archify/4.html b/experiments/v3-mermaid-validation/output-C-archify/4.html
new file mode 100644
index 00000000..9410c13b
--- /dev/null
+++ b/experiments/v3-mermaid-validation/output-C-archify/4.html
@@ -0,0 +1,166 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+<head>
+<meta charset="UTF-8">
+<title>Hivenue CI/CD — Archify</title>
+<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+<style>
+:root {
+ --bg:#020617; --grid:#1e293b; --text:#fff; --text-muted:#94a3b8; --text-dim:#475569;
+ --panel:rgba(15,23,42,0.5); --panel-border:#1e293b;
+ --arrow:#64748b; --arrow-emphasis:#34d399; --mask:#0f172a;
+ --frontend-fill:rgba(8,51,68,0.4); --frontend-stroke:#22d3ee;
+ --backend-fill:rgba(6,78,59,0.4); --backend-stroke:#34d399;
+ --database-fill:rgba(76,29,149,0.4); --database-stroke:#a78bfa;
+ --cloud-fill:rgba(120,53,15,0.3); --cloud-stroke:#fbbf24;
+ --security-fill:rgba(136,19,55,0.4); --security-stroke:#fb7185;
+ --messagebus-fill:rgba(251,146,60,0.3); --messagebus-stroke:#fb923c;
+ --external-fill:rgba(30,41,59,0.5); --external-stroke:#94a3b8;
+}
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:'JetBrains Mono',ui-monospace,Menlo,monospace;background:var(--bg);min-height:100vh;padding:2rem;color:var(--text)}
+.container{max-width:1400px;margin:0 auto}
+.header{margin-bottom:2rem}
+.header-row{display:flex;align-items:center;gap:1rem;margin-bottom:.5rem}
+.pulse-dot{width:12px;height:12px;background:var(--cloud-stroke);border-radius:50%;animation:pulse 2s infinite}
+@keyframes pulse{0%,100%{opacity:1}50%{opacity:.5}}
+h1{font-size:1.5rem;font-weight:700;letter-spacing:-.025em}
+.subtitle{color:var(--text-muted);font-size:.875rem;margin-left:1.75rem}
+.diagram-container{background:var(--panel);border-radius:1rem;border:1px solid var(--panel-border);padding:1.5rem;overflow-x:auto}
+svg{width:100%;display:block}
+.c-grid{stroke:var(--grid);fill:none}
+.c-mask{fill:var(--mask);stroke:none}
+.c-frontend{fill:var(--frontend-fill);stroke:var(--frontend-stroke)}
+.c-backend{fill:var(--backend-fill);stroke:var(--backend-stroke)}
+.c-database{fill:var(--database-fill);stroke:var(--database-stroke)}
+.c-cloud{fill:var(--cloud-fill);stroke:var(--cloud-stroke)}
+.c-security{fill:var(--security-fill);stroke:var(--security-stroke)}
+.c-messagebus{fill:var(--messagebus-fill);stroke:var(--messagebus-stroke)}
+.c-external{fill:var(--external-fill);stroke:var(--external-stroke)}
+.t-primary{fill:var(--text)}.t-muted{fill:var(--text-muted)}.t-dim{fill:var(--text-dim)}
+.t-frontend{fill:var(--frontend-stroke)}.t-backend{fill:var(--backend-stroke)}
+.t-database{fill:var(--database-stroke)}.t-cloud{fill:var(--cloud-stroke)}
+.t-security{fill:var(--security-stroke)}.t-messagebus{fill:var(--messagebus-stroke)}
+.t-external{fill:var(--external-stroke)}
+.a-default{stroke:var(--arrow);fill:none}.a-emphasis{stroke:var(--arrow-emphasis);fill:none}
+.a-security{stroke:var(--security-stroke);fill:none;stroke-dasharray:5,5}
+.m-default{fill:var(--arrow)}.m-emphasis{fill:var(--arrow-emphasis)}
+.m-security{fill:var(--security-stroke)}
+</style>
+</head>
+<body>
+<div class="container">
+ <div class="header">
+ <div class="header-row"><div class="pulse-dot"></div><h1>Hivenue CI/CD Pipeline</h1></div>
+ <p class="subtitle">Commit → tests → staging → e2e → production, with push-notification gates</p>
+ </div>
+ <div class="diagram-container">
+ <svg viewBox="0 0 1300 920" xmlns="http://www.w3.org/2000/svg">
+ <defs>
+ <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-default"/></marker>
+ <marker id="arrowhead-emphasis" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-emphasis"/></marker>
+ <marker id="arrowhead-security" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-security"/></marker>
+ <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse"><path d="M 40 0 L 0 0 0 40" class="c-grid" stroke-width="0.5"/></pattern>
+ </defs>
+ <rect width="100%" height="100%" fill="url(#grid)"/>
+
+ <!-- A: Dev Environment -->
+ <rect x="500" y="40" width="220" height="74" rx="6" class="c-mask"/>
+ <rect x="500" y="40" width="220" height="74" rx="6" class="c-frontend" stroke-width="1.5"/>
+ <text x="610" y="68" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Hivenue Dev</text>
+ <text x="610" y="86" class="t-muted" font-size="9" text-anchor="middle">development environment</text>
+ <text x="610" y="102" class="t-frontend" font-size="8" text-anchor="middle">developer machine</text>
+
+ <!-- B: Develop Branch -->
+ <rect x="500" y="180" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="500" y="180" width="220" height="64" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="610" y="208" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">develop branch</text>
+ <text x="610" y="226" class="t-muted" font-size="9" text-anchor="middle">git push origin develop</text>
+
+ <!-- C: Unit Test (decision) -->
+ <polygon points="610,300 800,365 610,430 420,365" class="c-mask"/>
+ <polygon points="610,300 800,365 610,430 420,365" class="c-backend" stroke-width="1.5"/>
+ <text x="610" y="358" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">Unit Test</text>
+ <text x="610" y="375" class="t-muted" font-size="9" text-anchor="middle">jest · istanbul</text>
+
+ <!-- D: CI Fail -->
+ <rect x="100" y="335" width="200" height="60" rx="6" class="c-mask"/>
+ <rect x="100" y="335" width="200" height="60" rx="6" class="c-security" stroke-width="1.5"/>
+ <text x="200" y="362" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">CI Fail</text>
+ <text x="200" y="378" class="t-muted" font-size="9" text-anchor="middle">push notification</text>
+
+ <!-- E: CI Pass -->
+ <rect x="500" y="490" width="220" height="60" rx="6" class="c-mask"/>
+ <rect x="500" y="490" width="220" height="60" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="610" y="517" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">CI Pass</text>
+ <text x="610" y="533" class="t-muted" font-size="9" text-anchor="middle">push notification</text>
+
+ <!-- F: e2e/UAT (decision) -->
+ <polygon points="610,610 800,675 610,740 420,675" class="c-mask"/>
+ <polygon points="610,610 800,675 610,740 420,675" class="c-backend" stroke-width="1.5"/>
+ <text x="610" y="668" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">e2e / UAT</text>
+ <text x="610" y="685" class="t-muted" font-size="9" text-anchor="middle">Playwright</text>
+
+ <!-- G: CD Fail -->
+ <rect x="100" y="645" width="200" height="60" rx="6" class="c-mask"/>
+ <rect x="100" y="645" width="200" height="60" rx="6" class="c-security" stroke-width="1.5"/>
+ <text x="200" y="672" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">CD Fail</text>
+ <text x="200" y="688" class="t-muted" font-size="9" text-anchor="middle">push notification</text>
+
+ <!-- H: CD Pass (decision) -->
+ <polygon points="970,610 1150,675 970,740 790,675" class="c-mask"/>
+ <polygon points="970,610 1150,675 970,740 790,675" class="c-cloud" stroke-width="1.5"/>
+ <text x="970" y="670" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">CD Pass</text>
+ <text x="970" y="687" class="t-muted" font-size="9" text-anchor="middle">deployment gate</text>
+
+ <!-- I: Production Release -->
+ <rect x="860" y="800" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="860" y="800" width="220" height="64" rx="6" class="c-cloud" stroke-width="1.5"/>
+ <text x="970" y="828" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Production Release</text>
+ <text x="970" y="846" class="t-muted" font-size="9" text-anchor="middle">DigitalOcean</text>
+
+ <!-- J: Deployment Success -->
+ <rect x="500" y="800" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="500" y="800" width="220" height="64" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="610" y="828" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Deployment OK</text>
+ <text x="610" y="846" class="t-muted" font-size="9" text-anchor="middle">push notification</text>
+
+ <!-- arrows -->
+ <line x1="610" y1="114" x2="610" y2="178" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <text x="625" y="150" class="t-muted" font-size="9">code commit</text>
+
+ <line x1="610" y1="244" x2="610" y2="298" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <text x="625" y="275" class="t-muted" font-size="9">build</text>
+
+ <!-- C -> D (Fail) -->
+ <path d="M 420 365 Q 360 365 320 365" class="a-security" stroke-width="1.5" marker-end="url(#arrowhead-security)"/>
+ <text x="370" y="355" class="t-security" font-size="10" font-weight="600">Fail</text>
+
+ <!-- C -> E (Pass) -->
+ <path d="M 610 430 L 610 488" class="a-emphasis" stroke-width="1.5" marker-end="url(#arrowhead-emphasis)"/>
+ <text x="625" y="465" class="t-backend" font-size="10" font-weight="600">Pass</text>
+
+ <!-- E -> F -->
+ <line x1="610" y1="550" x2="610" y2="608" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <text x="625" y="582" class="t-muted" font-size="9">staging</text>
+
+ <!-- F -> G (Fail) -->
+ <path d="M 420 675 Q 360 675 320 675" class="a-security" stroke-width="1.5" marker-end="url(#arrowhead-security)"/>
+ <text x="370" y="665" class="t-security" font-size="10" font-weight="600">Fail</text>
+
+ <!-- F -> H (Pass) -->
+ <path d="M 800 675 L 788 675" class="a-emphasis" stroke-width="1.5" marker-end="url(#arrowhead-emphasis)"/>
+ <text x="795" y="665" class="t-backend" font-size="10" font-weight="600" text-anchor="end">Pass</text>
+
+ <!-- H -> I (continuous + approve, two paths bundled visually) -->
+ <path d="M 970 740 L 970 798" class="a-emphasis" stroke-width="2" marker-end="url(#arrowhead-emphasis)"/>
+ <text x="985" y="775" class="t-backend" font-size="9">deploy</text>
+
+ <!-- I -> J -->
+ <line x1="858" y1="832" x2="722" y2="832" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <text x="790" y="822" class="t-muted" font-size="9" text-anchor="middle">notify</text>
+ </svg>
+ </div>
+</div>
+</body>
+</html>
diff --git a/experiments/v3-mermaid-validation/output-C-archify/4.png b/experiments/v3-mermaid-validation/output-C-archify/4.png
new file mode 100644
index 00000000..f47891c1
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-C-archify/4.png differ
diff --git a/experiments/v3-mermaid-validation/output-C-archify/5.html b/experiments/v3-mermaid-validation/output-C-archify/5.html
new file mode 100644
index 00000000..3ce453bc
--- /dev/null
+++ b/experiments/v3-mermaid-validation/output-C-archify/5.html
@@ -0,0 +1,165 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+<head>
+<meta charset="UTF-8">
+<title>Taiga 3-tier — Archify</title>
+<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+<style>
+:root {
+ --bg:#020617; --grid:#1e293b; --text:#fff; --text-muted:#94a3b8; --text-dim:#475569;
+ --panel:rgba(15,23,42,0.5); --panel-border:#1e293b;
+ --arrow:#64748b; --arrow-emphasis:#34d399; --mask:#0f172a;
+ --frontend-fill:rgba(8,51,68,0.4); --frontend-stroke:#22d3ee;
+ --backend-fill:rgba(6,78,59,0.4); --backend-stroke:#34d399;
+ --database-fill:rgba(76,29,149,0.4); --database-stroke:#a78bfa;
+ --cloud-fill:rgba(120,53,15,0.3); --cloud-stroke:#fbbf24;
+ --security-fill:rgba(136,19,55,0.4); --security-stroke:#fb7185;
+ --messagebus-fill:rgba(251,146,60,0.3); --messagebus-stroke:#fb923c;
+ --external-fill:rgba(30,41,59,0.5); --external-stroke:#94a3b8;
+}
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:'JetBrains Mono',ui-monospace,Menlo,monospace;background:var(--bg);min-height:100vh;padding:2rem;color:var(--text)}
+.container{max-width:1400px;margin:0 auto}
+.header{margin-bottom:2rem}
+.header-row{display:flex;align-items:center;gap:1rem;margin-bottom:.5rem}
+.pulse-dot{width:12px;height:12px;background:var(--frontend-stroke);border-radius:50%;animation:pulse 2s infinite}
+@keyframes pulse{0%,100%{opacity:1}50%{opacity:.5}}
+h1{font-size:1.5rem;font-weight:700;letter-spacing:-.025em}
+.subtitle{color:var(--text-muted);font-size:.875rem;margin-left:1.75rem}
+.diagram-container{background:var(--panel);border-radius:1rem;border:1px solid var(--panel-border);padding:1.5rem;overflow-x:auto}
+svg{width:100%;display:block}
+.c-grid{stroke:var(--grid);fill:none}
+.c-mask{fill:var(--mask);stroke:none}
+.c-frontend{fill:var(--frontend-fill);stroke:var(--frontend-stroke)}
+.c-backend{fill:var(--backend-fill);stroke:var(--backend-stroke)}
+.c-database{fill:var(--database-fill);stroke:var(--database-stroke)}
+.c-cloud{fill:var(--cloud-fill);stroke:var(--cloud-stroke)}
+.c-security{fill:var(--security-fill);stroke:var(--security-stroke)}
+.c-messagebus{fill:var(--messagebus-fill);stroke:var(--messagebus-stroke)}
+.c-external{fill:var(--external-fill);stroke:var(--external-stroke)}
+.t-primary{fill:var(--text)}.t-muted{fill:var(--text-muted)}.t-dim{fill:var(--text-dim)}
+.t-frontend{fill:var(--frontend-stroke)}.t-backend{fill:var(--backend-stroke)}
+.t-database{fill:var(--database-stroke)}.t-cloud{fill:var(--cloud-stroke)}
+.t-security{fill:var(--security-stroke)}.t-messagebus{fill:var(--messagebus-stroke)}
+.t-external{fill:var(--external-stroke)}
+.a-default{stroke:var(--arrow);fill:none}.a-emphasis{stroke:var(--arrow-emphasis);fill:none}
+.a-security{stroke:var(--security-stroke);fill:none;stroke-dasharray:5,5}
+.m-default{fill:var(--arrow)}.m-emphasis{fill:var(--arrow-emphasis)}
+.m-security{fill:var(--security-stroke)}
+.tier-label{fill:var(--text-dim);font-size:10px;font-weight:600;text-transform:uppercase;letter-spacing:0.08em}
+</style>
+</head>
+<body>
+<div class="container">
+ <div class="header">
+ <div class="header-row"><div class="pulse-dot"></div><h1>Taiga — Scientific Data Platform</h1></div>
+ <p class="subtitle">Browser → Flask + Celery + Redis → Postgres + S3 + GCS, with external integrations</p>
+ </div>
+ <div class="diagram-container">
+ <svg viewBox="0 0 1300 760" xmlns="http://www.w3.org/2000/svg">
+ <defs>
+ <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-default"/></marker>
+ <marker id="arrowhead-emphasis" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-emphasis"/></marker>
+ <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse"><path d="M 40 0 L 0 0 0 40" class="c-grid" stroke-width="0.5"/></pattern>
+ </defs>
+ <rect width="100%" height="100%" fill="url(#grid)"/>
+
+ <!-- Tier labels -->
+ <text x="40" y="80" class="tier-label">Client</text>
+ <text x="40" y="240" class="tier-label">Application</text>
+ <text x="40" y="490" class="tier-label">Storage</text>
+ <text x="40" y="690" class="tier-label">External</text>
+
+ <!-- Browser -->
+ <rect x="540" y="60" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="540" y="60" width="220" height="64" rx="6" class="c-frontend" stroke-width="1.5"/>
+ <text x="650" y="88" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Web Browser</text>
+ <text x="650" y="106" class="t-muted" font-size="9" text-anchor="middle">end user</text>
+
+ <!-- Flask API -->
+ <rect x="180" y="220" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="180" y="220" width="220" height="64" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="290" y="248" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Flask API</text>
+ <text x="290" y="266" class="t-muted" font-size="9" text-anchor="middle">HTTP / signed-URL gen</text>
+
+ <!-- Redis Queue -->
+ <rect x="540" y="220" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="540" y="220" width="220" height="64" rx="6" class="c-messagebus" stroke-width="1.5"/>
+ <text x="650" y="248" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Redis Queue</text>
+ <text x="650" y="266" class="t-muted" font-size="9" text-anchor="middle">task broker</text>
+
+ <!-- Celery Workers -->
+ <rect x="900" y="220" width="220" height="64" rx="6" class="c-mask"/>
+ <rect x="900" y="220" width="220" height="64" rx="6" class="c-backend" stroke-width="1.5"/>
+ <text x="1010" y="248" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Celery Workers</text>
+ <text x="1010" y="266" class="t-muted" font-size="9" text-anchor="middle">async file ops</text>
+
+ <!-- PostgreSQL -->
+ <rect x="120" y="470" width="200" height="64" rx="6" class="c-mask"/>
+ <rect x="120" y="470" width="200" height="64" rx="6" class="c-database" stroke-width="1.5"/>
+ <text x="220" y="498" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">PostgreSQL</text>
+ <text x="220" y="516" class="t-muted" font-size="9" text-anchor="middle">metadata</text>
+
+ <!-- AWS S3 -->
+ <rect x="430" y="470" width="200" height="64" rx="6" class="c-mask"/>
+ <rect x="430" y="470" width="200" height="64" rx="6" class="c-cloud" stroke-width="1.5"/>
+ <text x="530" y="498" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">AWS S3</text>
+ <text x="530" y="516" class="t-muted" font-size="9" text-anchor="middle">object storage</text>
+
+ <!-- GCS -->
+ <rect x="730" y="470" width="200" height="64" rx="6" class="c-mask"/>
+ <rect x="730" y="470" width="200" height="64" rx="6" class="c-cloud" stroke-width="1.5"/>
+ <text x="830" y="498" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Google Cloud Storage</text>
+ <text x="830" y="516" class="t-muted" font-size="9" text-anchor="middle">object storage</text>
+
+ <!-- Figshare (external) -->
+ <rect x="430" y="670" width="200" height="64" rx="6" class="c-mask"/>
+ <rect x="430" y="670" width="200" height="64" rx="6" class="c-external" stroke-width="1.5"/>
+ <text x="530" y="698" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Figshare</text>
+ <text x="530" y="716" class="t-muted" font-size="9" text-anchor="middle">publish dataset</text>
+
+ <!-- Email service -->
+ <rect x="730" y="670" width="200" height="64" rx="6" class="c-mask"/>
+ <rect x="730" y="670" width="200" height="64" rx="6" class="c-external" stroke-width="1.5"/>
+ <text x="830" y="698" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Email Service</text>
+ <text x="830" y="716" class="t-muted" font-size="9" text-anchor="middle">notifications</text>
+
+ <!-- Browser -> Flask -->
+ <path d="M 540 90 Q 380 90 290 218" class="a-emphasis" stroke-width="1.5" marker-end="url(#arrowhead-emphasis)"/>
+ <text x="370" y="155" class="t-backend" font-size="10">HTTP / HTTPS</text>
+
+ <!-- Flask -> Postgres -->
+ <line x1="290" y1="284" x2="240" y2="468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <text x="220" y="380" class="t-muted" font-size="9">query</text>
+
+ <!-- Flask -> Redis -->
+ <line x1="400" y1="252" x2="538" y2="252" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <text x="469" y="244" class="t-muted" font-size="9" text-anchor="middle">enqueue</text>
+
+ <!-- Redis -> Celery -->
+ <line x1="760" y1="252" x2="898" y2="252" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+ <text x="829" y="244" class="t-muted" font-size="9" text-anchor="middle">dispatch</text>
+
+ <!-- Celery -> S3 -->
+ <path d="M 950 284 Q 800 350 580 468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+
+ <!-- Celery -> GCS -->
+ <line x1="990" y1="284" x2="850" y2="468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+
+ <!-- Celery -> Figshare -->
+ <path d="M 980 284 Q 760 470 580 668" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.7"/>
+
+ <!-- Celery -> Email -->
+ <path d="M 1020 284 Q 920 480 850 668" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.7"/>
+
+ <!-- Flask -> S3 (signed URL) -->
+ <path d="M 380 280 Q 440 380 500 468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" stroke-dasharray="4,3" opacity="0.6"/>
+ <text x="475" y="380" class="t-muted" font-size="8">signed URL</text>
+
+ <!-- Flask -> GCS (signed URL) -->
+ <path d="M 400 280 Q 600 380 800 468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" stroke-dasharray="4,3" opacity="0.4"/>
+ </svg>
+ </div>
+</div>
+</body>
+</html>
diff --git a/experiments/v3-mermaid-validation/output-C-archify/5.png b/experiments/v3-mermaid-validation/output-C-archify/5.png
new file mode 100644
index 00000000..b45930e0
Binary files /dev/null and b/experiments/v3-mermaid-validation/output-C-archify/5.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-01-k0di.png b/experiments/v3-mermaid-validation/screenshots/img-01-k0di.png
new file mode 100644
index 00000000..28e99b8f
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-01-k0di.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-02-heh1.png b/experiments/v3-mermaid-validation/screenshots/img-02-heh1.png
new file mode 100644
index 00000000..d9ae1b53
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-02-heh1.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-03-w085.png b/experiments/v3-mermaid-validation/screenshots/img-03-w085.png
new file mode 100644
index 00000000..13fe5283
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-03-w085.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-04-12c2.png b/experiments/v3-mermaid-validation/screenshots/img-04-12c2.png
new file mode 100644
index 00000000..cb74b6f5
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-04-12c2.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-05-n1tw.png b/experiments/v3-mermaid-validation/screenshots/img-05-n1tw.png
new file mode 100644
index 00000000..cd94466f
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-05-n1tw.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-06-hkrq.png b/experiments/v3-mermaid-validation/screenshots/img-06-hkrq.png
new file mode 100644
index 00000000..ca635a3c
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-06-hkrq.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-07-43uu.png b/experiments/v3-mermaid-validation/screenshots/img-07-43uu.png
new file mode 100644
index 00000000..5f12383b
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-07-43uu.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-08-weo4.png b/experiments/v3-mermaid-validation/screenshots/img-08-weo4.png
new file mode 100644
index 00000000..7a153467
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-08-weo4.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-09-gzi9.png b/experiments/v3-mermaid-validation/screenshots/img-09-gzi9.png
new file mode 100644
index 00000000..b45930e0
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-09-gzi9.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-10-rnix.png b/experiments/v3-mermaid-validation/screenshots/img-10-rnix.png
new file mode 100644
index 00000000..06a9673c
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-10-rnix.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-11-2cre.png b/experiments/v3-mermaid-validation/screenshots/img-11-2cre.png
new file mode 100644
index 00000000..f47891c1
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-11-2cre.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-12-nlmi.png b/experiments/v3-mermaid-validation/screenshots/img-12-nlmi.png
new file mode 100644
index 00000000..161093ff
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-12-nlmi.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-13-5mj4.png b/experiments/v3-mermaid-validation/screenshots/img-13-5mj4.png
new file mode 100644
index 00000000..f8e25624
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-13-5mj4.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-14-plhu.png b/experiments/v3-mermaid-validation/screenshots/img-14-plhu.png
new file mode 100644
index 00000000..d0317f8f
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-14-plhu.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/img-15-05g2.png b/experiments/v3-mermaid-validation/screenshots/img-15-05g2.png
new file mode 100644
index 00000000..46b8d4e7
Binary files /dev/null and b/experiments/v3-mermaid-validation/screenshots/img-15-05g2.png differ
diff --git a/experiments/v3-mermaid-validation/screenshots/manifest.txt b/experiments/v3-mermaid-validation/screenshots/manifest.txt
new file mode 100644
index 00000000..1bd2e403
--- /dev/null
+++ b/experiments/v3-mermaid-validation/screenshots/manifest.txt
@@ -0,0 +1,18 @@
+# Manifest: randomized filename → (diagram, version)
+# Generated 2026-04-16T02:07:47Z
+
+img-01-k0di.png → diagram=4 version=B
+img-02-heh1.png → diagram=4 version=A
+img-03-w085.png → diagram=5 version=B
+img-04-12c2.png → diagram=1 version=C
+img-05-n1tw.png → diagram=3 version=C
+img-06-hkrq.png → diagram=3 version=A
+img-07-43uu.png → diagram=1 version=B
+img-08-weo4.png → diagram=1 version=A
+img-09-gzi9.png → diagram=5 version=C
+img-10-rnix.png → diagram=3 version=B
+img-11-2cre.png → diagram=4 version=C
+img-12-nlmi.png → diagram=2 version=B
+img-13-5mj4.png → diagram=2 version=A
+img-14-plhu.png → diagram=5 version=A
+img-15-05g2.png → diagram=2 version=C
diff --git a/experiments/v3-mermaid-validation/sources/1-mermaid-canonical.mmd b/experiments/v3-mermaid-validation/sources/1-mermaid-canonical.mmd
new file mode 100644
index 00000000..3e165810
--- /dev/null
+++ b/experiments/v3-mermaid-validation/sources/1-mermaid-canonical.mmd
@@ -0,0 +1,6 @@
+flowchart TD
+ A[Start] --> B{Is it?}
+ B -->|Yes| C[OK]
+ C --> D[Rethink]
+ D --> B
+ B ---->|No| E[End]
diff --git a/experiments/v3-mermaid-validation/sources/2-k8s-observability.mmd b/experiments/v3-mermaid-validation/sources/2-k8s-observability.mmd
new file mode 100644
index 00000000..07cd81b4
--- /dev/null
+++ b/experiments/v3-mermaid-validation/sources/2-k8s-observability.mmd
@@ -0,0 +1,11 @@
+flowchart LR
+ subgraph Sources
+ A[Application stdout / stderr]
+ B[Control plane logs]
+ C[Audit records]
+ end
+ A --> N[Node log agent]
+ B --> N
+ C --> N
+ N --> L[Central log store]
+ L --> Q[Dashboards, alerting, SIEM]
diff --git a/experiments/v3-mermaid-validation/sources/3-moke-kit-stripped.mmd b/experiments/v3-mermaid-validation/sources/3-moke-kit-stripped.mmd
new file mode 100644
index 00000000..47c55c21
--- /dev/null
+++ b/experiments/v3-mermaid-validation/sources/3-moke-kit-stripped.mmd
@@ -0,0 +1,57 @@
+flowchart TD
+%% Application Layer
+ subgraph "Application Layer"
+ app["App & DI (fxmain)"]
+ end
+
+%% Server Layer
+ subgraph "Server Layer"
+ grpc["gRPC Server"]
+ gateway["HTTP Gateway"]
+ zinx["TCP/WebSocket/KCP Server (zinx)"]
+ end
+
+%% Middleware Layer
+ subgraph "Middleware Layer"
+ auth["Auth Middleware"]
+ stdmw["Other Middlewares (Logging,RateLimit,Recovery,OTel)"]
+ end
+
+%% Storage & Message Queue Layer
+ subgraph "Storage & Message Queue Layer"
+ gorm["Relational DB (GORM)"]
+ mongo["NoSQL DB (MongoDB)"]
+ cache["Cache (Redis & Dragonfly)"]
+ nats["Message Queue (NATS)"]
+ end
+
+%% Integration Layer
+ subgraph "Integration Layer"
+ iap["IAP Integration"]
+ agones["Agones Integration"]
+ end
+
+ app -->|"initializes"| grpc
+ app -->|"initializes"| gateway
+ app -->|"initializes"| zinx
+
+ grpc -->|"processed by"| auth
+ grpc -->|"processed by"| stdmw
+ gateway -->|"processed by"| auth
+ gateway -->|"processed by"| stdmw
+ zinx -->|"processed by"| auth
+ zinx -->|"processed by"| stdmw
+
+ auth -->|"accesses"| gorm
+ auth -->|"accesses"| mongo
+ auth -->|"accesses"| cache
+ auth -->|"accesses"| nats
+ stdmw -->|"accesses"| gorm
+ stdmw -->|"accesses"| mongo
+ stdmw -->|"accesses"| cache
+ stdmw -->|"accesses"| nats
+
+ auth -->|"integrates"| iap
+ auth -->|"integrates"| agones
+ stdmw -->|"integrates"| iap
+ stdmw -->|"integrates"| agones
diff --git a/experiments/v3-mermaid-validation/sources/3-moke-kit.mmd b/experiments/v3-mermaid-validation/sources/3-moke-kit.mmd
new file mode 100644
index 00000000..d10ed6da
--- /dev/null
+++ b/experiments/v3-mermaid-validation/sources/3-moke-kit.mmd
@@ -0,0 +1,68 @@
+flowchart TD
+%% Application Layer
+ subgraph "Application Layer"
+ app["App & DI (fxmain)"]:::app
+ end
+
+%% Server Layer
+ subgraph "Server Layer"
+ grpc["gRPC Server"]:::server
+ gateway["HTTP Gateway"]:::server
+ zinx["TCP/WebSocket/KCP Server (zinx)"]:::server
+ end
+
+%% Middleware Layer
+ subgraph "Middleware Layer"
+ auth["Auth Middleware"]:::mw
+ stdmw["Other Middlewares (Logging,RateLimit,Recovery,OTel)"]:::mw
+ end
+
+%% Storage & Message Queue Layer
+ subgraph "Storage & Message Queue Layer"
+ gorm["Relational DB (GORM)"]:::storage
+ mongo["NoSQL DB (MongoDB)"]:::storage
+ cache["Cache (Redis & Dragonfly)"]:::storage
+ nats["Message Queue (NATS)"]:::storage
+ end
+
+%% Integration Layer
+ subgraph "Integration Layer"
+ iap["IAP Integration"]:::integration
+ agones["Agones Integration"]:::integration
+ end
+
+%% Connections from Application Layer to Server Layer
+ app -->|"initializes"| grpc
+ app -->|"initializes"| gateway
+ app -->|"initializes"| zinx
+
+%% Connections from Server Layer to Middleware Layer
+ grpc -->|"processed by"| auth
+ grpc -->|"processed by"| stdmw
+ gateway -->|"processed by"| auth
+ gateway -->|"processed by"| stdmw
+ zinx -->|"processed by"| auth
+ zinx -->|"processed by"| stdmw
+
+%% Connections from Middleware Layer to Storage & Message Queue Layer
+ auth -->|"accesses"| gorm
+ auth -->|"accesses"| mongo
+ auth -->|"accesses"| cache
+ auth -->|"accesses"| nats
+ stdmw -->|"accesses"| gorm
+ stdmw -->|"accesses"| mongo
+ stdmw -->|"accesses"| cache
+ stdmw -->|"accesses"| nats
+
+%% Connections from Middleware Layer to Integration Layer
+ auth -->|"integrates"| iap
+ auth -->|"integrates"| agones
+ stdmw -->|"integrates"| iap
+ stdmw -->|"integrates"| agones
+
+%% Styles
+ classDef app fill:#D0E6A5,stroke:#333,stroke-width:2px;
+ classDef server fill:#86E3CE,stroke:#333,stroke-width:2px;
+ classDef mw fill:#FFDD94,stroke:#333,stroke-width:2px;
+ classDef storage fill:#F09494,stroke:#333,stroke-width:2px;
+ classDef integration fill:#A29BFE,stroke:#333,stroke-width:2px;
diff --git a/experiments/v3-mermaid-validation/sources/4-hivenue-cicd.mmd b/experiments/v3-mermaid-validation/sources/4-hivenue-cicd.mmd
new file mode 100644
index 00000000..189705be
--- /dev/null
+++ b/experiments/v3-mermaid-validation/sources/4-hivenue-cicd.mmd
@@ -0,0 +1,11 @@
+flowchart TD
+A[Hivenue <br> Development <br> Environment] -->|Code <br> Commit| B[Develop <br> Branch]
+B -->|Build <br> Dev <br> Distribution| C{Unit Test - jest <br> Test Coverage - istanbul}
+C -->|Fail| D[CI Fail <br> Push Notification]
+C -->|Pass| E[CI Pass <br> Push Notification]
+E -->|Staging <br> DigitalOcean <br> Prod Distribution| F{e2e/UAT <br> Playwright Test}
+F -->|Fail| G[CD Fail <br> Push Notification]
+F -->|Pass| H{CD Pass <br> Push Notification}
+H -->|Continuous <br> Deployment <br> Prod Distribution| I[Production <br> Release]
+H -->|Approve <br> Deployment <br> Prod Distribution| I
+I --> J[Deployment Success <br> Push Notification]
diff --git a/experiments/v3-mermaid-validation/sources/5-taiga-3tier.mmd b/experiments/v3-mermaid-validation/sources/5-taiga-3tier.mmd
new file mode 100644
index 00000000..5d0ba28a
--- /dev/null
+++ b/experiments/v3-mermaid-validation/sources/5-taiga-3tier.mmd
@@ -0,0 +1,32 @@
+graph TD
+ subgraph "Client"
+ Browser[Web Browser]
+ end
+
+ subgraph "Application Server"
+ Flask[Flask API]
+ Celery[Celery Workers]
+ Redis[Redis Queue]
+ end
+
+ subgraph "Storage"
+ Postgres[PostgreSQL]
+ S3[AWS S3]
+ GCS[Google Cloud Storage]
+ end
+
+ subgraph "External Services"
+ Figshare[Figshare]
+ Email[Email Service]
+ end
+
+ Browser -->|HTTP/HTTPS| Flask
+ Flask -->|Query/Update| Postgres
+ Flask -->|Enqueue Tasks| Redis
+ Redis -->|Process Tasks| Celery
+ Celery -->|File Operations| S3
+ Celery -->|File Operations| GCS
+ Celery -->|Publish| Figshare
+ Celery -->|Send Notifications| Email
+ Flask -->|Generate Signed URLs| S3
+ Flask -->|Generate Signed URLs| GCS
diff --git a/experiments/v3-mermaid-validation/theme/archify-mermaid-config.json b/experiments/v3-mermaid-validation/theme/archify-mermaid-config.json
new file mode 100644
index 00000000..fa15ff99
--- /dev/null
+++ b/experiments/v3-mermaid-validation/theme/archify-mermaid-config.json
@@ -0,0 +1,36 @@
+{
+ "theme": "base",
+ "themeVariables": {
+ "background": "#020617",
+ "primaryColor": "rgba(30, 41, 59, 0.6)",
+ "primaryTextColor": "#f1f5f9",
+ "primaryBorderColor": "#94a3b8",
+ "lineColor": "#64748b",
+ "secondaryColor": "rgba(30, 41, 59, 0.6)",
+ "tertiaryColor": "rgba(30, 41, 59, 0.6)",
+ "mainBkg": "rgba(30, 41, 59, 0.6)",
+ "secondBkg": "rgba(30, 41, 59, 0.6)",
+ "tertiaryBkg": "rgba(30, 41, 59, 0.6)",
+ "nodeBorder": "#94a3b8",
+ "clusterBkg": "rgba(15, 23, 42, 0.4)",
+ "clusterBorder": "#334155",
+ "edgeLabelBackground": "#020617",
+ "labelBoxBkgColor": "rgba(15, 23, 42, 0.9)",
+ "labelBoxBorderColor": "#334155",
+ "labelTextColor": "#cbd5e1",
+ "fontFamily": "'JetBrains Mono', ui-monospace, Menlo, Consolas, monospace",
+ "fontSize": "14px",
+ "titleColor": "#f1f5f9",
+ "textColor": "#e2e8f0",
+ "errorBkgColor": "rgba(136, 19, 55, 0.4)",
+ "errorTextColor": "#fb7185"
+ },
+ "themeCSS": ".node rect, .node polygon, .node circle, .node ellipse, .node path { stroke-width: 1.5px !important; rx: 6 !important; ry: 6 !important; } .cluster rect { stroke-width: 1px !important; stroke-dasharray: 4,4 !important; rx: 8 !important; ry: 8 !important; } .edgePath .path { stroke-width: 1.5px !important; } .edgeLabel { font-size: 11px !important; } .nodeLabel { font-weight: 500 !important; }",
+ "flowchart": {
+ "htmlLabels": true,
+ "curve": "basis",
+ "padding": 20,
+ "nodeSpacing": 50,
+ "rankSpacing": 60
+ }
+}