diff --git a/kgrapher/README.md b/kgrapher/README.md
index f2f0002..cc74bba 100644
--- a/kgrapher/README.md
+++ b/kgrapher/README.md
@@ -59,7 +59,7 @@ sequenceDiagram
 
     K->>K: dedupe prefixes, rewrite via localOntologies,<br/>prepend cloud IRI, concatenate
     opt graphDBurl configured
-        K->>G: SPARQL UPDATE<br/>CLEAR GRAPH urn:state:current;<br/>ADD GRAPH snapshot-IRI TO urn:state:current
+        K->>G: SPARQL UPDATE rotates urn:state:current<br/>to point at a new snapshot graph
     end
     K-->>User: merged TTL (text/turtle)
 ```
diff --git a/modeler/README.md b/modeler/README.md
index 5a2f569..8c1149e 100644
--- a/modeler/README.md
+++ b/modeler/README.md
@@ -83,8 +83,8 @@ sequenceDiagram
         S-->>M: SysML v2 fragment (port defs, part defs, IBD part, behaviour defs)
     end
 
-    M->>M: merge (dedupe port + abstract action defs,<br/>collect block defs, IBD parts, behaviour defs)
-    M-->>User: SysML v2 package 'localCloud' { … }
+    M->>M: merge — dedupe port and abstract action defs,<br/>collect block defs, IBD parts, behaviour defs
+    M-->>User: SysML v2 package localCloud (merged)
 ```
 
 Each system's `/smodel` endpoint (provided by the `mbaigo` framework)