diff --git a/services/ha-diag-agent/DEPLOY.md b/kb/runbooks/ha-diag-agent-deploy.md
similarity index 98%
rename from services/ha-diag-agent/DEPLOY.md
rename to kb/runbooks/ha-diag-agent-deploy.md
index 680a9e6..a4ec62e 100644
--- a/services/ha-diag-agent/DEPLOY.md
+++ b/kb/runbooks/ha-diag-agent-deploy.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: runbook
+visibility: private
+status: active
+updated: 2026-06-11
+links: []
+---
+
 # ha-diag-agent Deployment Guide
 
 ## Section 1: Prerequisites
diff --git a/scripts/onboard/README.md b/kb/runbooks/node-onboarding-tool.md
similarity index 98%
rename from scripts/onboard/README.md
rename to kb/runbooks/node-onboarding-tool.md
index 35530af..d7ff09a 100644
--- a/scripts/onboard/README.md
+++ b/kb/runbooks/node-onboarding-tool.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: runbook
+visibility: private
+status: active
+updated: 2026-06-08
+links: []
+---
+
 # scripts/onboard — Node Onboarding Tool
 
 Idempotentny, deklaratywny onboarding nodów przez bash — bez Ansible.
diff --git a/docs/node-onboarding.md b/kb/runbooks/node-onboarding.md
similarity index 96%
rename from docs/node-onboarding.md
rename to kb/runbooks/node-onboarding.md
index 7d78665..b792ff9 100644
--- a/docs/node-onboarding.md
+++ b/kb/runbooks/node-onboarding.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: runbook
+visibility: public
+status: active
+updated: 2026-05-12
+links: []
+---
+
 # Node Onboarding Workflow
 
 This document describes the process of onboarding a new Linux machine into the homelab platform.
diff --git a/scripts/npm/README.md b/kb/runbooks/npm-api.md
similarity index 98%
rename from scripts/npm/README.md
rename to kb/runbooks/npm-api.md
index 06f270d..4f6611c 100644
--- a/scripts/npm/README.md
+++ b/kb/runbooks/npm-api.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: runbook
+visibility: private
+status: active
+updated: 2026-08-03
+links: []
+---
+
 # npm_api.py — sterowanie Nginx Proxy Manager przez REST API
 
 CLI do zarzadzania dwoma instancjami NPM (PIHA, VPS) bez klikania w web UI.
diff --git a/docs/infra/ollama-solaria-cutover-2026-07-15.md b/kb/runbooks/ollama-solaria-cutover.md
similarity index 98%
rename from docs/infra/ollama-solaria-cutover-2026-07-15.md
rename to kb/runbooks/ollama-solaria-cutover.md
index a902631..bbce353 100644
--- a/docs/infra/ollama-solaria-cutover-2026-07-15.md
+++ b/kb/runbooks/ollama-solaria-cutover.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: runbook
+visibility: private
+status: active
+updated: 2026-07-16
+links: []
+---
+
 # Ollama SOLARIA: manual → declarative cutover runbook
 
 Date: 2026-07-15