diff --git a/docs/chelsty-stability-agent.md b/kb/services/chelsty-stability-agent.md
similarity index 94%
rename from docs/chelsty-stability-agent.md
rename to kb/services/chelsty-stability-agent.md
index 9ed32ce..d828ddb 100644
--- a/docs/chelsty-stability-agent.md
+++ b/kb/services/chelsty-stability-agent.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-05-20
+links: []
+---
+
 ### CHELSTY Stability Agent
 
 The stability-agent on CHELSTY provides local observability and health monitoring for the node's services and infrastructure.
diff --git a/services/forgejo/README.md b/kb/services/forgejo.md
similarity index 70%
rename from services/forgejo/README.md
rename to kb/services/forgejo.md
index f2a46f0..d557760 100644
--- a/services/forgejo/README.md
+++ b/kb/services/forgejo.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-05-11
+links: []
+---
+
 # Forgejo
 
 Forgejo is a self-hosted lightweight software forge. Easy to install and low maintenance.
diff --git a/services/home-assistant/config/ken-legacy/README.md b/kb/services/home-assistant-ken-legacy.md
similarity index 83%
rename from services/home-assistant/config/ken-legacy/README.md
rename to kb/services/home-assistant-ken-legacy.md
index 8d50162..280325d 100644
--- a/services/home-assistant/config/ken-legacy/README.md
+++ b/kb/services/home-assistant-ken-legacy.md
@@ -1,3 +1,13 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: deprecated
+updated: 2026-07-22
+links: []
+superseded_by: "kb/services/home-assistant.md — instancja ken (HAOS na RPi4), archiwum importu 2026-07-22"
+---
+
 # ken-legacy — historical archive, do not deploy
 
 This directory holds the `/config` import of the **pre-migration** Home
diff --git a/hardware/esp/ir-ac-ha-integration/README.md b/kb/services/ir-ac-ha-integration.md
similarity index 96%
rename from hardware/esp/ir-ac-ha-integration/README.md
rename to kb/services/ir-ac-ha-integration.md
index f6e4744..e3be132 100644
--- a/hardware/esp/ir-ac-ha-integration/README.md
+++ b/kb/services/ir-ac-ha-integration.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-07-17
+links: []
+---
+
 # Gree IR Blaster
 
 ESPHome firmware for a Wemos D1 Mini (ESP8266) driving a Gree air conditioner
diff --git a/docs/joplin-server.md b/kb/services/joplin.md
similarity index 96%
rename from docs/joplin-server.md
rename to kb/services/joplin.md
index cb14499..1f053ac 100644
--- a/docs/joplin-server.md
+++ b/kb/services/joplin.md
@@ -1,3 +1,13 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: deprecated
+updated: 2026-04-15
+links: []
+superseded_by: "brak katalogu services/joplin/ w repo — patrz contradicts w kb/subsystems/repo-operating-contract.md"
+---
+
 # Joplin Server
 
 ## Description
diff --git a/services/kb-postgres/README.md b/kb/services/kb-postgres.md
similarity index 97%
rename from services/kb-postgres/README.md
rename to kb/services/kb-postgres.md
index a7baef2..e414799 100644
--- a/services/kb-postgres/README.md
+++ b/kb/services/kb-postgres.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-06-22
+links: []
+---
+
 # kb-postgres
 
 Postgres 16 + pgvector — KB spine on **PIHA** (Raspberry Pi 5, always-on). Stores the frozen envelope schema shared by all KB pillars (mails, documents, photos, transactions).
diff --git a/services/llm-gateway/README.md b/kb/services/llm-gateway.md
similarity index 95%
rename from services/llm-gateway/README.md
rename to kb/services/llm-gateway.md
index bc292e8..5029b82 100644
--- a/services/llm-gateway/README.md
+++ b/kb/services/llm-gateway.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-07-03
+links: []
+---
+
 # llm-gateway
 
 Small FastAPI router in front of Ollama on **SOLARIA**. Runs on the **PIHA**
diff --git a/services/mosquitto/README.md b/kb/services/mosquitto.md
similarity index 77%
rename from services/mosquitto/README.md
rename to kb/services/mosquitto.md
index a192122..d809584 100644
--- a/services/mosquitto/README.md
+++ b/kb/services/mosquitto.md
@@ -1,3 +1,13 @@
+---
+okf: "0.1"
+type: service
+visibility: public
+status: deprecated
+updated: 2026-07-29
+links: []
+superseded_by: "hosts/chelsty-infra/runtime/mosquitto/ (chelsty) + host systemd mosquitto na PIHA; decyzja topologii MQTT otwarta"
+---
+
 # Mosquitto MQTT Broker — NOT DEPLOYED / LEGACY
 
 > **Status (2026-07-28, truth cleanup):** this manifest matches **nothing that
diff --git a/services/npm/README.md b/kb/services/npm.md
similarity index 74%
rename from services/npm/README.md
rename to kb/services/npm.md
index 0c35cc9..0db1adc 100644
--- a/services/npm/README.md
+++ b/kb/services/npm.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-05-11
+links: []
+---
+
 # Nginx Proxy Manager (NPM)
 
 Expose your services easily and securely with Nginx Proxy Manager.
diff --git a/services/ollama/README.md b/kb/services/ollama.md
similarity index 69%
rename from services/ollama/README.md
rename to kb/services/ollama.md
index 0ccf627..29b148d 100644
--- a/services/ollama/README.md
+++ b/kb/services/ollama.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-05-11
+links: []
+---
+
 # Ollama
 
 Get up and running with large language models locally.
diff --git a/services/stability-agent/README.md b/kb/services/stability-agent.md
similarity index 96%
rename from services/stability-agent/README.md
rename to kb/services/stability-agent.md
index b4c31dd..9e3b01c 100644
--- a/services/stability-agent/README.md
+++ b/kb/services/stability-agent.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-05-17
+links: []
+---
+
 ### Stability Agent
 
 A lightweight filesystem-first watchdog and observer agent for homelab nodes.
diff --git a/services/vikunja/README.md b/kb/services/vikunja.md
similarity index 94%
rename from services/vikunja/README.md
rename to kb/services/vikunja.md
index 9bcdf76..6af1abb 100644
--- a/services/vikunja/README.md
+++ b/kb/services/vikunja.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-06-17
+links: []
+---
+
 # Vikunja
 
 Self-hosted task management. Runs on the **PIHA** node with a dedicated
diff --git a/services/zigbee2mqtt/README.md b/kb/services/zigbee2mqtt.md
similarity index 78%
rename from services/zigbee2mqtt/README.md
rename to kb/services/zigbee2mqtt.md
index 2f6826a..1b16b36 100644
--- a/services/zigbee2mqtt/README.md
+++ b/kb/services/zigbee2mqtt.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: service
+visibility: private
+status: active
+updated: 2026-05-29
+links: []
+---
+
 # Zigbee2MQTT
 
 Zigbee to MQTT bridge, get rid of your proprietary Zigbee bridges.