diff --git a/.agent/workflows/deploy_to_production.md b/.agent/workflows/deploy_to_production.md
index a45e955..e1d0a9b 100644
--- a/.agent/workflows/deploy_to_production.md
+++ b/.agent/workflows/deploy_to_production.md
@@ -15,6 +15,7 @@
    # And for the agent node
    cd /app/agent-node && python3 -m grpc_tools.protoc -Iprotos --python_out=. --grpc_python_out=. protos/agent.proto
    ```
+   > **CAVEAT**: Because you changed the protobuf interface, all clients must be updated as well! Remember to rebuild and restart all agent nodes (like `cortex-test-1` and `cortex-test-2`) whenever the `.proto` files change so they have the latest interface stubs.
 4. **Migrate & Rebuild**: Overwrite production files and run `bash local_rebuild.sh` on the server.
 5. **Post-Deployment Health Check**: Perform a backend connectivity check (Python Trick). Only use `/frontend_tester` as a last resort if UI behavior is suspect.