diff --git a/docs/4-implementation/turn-loop/mcp.md b/docs/4-implementation/turn-loop/mcp.md
index c8c400fd..36de7604 100644
--- a/docs/4-implementation/turn-loop/mcp.md
+++ b/docs/4-implementation/turn-loop/mcp.md
@@ -36,10 +36,10 @@ runs on the change.
 
 ## Core tools (always available)
 
-**Messaging.** There is no hyperhive messaging tool. Agents talk to peers and the
+**Messaging.** The hyperhive MCP has no messaging tool. Agents talk to peers and the
 operator over matrix ([matrix](../agent-tools/matrix.md)); `send_dm` takes a peer's agent
-name (`iris`, meaning that agent on the same homeserver) or a full user id. An agent
-without matrix tools is cut off from peers on purpose, and the operator reads its
+name (`iris`, meaning that agent on the same homeserver) or a full user id. The swarm
+cuts an agent without matrix tools off from peers on purpose, and the operator reads its
 `set_status` line, its turn output on the dashboard, and its logs. The `messaging`
 permission remains an accepted value for stored permission sets, but grants no tool.
 
diff --git a/docs/5-project/process/conventions.md b/docs/5-project/process/conventions.md
index 4b677957..38783457 100644
--- a/docs/5-project/process/conventions.md
+++ b/docs/5-project/process/conventions.md
@@ -187,7 +187,7 @@ Per-variant fields:
   3339 on the wire, see *Timestamps on the wire* below); clients
   compute time-until-fire against it.
 - `PendingMessages { count }` — undelivered inbox messages the
-  agent has not handled yet. Informational + not
+  agent hasn't handled yet. Informational + not
   cancellable; only emitted when `count > 0`,
   and surfaced first in the list as the most
   actionable signal. Counted host-side from the broker