diff --git a/docs/access.md b/kb/subsystems/access-model.md
similarity index 83%
rename from docs/access.md
rename to kb/subsystems/access-model.md
index 9591b4f..46c2274 100644
--- a/docs/access.md
+++ b/kb/subsystems/access-model.md
@@ -1,3 +1,13 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: deprecated
+updated: 2026-04-15
+links: []
+superseded_by: "kb/subsystems/fleet-inventory.md + hosts/<node>/capabilities.yaml (stub z 2026-04-15, sprzed floty)"
+---
+
 # Access
 
 ## Description
diff --git a/services/agent-system/action-model.md b/kb/subsystems/action-approval-model.md
similarity index 95%
rename from services/agent-system/action-model.md
rename to kb/subsystems/action-approval-model.md
index 29c2253..14aad54 100644
--- a/services/agent-system/action-model.md
+++ b/kb/subsystems/action-approval-model.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: public
+status: active
+updated: 2026-05-20
+links: []
+---
+
 ### Action Approval Data Model
 
 Actions are JSON files stored in `/opt/homelab/actions/{status}/{action_id}.json`.
diff --git a/docs/agents.md b/kb/subsystems/agent-operating-procedures.md
similarity index 96%
rename from docs/agents.md
rename to kb/subsystems/agent-operating-procedures.md
index 8861c31..4bedc6a 100644
--- a/docs/agents.md
+++ b/kb/subsystems/agent-operating-procedures.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: public
+status: active
+updated: 2026-05-20
+links: []
+---
+
 # Agent Operating Procedures
 
 This document defines the operating procedures, constraints, and interaction protocols for non-human agents (AI agents, autonomous scripts) within the Homelab Codex ecosystem.
diff --git a/services/agent-system/README.md b/kb/subsystems/agent-system.md
similarity index 94%
rename from services/agent-system/README.md
rename to kb/subsystems/agent-system.md
index d433c86..3355204 100644
--- a/services/agent-system/README.md
+++ b/kb/subsystems/agent-system.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: active
+updated: 2026-05-17
+links: []
+---
+
 ### Agent System
 Central runtime materializer and Operator Control Plane UI.
 
diff --git a/docs/capabilities.md b/kb/subsystems/capability-model.md
similarity index 97%
rename from docs/capabilities.md
rename to kb/subsystems/capability-model.md
index 3c56b4b..809e9dd 100644
--- a/docs/capabilities.md
+++ b/kb/subsystems/capability-model.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: public
+status: active
+updated: 2026-05-20
+links: []
+---
+
 # Node Capability Model
 
 This document defines the capability model for the homelab infrastructure. The goal is to provide a declarative way to describe what each node can do, its constraints, and its suitability for various workloads.
diff --git a/docs/core-stack.md b/kb/subsystems/core-stack.md
similarity index 79%
rename from docs/core-stack.md
rename to kb/subsystems/core-stack.md
index bbd3064..2af5b62 100644
--- a/docs/core-stack.md
+++ b/kb/subsystems/core-stack.md
@@ -1,3 +1,13 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: deprecated
+updated: 2026-04-15
+links: []
+superseded_by: "kb/subsystems/fleet-inventory.md + hosts/<node>/capabilities.yaml (stub z 2026-04-15, sprzed floty)"
+---
+
 # Core Stack
 
 ## Description
diff --git a/docs/event-system.md b/kb/subsystems/event-system.md
similarity index 97%
rename from docs/event-system.md
rename to kb/subsystems/event-system.md
index acaae73..fe0ab63 100644
--- a/docs/event-system.md
+++ b/kb/subsystems/event-system.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: public
+status: active
+updated: 2026-05-12
+links: []
+---
+
 # Homelab Event System
 
 The homelab multi-agent platform uses a filesystem-first event architecture for observability, auditability, and agent reasoning.
diff --git a/docs/infra/inventory-verify-2026-07-02.md b/kb/subsystems/fleet-inventory-verify.md
similarity index 99%
rename from docs/infra/inventory-verify-2026-07-02.md
rename to kb/subsystems/fleet-inventory-verify.md
index 94402cb..409b4b2 100644
--- a/docs/infra/inventory-verify-2026-07-02.md
+++ b/kb/subsystems/fleet-inventory-verify.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: active
+updated: 2026-07-02
+links: []
+---
+
 # Weryfikacja inwentaryzacji floty 2026-06-30 — stan na 2026-07-02
 
 Zebrano: 2026-07-02 ~15:20 CEST (read-only recon, zero zmian na nodach).
diff --git a/docs/infra/inventory-2026-06-30.md b/kb/subsystems/fleet-inventory.md
similarity index 99%
rename from docs/infra/inventory-2026-06-30.md
rename to kb/subsystems/fleet-inventory.md
index f920612..35a57d5 100644
--- a/docs/infra/inventory-2026-06-30.md
+++ b/kb/subsystems/fleet-inventory.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: active
+updated: 2026-07-03
+links: []
+---
+
 # Inwentaryzacja floty homelab-codex — 2026-06-30
 
 Zebrano: 2026-06-30 17:09 CEST  
