Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
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
classDefstyling (#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
- Diagram 1 is from the syntax docs page, not the canonical
examples.mdshowcase — that one's only 4 nodes which falls below our 5-node floor. The 5-node decision-loop is the closest "official representative" example. - 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.
- 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).