diff --git a/README.md b/README.md
index 482e1b3..21ca33f 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,14 @@ When your session works with other agents, their messages arrive in the transcri
- **Idle notices and peer states.** A teammate's idle notice with no content only updates its state. A notice that carries the teammate's final answer or failure shows as a message. When Claude runs ListAgents, High Command notes the state of each listed peer, such as busy, idle, or offline, and shows it on that peer's row once the peer has messages.
- **Read-only.** High Command never starts a model turn and never changes a message, a send, or a tool result.
+
+
+*The roster: one row per peer, warning marks first in the last message.*
+
+
+
+*The researcher thread, newest first, with Back, the state, and the sender label at the top.*
+
## How it works
```mermaid
diff --git a/docs/images/pane.svg b/docs/images/pane.svg
new file mode 100644
index 0000000..007f40b
--- /dev/null
+++ b/docs/images/pane.svg
@@ -0,0 +1,118 @@
+
diff --git a/docs/images/thread.svg b/docs/images/thread.svg
new file mode 100644
index 0000000..67be011
--- /dev/null
+++ b/docs/images/thread.svg
@@ -0,0 +1,122 @@
+