Skip to content

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

2.7 KB
Raw Blame

v3.0 Mermaid → Archify Validation — Source Diagrams

3 real-world Mermaid flowchart diagrams retained from the v3.0 visual-quality validation experiment described in ../../ROADMAP.md (section: Validation experiment). The original experiment used five inputs; two inputs and their derivatives were removed on 2026-09-01 because their repositories did not provide verifiable redistribution licenses.

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 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 9 LR k8s log aggregation pipeline; uses subgraph for source grouping
3 Microservices GStones/moke-kit README.md 12 TD Go game-server toolkit; 5 layered subgraphs; ships with embedded classDef colors that we strip for fair comparison

Diversity self-check

  • Node range: 5 / 9 / 12 (small to medium)
  • Direction: 2× TD + 1× LR
  • Complexity coverage: plain (#1), subgraph (#2 #3), embedded classDef styling (#3)

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/    — retained randomized & deduplicated 9-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 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).