diff --git a/CLAUDE.md b/CLAUDE.md
index 96c492c..658475c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -94,6 +94,12 @@ First build downloads AGP/Compose/Shizuku from Google Maven + Maven Central.
   periodic heartbeat only re-POSTs the cached port. Rotation is still caught: onServiceLost
   clears the guard, so the new advertisement is resolved once and reported within seconds
   (verified: 37089 -> 33667 reported 6 s after rotation).
+  **Known limitation — do not run the beacon on the OnePlus.** On network churn (SSID jump, roam)
+  adbd repeatedly drops and re-publishes its advertisement, so lost/found cycles keep clearing the
+  resolve-guard; each resolve makes adbd re-arm and post a "wireless debugging connected"
+  notification. Guarding reduces but cannot eliminate this — resolving adbd's own mDNS record is
+  inherently noisy on that device. Use manual `ip:port` there (ask the user), or read the port via
+  Shizuku (`ss -tlnp | grep adbd`, no mDNS) if the shell tier is available.
 - **Shizuku start kills the adb bridge and the beacon can't auto-recover it.** Shizuku's non-root
   start pairs over wireless debugging and runs its starter through adb, hijacking the channel:
   adb goes device→offline→refused, and adbd keeps advertising the now-dead port over mDNS (stale),