diff --git a/docs/mac_studio_setup_plan.md b/docs/mac_studio_setup_plan.md
index 2eef058..fe1bd97 100644
--- a/docs/mac_studio_setup_plan.md
+++ b/docs/mac_studio_setup_plan.md
@@ -3,7 +3,7 @@
 OneDrive as vault; Studio = always-on automation host; Mullvad untouched.
 
 ## Machine roles
-| | Mac Studio (192.168.1.200) | MacBook Air |
+| | Mac Studio (mac-studio-2022.local) | MacBook Air |
 |---|---|---|
 | Role | Primary dev + automation host | Portable dev |
 | Scheduled jobs | 2 AM bundles, noon lottery, Sun 11 AM cleanup | Journal bundle, status watcher, Sun 11 AM cleanup |
@@ -12,6 +12,14 @@ OneDrive as vault; Studio = always-on automation host; Mullvad untouched.
 | VPN | Mullvad, split-tunneled (DO NOT TOUCH) | — |
 | Remote Login (SSH) | Enabled, keep enabled | — |
 
+## Network topology (verified 2026-08-10)
+- Both machines share the honeypot Wi-Fi subnet 192.168.86.x — this is the
+  SSH path (Mullvad local-network sharing works same-subnet only)
+- Studio: Wi-Fi 192.168.86.218, Ethernet 192.168.1.220 on the main LAN
+  (the Air canNOT reach 192.168.1.x directly — do not use those IPs)
+- Air uses SSH alias `ssh studio` (HostName mac-studio-2022.local, key auth)
+- TODO: DHCP reservation for the Studio Wi-Fi MAC in the honeypot router
+
 ## 0. Prerequisites (Studio)
 - [x] Mullvad "Local network sharing" enabled (verified 2026-08-10)
 - [ ] System Settings > General > Sharing > Remote Login: ON (keep on)
@@ -27,7 +35,7 @@ OneDrive as vault; Studio = always-on automation host; Mullvad untouched.
 Hermes on the Air connects over LAN SSH, installs Hermes on the Studio;
 the Studio's Hermes then executes sections 2-8 locally.
 
-    ssh patricksingletary@192.168.1.200   # verify connectivity first
+    ssh studio   # verify connectivity first
     # then install Hermes on the Studio per its install method and hand
     # it this document from ~/dev/_shared/docs/