Normalize runtime repository layout

.gitignore

@@ -1,3 +1,6 @@
 __pycache__/
 *.py[cod]
 .aider*
+
+.idea/
+.vscode/

README.md

@@ -0,0 +1,52 @@
+# Agent System
+
+Distributed multi-agent runtime for the homelab environment.
+
+## Components
+
+- orchestrator
+- node-agent
+- monitor-agent
+- webui
+- redis event bus
+
+## Architecture
+
+The system operates as a lightweight distributed orchestration layer across homelab nodes connected via Tailscale.
+
+SATURN:
+- development
+- orchestration
+- source of truth
+
+SOLARIA:
+- compute workloads
+- GPU tasks
+- inference
+
+PIHA:
+- infrastructure services
+- Forgejo
+- MQTT
+- automation
+
+VPS:
+- public ingress
+- edge services
+
+## Development Flow
+
+1. Develop on SATURN
+2. Commit and push to Forgejo
+3. Execution nodes pull updates
+4. Containers redeploy via docker compose
+
+## Runtime
+
+Current runtime stack:
+- Redis
+- Orchestrator
+- WebUI
+- Monitor Agents
+- Node Agents
+