diff --git a/hive-sh4re/README.md b/hive-sh4re/README.md
index f7c0f8d6..07bb7590 100644
--- a/hive-sh4re/README.md
+++ b/hive-sh4re/README.md
@@ -1,9 +1,10 @@
 # hive-sh4re
 
-The **shared wire types** between `hive-c0re` and the in-container harness — the
-common vocabulary (`Message`, `Approval`, `LooseEnd`, `HelperEvent`, the
-Agent / Manager request + response shapes) that the unix-socket protocols are
-built from.
+The **shared payload vocabulary** between `hive-c0re` and the in-container
+harness — the common types (`Message`, `Approval`, `LooseEnd`, `HelperEvent`, …)
+that the per-socket wire protocols are built from. The request/response
+*envelopes* themselves now live in the per-socket crates (below); this crate
+holds the payloads they carry.
 
 ## Where it sits