diff --git a/spec/agent.md b/spec/agent.md
index 9074006e2..6ec9b1b72 100644
--- a/spec/agent.md
+++ b/spec/agent.md
@@ -8,9 +8,9 @@ For usage and API overview, see [docs/AGENT.md](../docs/AGENT.md). For protocol
 
 **Module specs**: [Agent](modules/Simplex/Messaging/Agent.md) · [Agent Client](modules/Simplex/Messaging/Agent/Client.md) · [Agent Protocol](modules/Simplex/Messaging/Agent/Protocol.md) · [Store Interface](modules/Simplex/Messaging/Agent/Store/Interface.md) · [NtfSubSupervisor](modules/Simplex/Messaging/Agent/NtfSubSupervisor.md) · [XFTP Agent](modules/Simplex/FileTransfer/Agent.md) · [Ratchet](modules/Simplex/Messaging/Crypto/Ratchet.md)
 
-### Component topology
+### Agent components
 
-![Agent - Component Topology](diagrams/agent.svg)
+![Agent components](diagrams/agent.svg)
 
 ### Message receive flow
 
diff --git a/spec/clients.md b/spec/clients.md
index 10634d0de..3ab9d5868 100644
--- a/spec/clients.md
+++ b/spec/clients.md
@@ -12,9 +12,9 @@ For deployment and usage, see [docs/CLIENT.md](../docs/CLIENT.md). For protocol
 
 Generic protocol client used for both SMP and NTF connections. Manages a single TLS connection with multiplexed command/response matching via correlation IDs.
 
-### Component topology
+### SMP Client components
 
-![SMP Client - Component Topology](diagrams/smp-client.svg)
+![SMP Client components](diagrams/smp-client.svg)
 
 ### Command/result flow
 
@@ -63,9 +63,9 @@ sequenceDiagram
 
 Connection manager that multiplexes multiple ProtocolClient connections. Tracks subscriptions, handles reconnection with backoff, and forwards server messages and connection events upward. Used by SMP router (proxying) and NTF router (subscriptions).
 
-### Component topology
+### SMPClientAgent components
 
-![SMPClientAgent - Component Topology](diagrams/smp-client-agent.svg)
+![SMPClientAgent components](diagrams/smp-client-agent.svg)
 
 ### Connection lifecycle
 
@@ -118,9 +118,9 @@ sequenceDiagram
 
 Stateless wrapper around HTTP2Client. XFTPClient adds no threads of its own; each operation is a synchronous HTTP/2 request/response. Serialization and multiplexing happen inside HTTP2Client's internal request queue and process thread.
 
-### Component topology
+### XFTP Client components
 
-![XFTP Client - Component Topology](diagrams/xftp-client.svg)
+![XFTP Client components](diagrams/xftp-client.svg)
 
 ### Packet delivery flow
 
diff --git a/spec/routers.md b/spec/routers.md
index 6e8be5e8b..b7b8761ef 100644
--- a/spec/routers.md
+++ b/spec/routers.md
@@ -10,9 +10,9 @@ For deployment and configuration, see [docs/ROUTERS.md](../docs/ROUTERS.md). For
 
 **Module specs**: [Server](modules/Simplex/Messaging/Server.md) · [Main](modules/Simplex/Messaging/Server/Main.md) · [QueueStore](modules/Simplex/Messaging/Server/QueueStore.md) · [QueueStore Postgres](modules/Simplex/Messaging/Server/QueueStore/Postgres.md) · [MsgStore](modules/Simplex/Messaging/Server/MsgStore.md) · [StoreLog](modules/Simplex/Messaging/Server/StoreLog.md) · [Control](modules/Simplex/Messaging/Server/Control.md) · [Prometheus](modules/Simplex/Messaging/Server/Prometheus.md) · [Stats](modules/Simplex/Messaging/Server/Stats.md)
 
-### Component topology
+### SMP Router components
 
-![SMP Router - Component Topology](diagrams/smp-router.svg)
+![SMP Router components](diagrams/smp-router.svg)
 
 ### Packet delivery flow
 
@@ -72,9 +72,9 @@ sequenceDiagram
 
 **Module specs**: [Server](modules/Simplex/FileTransfer/Server.md) · [Main](modules/Simplex/FileTransfer/Server/Main.md) · [Store](modules/Simplex/FileTransfer/Server/Store.md) · [StoreLog](modules/Simplex/FileTransfer/Server/StoreLog.md) · [Stats](modules/Simplex/FileTransfer/Server/Stats.md) · [Transport](modules/Simplex/FileTransfer/Transport.md)
 
-### Component topology
+### XFTP Router components
 
-![XFTP Router - Component Topology](diagrams/xftp-router.svg)
+![XFTP Router components](diagrams/xftp-router.svg)
 
 ### Data packet delivery flow
 
@@ -122,9 +122,9 @@ sequenceDiagram
 
 **Module specs**: [Server](modules/Simplex/Messaging/Notifications/Server.md) · [Main](modules/Simplex/Messaging/Notifications/Server/Main.md) · [Store Postgres](modules/Simplex/Messaging/Notifications/Server/Store/Postgres.md) · [APNS](modules/Simplex/Messaging/Notifications/Server/Push/APNS.md) · [Control](modules/Simplex/Messaging/Notifications/Server/Control.md) · [Client](modules/Simplex/Messaging/Notifications/Client.md) · [Protocol](modules/Simplex/Messaging/Notifications/Protocol.md)
 
-### Component topology
+### NTF Router components
 
-![NTF Router - Component Topology](diagrams/ntf-router.svg)
+![NTF Router components](diagrams/ntf-router.svg)
 
 ### Token registration and notification delivery