From 7a3ce8fb183090c7454e865f5d22a7d34937a8a2 Mon Sep 17 00:00:00 2001
From: borealBytes <claytoneyoung+github@gmail.com>
Date: Thu, 19 Feb 2026 18:35:25 -0500
Subject: [PATCH] fix(mermaid): replace \n with <br/> in all node labels
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Mermaid renders literal \n as text on GitHub — line breaks inside
node labels require <br/> syntax. Fixed 12 occurrences across 4 files:

- SKILL.md: three-phase workflow (Phase 1/2/3 nodes)
- issue-00000001: three-phase workflow nodes
- pr-00000001: skill name node
- example-research-report.md: Stage 1-5 nodes in experimental workflow
---
 .../issues/issue-00000001-markdown-mermaid-skill.md    |  6 +++---
 docs/project/pr/pr-00000001-markdown-mermaid-skill.md  |  2 +-
 scientific-skills/markdown-mermaid-writing/SKILL.md    |  6 +++---
 .../assets/examples/example-research-report.md         | 10 +++++-----
 4 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/docs/project/issues/issue-00000001-markdown-mermaid-skill.md b/docs/project/issues/issue-00000001-markdown-mermaid-skill.md
index e2192e2..ebce40d 100644
--- a/docs/project/issues/issue-00000001-markdown-mermaid-skill.md
+++ b/docs/project/issues/issue-00000001-markdown-mermaid-skill.md
@@ -63,9 +63,9 @@ flowchart LR
     accTitle: Documentation Production Workflow
     accDescr: Mermaid in markdown is the required source phase. Python and AI-generated images are optional downstream phases for polished output only.
 
-    source["📄 Phase 1 — Mermaid in Markdown\n(ALWAYS — source of truth)"]
-    python["🐍 Phase 2 — Python Generated\n(optional — when charts needed)"]
-    ai["🎨 Phase 3 — AI Generated\n(optional — polished visuals)"]
+    source["📄 Phase 1 — Mermaid in Markdown<br/>(ALWAYS — source of truth)"]
+    python["🐍 Phase 2 — Python Generated<br/>(optional — when charts needed)"]
+    ai["🎨 Phase 3 — AI Generated<br/>(optional — polished visuals)"]
     final["📊 Final Output"]
 
     source --> python
diff --git a/docs/project/pr/pr-00000001-markdown-mermaid-skill.md b/docs/project/pr/pr-00000001-markdown-mermaid-skill.md
index 1f49b15..24667f2 100644
--- a/docs/project/pr/pr-00000001-markdown-mermaid-skill.md
+++ b/docs/project/pr/pr-00000001-markdown-mermaid-skill.md
@@ -84,7 +84,7 @@ flowchart TD
     accTitle: New Skill Position in Ecosystem
     accDescr: Shows markdown-mermaid-writing as the foundation layer that other skills build upon for documentation output
 
-    new["📄 markdown-mermaid-writing\n(this PR — new skill)"]
+    new["📄 markdown-mermaid-writing<br/>(this PR — new skill)"]
     writing["✍️ scientific-writing"]
     lit["📚 literature-review"]
     schematics["🎨 scientific-schematics"]
diff --git a/scientific-skills/markdown-mermaid-writing/SKILL.md b/scientific-skills/markdown-mermaid-writing/SKILL.md
index 1d17db5..1d440c4 100644
--- a/scientific-skills/markdown-mermaid-writing/SKILL.md
+++ b/scientific-skills/markdown-mermaid-writing/SKILL.md
@@ -80,9 +80,9 @@ flowchart LR
     accTitle: Three-Phase Documentation Workflow
     accDescr: Phase 1 Mermaid in markdown is always required and is the source of truth. Phases 2 and 3 are optional downstream conversions for polished output.
 
-    p1["📄 Phase 1\nMermaid in Markdown\n(ALWAYS — source of truth)"]
-    p2["🐍 Phase 2\nPython Generated\n(optional — data charts)"]
-    p3["🎨 Phase 3\nAI Generated Visuals\n(optional — polish)"]
+    p1["📄 Phase 1<br/>Mermaid in Markdown<br/>(ALWAYS — source of truth)"]
+    p2["🐍 Phase 2<br/>Python Generated<br/>(optional — data charts)"]
+    p3["🎨 Phase 3<br/>AI Generated Visuals<br/>(optional — polish)"]
     out["📊 Final Deliverable"]
 
     p1 --> out
diff --git a/scientific-skills/markdown-mermaid-writing/assets/examples/example-research-report.md b/scientific-skills/markdown-mermaid-writing/assets/examples/example-research-report.md
index e470e73..7925d20 100644
--- a/scientific-skills/markdown-mermaid-writing/assets/examples/example-research-report.md
+++ b/scientific-skills/markdown-mermaid-writing/assets/examples/example-research-report.md
@@ -25,11 +25,11 @@ flowchart TD
     accTitle: CRISPR Editing Experimental Workflow
     accDescr: Five-stage experimental pipeline from gRNA design through data analysis, with quality checkpoints between each stage.
 
-    design["🧬 Stage 1\ngRNA Design\n(CRISPRscan + Cas-OFFinder)"]
-    synth["⚙️ Stage 2\nOligo Synthesis\n& Annealing"]
-    transfect["🔬 Stage 3\nCell Transfection\n(Lipofectamine 3000)"]
-    screen["🧪 Stage 4\nPrimary Screen\n(T7E1 assay)"]
-    ngs["📊 Stage 5\nNGS Validation\n(150 bp PE reads)"]
+    design["🧬 Stage 1<br/>gRNA Design<br/>(CRISPRscan + Cas-OFFinder)"]
+    synth["⚙️ Stage 2<br/>Oligo Synthesis<br/>& Annealing"]
+    transfect["🔬 Stage 3<br/>Cell Transfection<br/>(Lipofectamine 3000)"]
+    screen["🧪 Stage 4<br/>Primary Screen<br/>(T7E1 assay)"]
+    ngs["📊 Stage 5<br/>NGS Validation<br/>(150 bp PE reads)"]
 
     qc1{GC 40-65%?}
     qc2{Yield ≥ 2 µg?}