diff --git a/examples/ai-code-guardrails/AI-Code-Guardrails.shadow.dave.md b/examples/ai-code-guardrails/AI-Code-Guardrails.shadow.dave.md
index 880e51b..faece21 100644
--- a/examples/ai-code-guardrails/AI-Code-Guardrails.shadow.dave.md
+++ b/examples/ai-code-guardrails/AI-Code-Guardrails.shadow.dave.md
@@ -58,13 +58,13 @@ If anything goes sideways, we can always point to the PR thread and note that it
 ```mermaid
 flowchart TD
   A[Code change] --> B[Pull request opened]
-  B --> C[Automated scan (PR checks)]
+  B --> C[Automated scan: PR checks]
   C --> D{Findings?}
   D -->|None| E[Merge]
   D -->|Some| F[Ticket created]
   F --> G[Exception request]
   G --> H[Alignment session]
-  H --> I[Risk accepted (documented)]
+  H --> I[Risk accepted: documented]
   I --> E
 ```
 
@@ -80,7 +80,7 @@ We recommend a pilot cohort, a slide deck, and an FAQ, so the shift remains cult
 
 ```mermaid
 flowchart TD
-  A[Developer writes code] --> B[IDE scan (local)]
+  A[Developer writes code] --> B[IDE scan: local]
   B --> C{Issue found?}
   C -->|Yes| D[Fix now]
   C -->|No| E[Commit]
@@ -105,7 +105,7 @@ flowchart TD
   A[Developer requests access] --> B[Upload screenshot]
   B --> C[Attestation captured]
   C --> D[Access enabled]
-  D --> E[Local testing (claimed)]
+  D --> E[Local testing: claimed]
   E --> F[Periodic audit]
   F --> G{Still compliant?}
   G -->|Yes| D
diff --git a/src/revoice/generate.py b/src/revoice/generate.py
index 4e35b94..256942e 100644
--- a/src/revoice/generate.py
+++ b/src/revoice/generate.py
@@ -237,19 +237,19 @@ def _inferred_mermaid(title: str) -> str | None:
     if "PULL REQUEST" in title_upper:
         return """flowchart TD
   A[Code change] --> B[Pull request opened]
-  B --> C[Automated scan (PR checks)]
+  B --> C[Automated scan: PR checks]
   C --> D{Findings?}
   D -->|None| E[Merge]
   D -->|Some| F[Ticket created]
   F --> G[Exception request]
   G --> H[Alignment session]
-  H --> I[Risk accepted (documented)]
+  H --> I[Risk accepted: documented]
   I --> E
 """
 
     if "SHIFTING LEFT" in title_upper:
         return """flowchart TD
-  A[Developer writes code] --> B[IDE scan (local)]
+  A[Developer writes code] --> B[IDE scan: local]
   B --> C{Issue found?}
   C -->|Yes| D[Fix now]
   C -->|No| E[Commit]
@@ -264,7 +264,7 @@ def _inferred_mermaid(title: str) -> str | None:
   A[Developer requests access] --> B[Upload screenshot]
   B --> C[Attestation captured]
   C --> D[Access enabled]
-  D --> E[Local testing (claimed)]
+  D --> E[Local testing: claimed]
   E --> F[Periodic audit]
   F --> G{Still compliant?}
   G -->|Yes| D