diff --git a/docs/kb/kb-02-documents-design.md b/kb/subsystems/kb-documents-pillar.md
similarity index 98%
rename from docs/kb/kb-02-documents-design.md
rename to kb/subsystems/kb-documents-pillar.md
index a153c73..51ee2aa 100644
--- a/docs/kb/kb-02-documents-design.md
+++ b/kb/subsystems/kb-documents-pillar.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: active
+updated: 2026-07-01
+links: []
+---
+
 # KB filar #2 — Dokumenty (Nextcloud + Paperless) — design
 
 > Dokument-master filaru dokumentow. Stoi pod `kb-00-overview.md`.
diff --git a/docs/kb/kb-01-email-design.md b/kb/subsystems/kb-mail-pillar.md
similarity index 97%
rename from docs/kb/kb-01-email-design.md
rename to kb/subsystems/kb-mail-pillar.md
index 39fd6b1..9db7766 100644
--- a/docs/kb/kb-01-email-design.md
+++ b/kb/subsystems/kb-mail-pillar.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: active
+updated: 2026-06-24
+links: []
+---
+
 # Filar maili — projekt (homelab-codex · KB · projekt #1)
 
 > Pierwszy filar. Wzorzec referencyjny dla pozostałych (archiwum, embeddingi na SOLARIA, szkielet agenta, deploy).
diff --git a/docs/services.md b/kb/subsystems/legacy-services-list.md
similarity index 85%
rename from docs/services.md
rename to kb/subsystems/legacy-services-list.md
index 522190b..52724b4 100644
--- a/docs/services.md
+++ b/kb/subsystems/legacy-services-list.md
@@ -1,3 +1,13 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: deprecated
+updated: 2026-04-15
+links: []
+superseded_by: "kb/subsystems/fleet-inventory.md + hosts/<node>/capabilities.yaml (stub z 2026-04-15, sprzed floty)"
+---
+
 # Services
 
 ## Description
diff --git a/docs/networking.md b/kb/subsystems/networking.md
similarity index 84%
rename from docs/networking.md
rename to kb/subsystems/networking.md
index b04f03b..ebcc25f 100644
--- a/docs/networking.md
+++ b/kb/subsystems/networking.md
@@ -1,3 +1,13 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: deprecated
+updated: 2026-04-15
+links: []
+superseded_by: "kb/subsystems/fleet-inventory.md + hosts/<node>/capabilities.yaml (stub z 2026-04-15, sprzed floty)"
+---
+
 # Networking
 
 ## Description
diff --git a/docs/observer-runtime.md b/kb/subsystems/observer.md
similarity index 98%
rename from docs/observer-runtime.md
rename to kb/subsystems/observer.md
index ab57a79..ca92f99 100644
--- a/docs/observer-runtime.md
+++ b/kb/subsystems/observer.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: public
+status: active
+updated: 2026-06-17
+links: []
+---
+
 # Observer Runtime
 
 The Observer Runtime is a lightweight agent responsible for synthesizing the operational world state of the homelab from raw events, logs, and state files.
diff --git a/docs/architecture/RECON-multiagent-2026-07-27.md b/kb/subsystems/recon-multiagent.md
similarity index 99%
rename from docs/architecture/RECON-multiagent-2026-07-27.md
rename to kb/subsystems/recon-multiagent.md
index ab637eb..50ce545 100644
--- a/docs/architecture/RECON-multiagent-2026-07-27.md
+++ b/kb/subsystems/recon-multiagent.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: active
+updated: 2026-07-30
+links: []
+---
+
 # Architecture Recon — multi-agent systems (2026-07-27)
 
 Read-only recon of the two multi-agent systems (control-plane, ai-cluster) across vps,
diff --git a/docs/service-model.md b/kb/subsystems/service-model.md
similarity index 96%
rename from docs/service-model.md
rename to kb/subsystems/service-model.md
index ec3d4ad..7d3a52e 100644
--- a/docs/service-model.md
+++ b/kb/subsystems/service-model.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: public
+status: active
+updated: 2026-05-11
+links: []
+---
+
 # Service Model and Healthchecks
 
 This document defines the normalized service model for the homelab.
diff --git a/docs/standards.md b/kb/subsystems/standards.md
similarity index 97%
rename from docs/standards.md
rename to kb/subsystems/standards.md
index 69e9318..1f42756 100644
--- a/docs/standards.md
+++ b/kb/subsystems/standards.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: public
+status: active
+updated: 2026-05-20
+links: []
+---
+
 # Infrastructure Standards
 
 This document defines the standards and conventions for the homelab GitOps-lite environment.
diff --git a/docs/topology.md b/kb/subsystems/topology.md
similarity index 95%
rename from docs/topology.md
rename to kb/subsystems/topology.md
index 31eb5c0..1796d88 100644
--- a/docs/topology.md
+++ b/kb/subsystems/topology.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: subsystem
+visibility: private
+status: active
+updated: 2026-05-11
+links: []
+---
+
 # Homelab Topology
 
 ## Nodes