@@ -78,7 +78,7 @@ jobs:
           restore-keys: |
             puppeteer-${{ runner.os }}-
 
-      # Diagrams (docs/_ext/mermaid_inline.py) are rendered at build time by
+      # Diagrams (sphinx-gp-mermaid) are rendered at build time by
       # mmdc, which drives a headless Chrome. Without it the build still
       # succeeds but degrades diagrams to a text fallback, so provision both.
       - name: Install diagram toolchain (mermaid-cli + Chrome)
 
@@ -59,7 +59,7 @@ coverage.xml
 # Sphinx documentation
 docs/_build/
 
-# Mermaid diagram tooling (docs/_ext/mermaid_inline.py)
+# Mermaid diagram tooling (sphinx-gp-mermaid)
 docs/node_modules/
 docs/_mermaid_cache/
 
 
@@ -87,9 +87,10 @@ page.
 
 Two mechanical conventions, separate from voice:
 
-- **Mermaid diagrams** render to inline SVG at build time (see
-  `docs/_ext`). Tag any node whose label is a command, code identifier,
-  config key, or other symbol with `:::cmd` so it renders monospace —
+- **Mermaid diagrams** render to inline SVG at build time (via the
+  `sphinx-gp-mermaid` package). Tag any node whose label is a command,
+  code identifier, config key, or other symbol with `:::cmd` so it
+  renders monospace —
   the way that text reads as code inline; leave prose and concept nodes
   unstyled. Prefer top-to-bottom (`flowchart TD`); wide left-to-right
   charts don't scale on narrow viewports. `docs/configuration/workspace-builders.md`