update

.claude/CLAUDE.md

@@ -36,6 +36,15 @@ Common mistakes to avoid:
   - `ts/classes/` - All class implementations
   - `ts/` - Root level utilities (logging, types, plugins, cli, info)
 
+### Docker Configuration
+- **System Docker**: Uses root Docker at `/var/run/docker.sock` (NOT rootless)
+- **Swarm Mode**: Enabled for service orchestration
+- **API Access**: Interact with Docker via direct API calls to the socket
+  - ❌ DO NOT switch Docker CLI contexts
+  - ✅ Use curl/HTTP requests to `/var/run/docker.sock`
+- **Network**: Overlay network `onebox-network` with `Attachable: true`
+- **Services vs Containers**: All workloads run as Swarm services (not standalone containers)
+
 ## Debugging Tips
 
 ### Backend Logs