feat(openclaw): implement 9-agent specialist architecture and agents-as-code (ADR 0001)

k8s/openclaw/AGENTS.md

@@ -25,6 +25,21 @@ The multi-container pod structure is managed natively by the operator controller
 | `skill-stabilizer` | Retained under `spec.sidecars` to copy skills to the flat PVC structure |
 | `install-uv-python` (init) | Managed natively by the operator under `spec.runtimeDeps.python: true` |
 
+### 3. Multi-Agent Architecture & Agents-as-Code (ADR 0001)
+*   **Conductor**: The main session runs as the lean front-of-house coordinator (`SOUL.md`), handling fast actions (< 2s) directly with MCP tools and delegating complex domain tasks via `sessions_spawn`.
+*   **Specialist Subagents**: 9 specialized subagents defined as code in the knowledge wiki:
+    - 🩺 `agents/hebamme.md` (Baby development & sleep, pediatrician safety boundaries)
+    - 🍳 `agents/koch.md` (Ninja CREAMi Deluxe, Airfryer, KitchenAid, leftover utilization)
+    - 🏡 `agents/grabengasse.md` (Home Assistant, Hue, Sonos multiroom, Grabengasse 7)
+    - 🏰 `agents/regensburg.md` (Stadtamhof insider, RVV, playgrounds, local dining)
+    - ✈️ `agents/travel.md` (Vacation itineraries, packing lists, travel concierge)
+    - 🎬 `agents/media.md` (Jellyfin streaming/requests, Jellyseerr, Spotify audiobooks)
+    - 🔍 `agents/recherche.md` (Deep research, ALLRIS Stadtrat, Friday bridge tracking)
+    - 🛒 `agents/shopping.md` (Supermarket deals, Geizhals best prices, Bring! lists)
+    - 🏋️ `agents/fitness.md` (Garmin Connect 148 tools, Tacx Flux 2, home gym supersets)
+*   **Modifying & Adding Agents**: To update prompt logic, tone, or tool instructions for any agent, edit its markdown file directly in `knowledge-wiki/agents/<name>.md` and commit to git. No Kubernetes pod restarts required!
+*   **Multi-Turn Domain Stickiness**: When a conversation spans multiple turns in a subagent domain (e.g. refining a recipe or planning a trip), the Conductor detects domain continuity and routes to the same agent with the state bridge `<!-- DOMAIN_STATE -->`.
+
 ---
 
 ## 🔧 Applying Configuration Changes
@@ -34,7 +49,6 @@ To perform modifications or rotate api keys:
 2. **Declarative Base Config**: Edit fields under `spec.config.raw` in [openclaw-instance.secret.yaml](file:///Users/moritz/src/infrapuzzle/k8s/openclaw/openclaw-instance.secret.yaml).
 3. **Apply & Rollout**: Apply the files. The operator tracks config hashes and performs an automated rolling update of the StatefulSet automatically (no manual restart needed!):
    ```bash
-   kubectl apply -f k8s/openclaw/attachment-patch.yaml
    kubectl apply -f k8s/openclaw/openclaw.secret.yaml
    kubectl apply -f k8s/openclaw/openclaw-instance.secret.yaml
    kubectl apply -f k8s/openclaw/cronjob-wiki-backup.secret.yaml