diff --git a/docs/stability-agent-rollout.md b/kb/runbooks/stability-agent-rollout.md
similarity index 70%
rename from docs/stability-agent-rollout.md
rename to kb/runbooks/stability-agent-rollout.md
index 6a0093e..a72dd77 100644
--- a/docs/stability-agent-rollout.md
+++ b/kb/runbooks/stability-agent-rollout.md
@@ -1,16 +1,15 @@
+---
+okf: "0.1"
+type: runbook
+visibility: private
+status: active
+updated: 2026-05-17
+links:
+  - ../subsystems/stability-agent-architektura.md
+---
+
 # Stability Agent Multi-Node Rollout
 
-## Architecture Summary
-The `stability-agent` is a lightweight Python service that monitors node health (disk, Docker containers, Tailscale, MQTT) and publishes state to a central Redis instance running on **PIHA**.
-
-- **Source**: `services/stability-agent`
-- **State Path**: `/opt/homelab/state`
-- **Events Path**: `/opt/homelab/events`
-- **Redis Target**: `100.108.208.3:6379` (PIHA)
-
-## Why UI only showed CHELSTY
-Previously, the `stability-agent` had `NODE_NAME` defaulted to `chelsty` and was only deployed there. The Agent System UI materializer on PIHA filters nodes based on the Redis keys `homelab:nodes:<NODE_NAME>`. Without other agents publishing their specific `NODE_NAME`, the UI remained limited to the single active node.
-
 ## Deployment
 
 Use the helper script to deploy or generate commands. The script uses explicit Tailscale IPs for remote targets (piha, chelsty, vps) and runs locally for solaria.
diff --git a/kb/subsystems/stability-agent-architektura.md b/kb/subsystems/stability-agent-architektura.md
new file mode 100644
index 0000000..02f8160
--- /dev/null
+++ b/kb/subsystems/stability-agent-architektura.md
@@ -0,0 +1,23 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: active
+updated: 2026-05-17
+links:
+  - ../runbooks/stability-agent-rollout.md
+---
+
+# stability-agent — architektura rolloutu na flote
+
+## Architecture Summary
+The `stability-agent` is a lightweight Python service that monitors node health (disk, Docker containers, Tailscale, MQTT) and publishes state to a central Redis instance running on **PIHA**.
+
+- **Source**: `services/stability-agent`
+- **State Path**: `/opt/homelab/state`
+- **Events Path**: `/opt/homelab/events`
+- **Redis Target**: `100.108.208.3:6379` (PIHA)
+
+## Why UI only showed CHELSTY
+Previously, the `stability-agent` had `NODE_NAME` defaulted to `chelsty` and was only deployed there. The Agent System UI materializer on PIHA filters nodes based on the Redis keys `homelab:nodes:<NODE_NAME>`. Without other agents publishing their specific `NODE_NAME`, the UI remained limited to the single active node.
+