From 406e8a97f670f5ec74892d06f825c92fa633e9d5 Mon Sep 17 00:00:00 2001
From: Willem van den Ende <willem@qwan.eu>
Date: Fri, 11 Sep 2026 16:31:26 +0100
Subject: [PATCH] docs(AGENTS): document mmdc for rendering mermaid diagrams to
 svg

---
 AGENTS.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 0ed7395..cddb6c8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -5,6 +5,16 @@ Exercise repo: illustrating the transition from DB-backed domain classes
 Diagrams: `before-after-dto.mmd`, `after-dto.mmd` (source sketch:
 `before-after-dto-sketch.png`).
 
+## Rendering diagrams (mermaid → svg)
+
+Mermaid diagrams can be rendered to SVG with the `mmdc` CLI (mermaid-cli,
+installed via npm): `mmdc -i <input>` writes `<input>.svg` next to the source.
+
+```sh
+mmdc -i before-after-dto.mmd   # -> before-after-dto.svg
+mmdc -i after-dto.mmd          # -> after-dto.svg
+```
+
 ## Running dotnet
 
 dotnet SDK 10 is installed **via mise** (see `mise.toml`). It is NOT on PATH in