diff --git a/doc/user/commands.md b/doc/user/commands.md
index 745c519..9741472 100644
--- a/doc/user/commands.md
+++ b/doc/user/commands.md
@@ -67,7 +67,7 @@ connect a part across two modules (interactive screen if no args)
 ---
 ### `set-connector-type`  *(interactive)*
 
-tag a part's connector type for transform lookup
+tag a part's connector type (tells connect how to wire its pins)
 
 **Arguments**
 
@@ -91,7 +91,7 @@ detect signal groups (diff pairs, buses) and structural anomalies
 ---
 ### `attach-bsdl`
 
-attach a BSDL (.bsd) model to a part and populate pin specs
+attach a BSDL (.bsd) model to a part (fills in each pin's role and direction)
 
 **Arguments**
 
@@ -106,7 +106,7 @@ attach a BSDL (.bsd) model to a part and populate pin specs
 ---
 ### `clear`
 
-clear the visualization area
+clear the console output
 
 **No arguments.**
 ---
@@ -253,7 +253,7 @@ execute a file of commands line by line (interactive cmds rejected)
 ---
 ### `verify`
 
-check pin roles, bridged-net consistency, and model-driven pin specs (contention/undriven/NC)
+check pin roles, power/gnd net consistency, and (with BSDL) pin and JTAG checks
 
 **No arguments.**
 ---
diff --git a/src/tui/commands.cpp b/src/tui/commands.cpp
index 16dc878..036458d 100644
--- a/src/tui/commands.cpp
+++ b/src/tui/commands.cpp
@@ -80,7 +80,7 @@ void Tui::RegisterCommands() {
         "list commands (or `help <name>` for one command's details)",
     };
     commands["clear"] = { {}, [this](auto &) { output.clear(); }, true,
-                          "clear the visualization area" };
+                          "clear the console output" };
     // quit / exit work from any screen: set the flag *and* call Exit() on the
     // captured ScreenInteractive so the FTXUI loop returns immediately. The
     // legacy main-screen Renderer also reads `quit` as a belt-and-braces
@@ -327,7 +327,7 @@ void Tui::RegisterCommands() {
         Print("verify: " + std::to_string(missing_anoms.size())
               + " BSDL completeness issue(s).");
     }, true,
-       "check pin roles, bridged-net consistency, and model-driven pin specs (contention/undriven/NC)" };
+       "check pin roles, power/gnd net consistency, and (with BSDL) pin and JTAG checks" };
 
     commands["dashboard"] = { {}, [this](auto &) {
         screen_idx = 4;
@@ -475,11 +475,11 @@ void Tui::RegisterCommands() {
             Print(mod->name + "/" + prt->name + ": connector_type = "
                   + (args[2].empty() ? "(none)" : args[2]));
             if (rep.materialised > 0)
-                Print("set-connector-type: materialised " + std::to_string(rep.materialised)
-                      + " NC pin(s) from connector layout");
+                Print("set-connector-type: added " + std::to_string(rep.materialised)
+                      + " NC pin(s) from the connector layout");
         },
         /*prompt_for_missing=*/ false,
-        "tag a part's connector type for transform lookup",
+        "tag a part's connector type (tells connect how to wire its pins)",
         /*scriptable=*/ true,
         /*interactive=*/ true,
     };
@@ -530,7 +530,7 @@ void Tui::RegisterCommands() {
                   + (r.unbound ? (", " + std::to_string(r.unbound) + " unbound") : ""));
         },
         /*prompt_for_missing=*/ false,
-        "attach a BSDL (.bsd) model to a part and populate pin specs",
+        "attach a BSDL (.bsd) model to a part (fills in each pin's role and direction)",
         /*scriptable=*/ true,
         /*interactive=*/ false,
     };
@@ -644,7 +644,7 @@ void Tui::RegisterCommands() {
                     int added = FillIdentityNCs(p1, p2);
                     Print("connect: " + info);
                     if (added > 0)
-                        Print("connect: materialised " + std::to_string(added)
+                        Print("connect: added " + std::to_string(added)
                               + " NC pin(s) so both sides match");
                 }
             }
diff --git a/src/tui/screen_connect.cpp b/src/tui/screen_connect.cpp
index 0d455d8..d88865f 100644
--- a/src/tui/screen_connect.cpp
+++ b/src/tui/screen_connect.cpp
@@ -138,7 +138,7 @@ Component Tui::BuildConnectScreen() {
             text(" essim ") | bold,
             text("→ ") | dim,
             text("connect") | bold,
-            text("  — wire two parts across modules (TransformRegistry-driven)") | dim,
+            text("  — wire two parts across modules") | dim,
         });
 
         Element help = RenderHelpPanel("connect", {
diff --git a/src/tui/screen_settype.cpp b/src/tui/screen_settype.cpp
index 001bda2..deb897e 100644
--- a/src/tui/screen_settype.cpp
+++ b/src/tui/screen_settype.cpp
@@ -146,7 +146,7 @@ Component Tui::BuildSettypeScreen() {
             text(" essim ") | bold,
             text("→ ") | dim,
             text("set-connector-type") | bold,
-            text("  — tag a part with its connector kind (drives transforms + pin roles)") | dim,
+            text("  — tag a part's connector type (used to wire it correctly)") | dim,
         });
 
         Element help = RenderHelpPanel("set-connector-type", {