Files
skills/public/mermaid-specialized.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

633 lines
26 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>mermaid-specialized</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/mermaid-specialized.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/mermaid-specialized">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/mermaid-specialized.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>mermaid-specialized</h1><p class="lede">Create specialized diagrams with Mermaid including Git graphs, Sankey flows, mindmaps, and other advanced visualization types</p><h1>Mermaid Specialized Diagrams</h1>
<p><strong>Scope</strong>: GitGraph, Sankey, mindmaps, and advanced diagram types in Mermaid.js <strong>Lines</strong>: ~430 <strong>Last Updated</strong>: 2025-10-27 <strong>Format Version</strong>: 1.0 (Atomic)</p>
<hr>
<h2>When to Use This Skill</h2>
<p>Activate this skill when:</p>
<ul><li>Visualizing Git workflows and branching strategies</li><li>Showing data flows and transformations (Sankey)</li><li>Creating hierarchical concept maps (mindmaps)</li><li>Documenting version control processes</li><li>Illustrating energy/material flows</li><li>Brainstorming and organizing ideas</li><li>Mapping dependencies and conversions</li></ul>
<hr>
<h1>Part 1: Git Graphs</h1>
<h2>Core Concepts</h2>
<h3>Concept 1: Basic Commits and Branches</h3>
<p><strong>Linear commits</strong>:</p>
<pre><code class="lang-mermaid">gitGraph
commit
commit
commit</code></pre>
<p><strong>Feature branch</strong>:</p>
<pre><code class="lang-mermaid">gitGraph
commit
commit
branch feature
checkout feature
commit
commit
checkout main
commit
merge feature
commit</code></pre>
<h3>Concept 2: Commit Metadata</h3>
<p><strong>Commits with IDs and tags</strong>:</p>
<pre><code class="lang-mermaid">gitGraph
commit id: &quot;Initial commit&quot;
commit id: &quot;Add authentication&quot; tag: &quot;v0.1&quot;
branch develop
checkout develop
commit id: &quot;Feature work&quot;
commit id: &quot;Bug fixes&quot;
checkout main
merge develop tag: &quot;v1.0&quot;
commit id: &quot;Hotfix&quot; tag: &quot;v1.0.1&quot;</code></pre>
<h3>Concept 3: Commit Types</h3>
<p><strong>Visual emphasis</strong>:</p>
<pre><code class="lang-mermaid">gitGraph
commit type: NORMAL
commit type: HIGHLIGHT id: &quot;Important change&quot;
commit type: REVERSE id: &quot;Reverted change&quot;
branch hotfix
checkout hotfix
commit type: HIGHLIGHT id: &quot;Critical fix&quot;
checkout main
merge hotfix tag: &quot;v1.0.1&quot;</code></pre>
<p><strong>Commit types</strong>:</p>
<ul><li><code>NORMAL</code> - Standard commit (default)</li><li><code>HIGHLIGHT</code> - Important commit (emphasized)</li><li><code>REVERSE</code> - Reverted or rolled back commit</li></ul>
<h2>Git Graph Patterns</h2>
<h3>Pattern 1: Gitflow Workflow</h3>
<pre><code class="lang-mermaid">gitGraph
commit id: &quot;Initial&quot;
commit id: &quot;Setup project&quot;
branch develop
checkout develop
commit id: &quot;Add core features&quot;
branch feature/login
checkout feature/login
commit id: &quot;Add login UI&quot;
commit id: &quot;Add authentication&quot;
checkout develop
merge feature/login
commit id: &quot;Integrate login&quot;
branch release/1.0
checkout release/1.0
commit id: &quot;Bump version&quot;
commit id: &quot;Update changelog&quot;
checkout main
merge release/1.0 tag: &quot;v1.0.0&quot;
checkout develop
merge release/1.0
branch hotfix/security
checkout hotfix/security
commit id: &quot;Fix vulnerability&quot; type: HIGHLIGHT
checkout main
merge hotfix/security tag: &quot;v1.0.1&quot;
checkout develop
merge hotfix/security</code></pre>
<h3>Pattern 2: Trunk-Based Development</h3>
<pre><code class="lang-mermaid">gitGraph
commit id: &quot;Base&quot;
branch feature-a
commit id: &quot;Feature A work&quot;
checkout main
branch feature-b
commit id: &quot;Feature B work&quot;
checkout main
merge feature-a
commit id: &quot;CI/CD deploy&quot;
merge feature-b
commit id: &quot;CI/CD deploy&quot;
commit tag: &quot;v1.0&quot; type: HIGHLIGHT</code></pre>
<h3>Pattern 3: Release Branches</h3>
<pre><code class="lang-mermaid">gitGraph
commit id: &quot;v0.9&quot;
branch release/1.0
checkout release/1.0
commit id: &quot;RC1&quot; tag: &quot;v1.0-rc1&quot;
commit id: &quot;Bug fixes&quot;
commit id: &quot;RC2&quot; tag: &quot;v1.0-rc2&quot;
checkout main
branch develop
checkout develop
commit id: &quot;New features for v1.1&quot;
checkout release/1.0
commit id: &quot;Final polish&quot;
checkout main
merge release/1.0 tag: &quot;v1.0.0&quot; type: HIGHLIGHT
checkout develop
merge main
commit id: &quot;Continue v1.1 work&quot;</code></pre>
<hr>
<h1>Part 2: Sankey Diagrams</h1>
<h2>Core Concepts</h2>
<h3>Concept 1: Basic Flow</h3>
<p><strong>Simple data flow</strong>:</p>
<pre><code class="lang-mermaid">sankey-beta
Source,Process,100
Process,Output A,60
Process,Output B,40</code></pre>
<h3>Concept 2: Complex Flows</h3>
<p><strong>Energy distribution</strong>:</p>
<pre><code class="lang-mermaid">sankey-beta
Power Plant,Transmission,1000
Transmission,Industrial,400
Transmission,Commercial,350
Transmission,Residential,200
Transmission,Loss,50</code></pre>
<h3>Concept 3: Multi-Stage Flows</h3>
<p><strong>Data pipeline</strong>:</p>
<pre><code class="lang-mermaid">sankey-beta
Raw Data,Cleaning,10000
Cleaning,Valid Records,8500
Cleaning,Rejected,1500
Valid Records,Processing,8500
Processing,Output DB,7000
Processing,Archive,1500</code></pre>
<h2>Sankey Patterns</h2>
<h3>Pattern 1: User Journey Flow</h3>
<pre><code class="lang-mermaid">sankey-beta
Landing Page,Sign Up,10000
Landing Page,Browse,5000
Landing Page,Exit,15000
Sign Up,Complete Profile,7000
Sign Up,Abandon,3000
Browse,Add to Cart,2000
Browse,Exit,3000
Add to Cart,Checkout,1500
Add to Cart,Abandon Cart,500
Checkout,Purchase,1200
Checkout,Abandon,300</code></pre>
<h3>Pattern 2: Budget Allocation</h3>
<pre><code class="lang-mermaid">sankey-beta
Total Budget,Engineering,450000
Total Budget,Sales,300000
Total Budget,Marketing,150000
Total Budget,Operations,100000
Engineering,Salaries,350000
Engineering,Infrastructure,70000
Engineering,Tools,30000
Sales,Salaries,200000
Sales,Travel,50000
Sales,CRM,50000
Marketing,Ads,80000
Marketing,Events,40000
Marketing,Content,30000</code></pre>
<h3>Pattern 3: Application Resource Usage</h3>
<pre><code class="lang-mermaid">sankey-beta
Total Memory,Application Heap,2048
Total Memory,Native Memory,512
Total Memory,System,512
Application Heap,Active Objects,1500
Application Heap,Cached Data,548
Active Objects,User Sessions,800
Active Objects,Business Logic,500
Active Objects,Framework,200</code></pre>
<hr>
<h1>Part 3: Mindmaps</h1>
<h2>Core Concepts</h2>
<h3>Concept 1: Basic Hierarchy</h3>
<p><strong>Simple structure</strong>:</p>
<pre><code class="lang-mermaid">mindmap
root((Project))
Planning
Requirements
Design
Development
Frontend
Backend
Testing
Unit Tests
Integration Tests</code></pre>
<h3>Concept 2: Node Shapes</h3>
<p><strong>Different shapes for emphasis</strong>:</p>
<pre><code class="lang-mermaid">mindmap
root((Core Concept))
[Important Category]
(Sub-item 1)
(Sub-item 2)
{Cloud Topic}
((Circle Item))
[!Bang Item!]
{{Hexagon Topic}}</code></pre>
<p><strong>Shape reference</strong>:</p>
<ul><li><code>((text))</code> - Circle (root default)</li><li><code>(text)</code> - Rounded square</li><li><code>[text]</code> - Square</li><li><code>{text}</code> - Cloud</li><li><code>{{text}}</code> - Hexagon</li><li><code>[!text!]</code> - Bang</li></ul>
<h3>Concept 3: Icons and Styling</h3>
<p><strong>With icons</strong>:</p>
<pre><code class="lang-mermaid">mindmap
root((Project))::icon(fa fa-project-diagram)
Planning::icon(fa fa-calendar)
Requirements
Timeline
Development::icon(fa fa-code)
Frontend
Backend
Deploy::icon(fa fa-rocket)</code></pre>
<h2>Mindmap Patterns</h2>
<h3>Pattern 1: System Architecture</h3>
<pre><code class="lang-mermaid">mindmap
root((E-commerce Platform))
Frontend
Web App
React
TypeScript
Vite
Mobile App
React Native
iOS
Android
Backend
API Gateway
Kong
Rate Limiting
Microservices
User Service
Order Service
Payment Service
Databases
PostgreSQL
Redis
MongoDB
Infrastructure
AWS
EC2
RDS
S3
Monitoring
Prometheus
Grafana
CI/CD
GitHub Actions
Docker</code></pre>
<h3>Pattern 2: Learning Path</h3>
<pre><code class="lang-mermaid">mindmap
root((Full-Stack Development))
Frontend
HTML/CSS
Semantic HTML
Flexbox
Grid
JavaScript
ES6+
Async/Await
DOM
React
Hooks
Context
Router
Backend
Node.js
Express
NestJS
Databases
SQL
PostgreSQL
Joins
NoSQL
MongoDB
Redis
DevOps
Docker
Containers
Compose
Kubernetes
Pods
Services
AWS
EC2
S3
Lambda</code></pre>
<h3>Pattern 3: Project Breakdown</h3>
<pre><code class="lang-mermaid">mindmap
root((Launch New Feature))
Research
User Interviews
Competitor Analysis
Market Research
Design
Wireframes
Mockups
User Flows
Design System
Development
Backend API
Database Schema
Endpoints
Auth
Frontend
Components
Pages
State Management
Testing
Unit Tests
Integration
E2E
Launch
Beta Release
Marketing
Documentation
Training</code></pre>
<hr>
<h1>Part 4: Other Specialized Diagrams</h1>
<h2>Requirement Diagrams</h2>
<p><strong>Requirements traceability</strong>:</p>
<pre><code class="lang-mermaid">requirementDiagram
requirement UserAuth {
id: REQ-001
text: Users must authenticate
risk: high
verifymethod: test
}
functionalRequirement LoginAPI {
id: FREQ-001
text: Provide login endpoint
}
element AuthService {
type: service
docRef: auth-service.md
}
UserAuth - satisfies -&gt; LoginAPI
LoginAPI - implements -&gt; AuthService</code></pre>
<h2>Best Practices</h2>
<h3>Git Graphs</h3>
<p><strong>Do</strong>:</p>
<ul><li>Show realistic branching strategies</li><li>Use tags for releases</li><li>Highlight important commits</li><li>Show merge directions clearly</li></ul>
<p><strong>Don&#x27;t</strong>:</p>
<ul><li>Create overly complex graphs (limit to 20-30 commits)</li><li>Mix different workflows in one diagram</li><li>Omit critical merge points</li></ul>
<h3>Sankey Diagrams</h3>
<p><strong>Do</strong>:</p>
<ul><li>Use for flow visualization (data, energy, resources)</li><li>Ensure flow values are consistent (in = out)</li><li>Label nodes clearly</li><li>Show losses/waste explicitly</li></ul>
<p><strong>Don&#x27;t</strong>:</p>
<ul><li>Use for hierarchies (use mindmap)</li><li>Create circular flows</li><li>Omit significant flow paths</li></ul>
<h3>Mindmaps</h3>
<p><strong>Do</strong>:</p>
<ul><li>Start with central concept</li><li>Group related items</li><li>Use shapes for categorization</li><li>Limit depth to 4-5 levels</li></ul>
<p><strong>Don&#x27;t</strong>:</p>
<ul><li>Create unbalanced trees</li><li>Mix abstraction levels</li><li>Overcrowd with too many nodes</li></ul>
<h2>Anti-Patterns</h2>
<h3>❌ Overcomplicated Git Graph</h3>
<pre><code class="lang-mermaid">gitGraph
commit
branch feat1
branch feat2
branch feat3
%% ... 10 more branches</code></pre>
<p><strong>Solution</strong>: Split into multiple diagrams or show just relevant branches</p>
<h3>❌ Inconsistent Sankey Flows</h3>
<pre><code class="lang-mermaid">sankey-beta
Input,Process,100
Process,Output,120 %% Where did extra 20 come from?</code></pre>
<p><strong>✅ Better</strong>: Flows must balance</p>
<h3>❌ Flat Mindmap (No Hierarchy)</h3>
<pre><code class="lang-mermaid">mindmap
root
Item1
Item2
Item3
%% No grouping or structure</code></pre>
<p><strong>✅ Better</strong>: Group related concepts into hierarchies</p>
<h2>Integration Tips</h2>
<ul><li><strong>GitGraph + Sequence</strong>: Version control workflow + runtime behavior</li><li><strong>Sankey + Architecture</strong>: Data flow + system structure</li><li><strong>Mindmap + Flowchart</strong>: Concept breakdown + process flow</li><li><strong>GitGraph + Project Timeline</strong>: Development workflow + schedule</li></ul>
<h2>Related Skills</h2>
<ul><li><code>mermaid-flowcharts.md</code> - Process flows</li><li><code>mermaid-sequence-diagrams.md</code> - Interactions</li><li><code>mermaid-architecture-diagrams.md</code> - System design</li><li><code>version-control.md</code> - Git workflows</li></ul>
<h2>Resources</h2>
<ul><li>Official Docs:</li><li>https://mermaid.js.org/syntax/gitgraph.html</li><li>https://mermaid.js.org/syntax/sankey.html</li><li>https://mermaid.js.org/syntax/mindmap.html</li><li>Live Editor: https://mermaid.live</li><li>Gitflow: https://nvie.com/posts/a-successful-git-branching-model/</li><li>Trunk-Based Development: https://trunkbaseddevelopment.com/</li></ul>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/mermaid-specialized.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>