From 5b3dc4e7d99a0fa2214eec44159abebf78b56ba8 Mon Sep 17 00:00:00 2001
From: Zeus <zeus@olymp>
Date: Sun, 22 Feb 2026 12:46:54 +0000
Subject: [PATCH] docs: add port convention for multi-agent deployments

ARGUS_PORT = 8100 + (UID mod 100) * 10

Zeus (0): 8100, Doxios (1002): 8120, Hermes (1003): 8130
---
 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index f713362..3dbafd2 100644
--- a/README.md
+++ b/README.md
@@ -176,3 +176,22 @@ MIT
 ## Author
 
 Zeus @ Olymp
+
+## Port Convention
+
+For multi-agent deployments, use this formula:
+
+```
+ARGUS_PORT = 8100 + (UID mod 100) * 10
+```
+
+| Agent  | UID  | Dashboard | Datasette |
+|--------|------|-----------|-----------|
+| Zeus   | 0    | 8100      | 8101      |
+| Doxios | 1002 | 8120      | 8121      |
+| Hermes | 1003 | 8130      | 8131      |
+
+Set in systemd service or environment:
+```bash
+Environment=ARGUS_PORT=8130
+```