diff --git a/docker/docker-compose.local.yml b/docker/docker-compose.local.yml
index f44fac4e4..b28b6c406 100644
--- a/docker/docker-compose.local.yml
+++ b/docker/docker-compose.local.yml
@@ -1,3 +1,6 @@
+# ─────────────────────────────────────────────
+# PicoClaw Agent and PicoClaw Gateway should not be run together
+# ─────────────────────────────────────────────
 services:
   # ─────────────────────────────────────────────
   # PicoClaw Agent (one-shot query)