diff --git a/docs/kb/modules/00-piha-slim.md b/kb/phases/kb-m0-piha-slim.md
similarity index 96%
rename from docs/kb/modules/00-piha-slim.md
rename to kb/phases/kb-m0-piha-slim.md
index eea50ab..72fa71e 100644
--- a/docs/kb/modules/00-piha-slim.md
+++ b/kb/phases/kb-m0-piha-slim.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-02
+links: []
+---
+
 # Modul 0 — Odchudzic PIHA (prerekwizyt filaru dokumentow)
 
 > Prerekwizyt modulow 2/4 (Paperless/Nextcloud na PIHA). Bez tego PIHA nie ma
diff --git a/docs/kb/modules/02-paperless-service.md b/kb/phases/kb-m2-paperless.md
similarity index 95%
rename from docs/kb/modules/02-paperless-service.md
rename to kb/phases/kb-m2-paperless.md
index a1097d6..22b2a40 100644
--- a/docs/kb/modules/02-paperless-service.md
+++ b/kb/phases/kb-m2-paperless.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-01
+links: []
+---
+
 # Modul 2 — Paperless-ngx serwis (na PIHA)
 
 > Serwis dokumentow: UI+API+Postgres+Redis. Always-on na PIHA. OCR-worker OSOBNO
diff --git a/docs/kb/modules/03-paperless-ocr-worker.md b/kb/phases/kb-m3-ocr-worker.md
similarity index 95%
rename from docs/kb/modules/03-paperless-ocr-worker.md
rename to kb/phases/kb-m3-ocr-worker.md
index c2e838b..f7967ba 100644
--- a/docs/kb/modules/03-paperless-ocr-worker.md
+++ b/kb/phases/kb-m3-ocr-worker.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-01
+links: []
+---
+
 # Modul 3 — Paperless OCR-worker (SOLARIA + fallback PIHA)
 
 > Ciezki OCR odseparowany od serwisu. Worker na SOLARIA (moc), fallback PIHA (wolno).
diff --git a/docs/kb/modules/04-nextcloud.md b/kb/phases/kb-m4-nextcloud.md
similarity index 96%
rename from docs/kb/modules/04-nextcloud.md
rename to kb/phases/kb-m4-nextcloud.md
index 35ec72b..9264642 100644
--- a/docs/kb/modules/04-nextcloud.md
+++ b/kb/phases/kb-m4-nextcloud.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-02
+links: []
+---
+
 # Modul 4 — Nextcloud (drive/WebDAV + OIDC)
 
 > Drugi adapter dokumentow: zamiennik Google Drive, dowolne pliki + sync. Zrodlo
diff --git a/docs/kb/modules/05-documents-ingest.md b/kb/phases/kb-m5-documents-ingest.md
similarity index 97%
rename from docs/kb/modules/05-documents-ingest.md
rename to kb/phases/kb-m5-documents-ingest.md
index 70dae13..9c4c446 100644
--- a/docs/kb/modules/05-documents-ingest.md
+++ b/kb/phases/kb-m5-documents-ingest.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-02
+links: []
+---
+
 # Modul 5 — Ingest dokumentow -> koperta KB
 
 > Adapter obu zrodel (Paperless API + Nextcloud WebDAV) -> koperta KB. Domyka filar #2
diff --git a/docs/kb/eval/retrieval-pilot-2026-07-16.md b/kb/phases/kb-m5-eval-retrieval-pilot.md
similarity index 95%
rename from docs/kb/eval/retrieval-pilot-2026-07-16.md
rename to kb/phases/kb-m5-eval-retrieval-pilot.md
index 9e80d00..e4ccd39 100644
--- a/docs/kb/eval/retrieval-pilot-2026-07-16.md
+++ b/kb/phases/kb-m5-eval-retrieval-pilot.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-16
+links: []
+---
+
 # Eval-set: pilot retrieval (faza 2, krok 7) — 2026-07-16
 
 Stan bazy: document_chunk = 2683 chunki (bge-m3, dim 1024), 160 dokumentów z 186 kopert paperless.
diff --git a/docs/kb/modules/05-faza-mailowa-plan.md b/kb/phases/kb-m5-faza-mailowa.md
similarity index 99%
rename from docs/kb/modules/05-faza-mailowa-plan.md
rename to kb/phases/kb-m5-faza-mailowa.md
index d602cbb..9f2d702 100644
--- a/docs/kb/modules/05-faza-mailowa-plan.md
+++ b/kb/phases/kb-m5-faza-mailowa.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-23
+links: []
+---
+
 # Moduł 5, faza mailowa — treść maili w retrievalu (RECON + PLAN)
 
 > Status (2026-07-23): Kroki 0-4 WYKONANE na żywo (chunker wydzielony, hybrid
diff --git a/docs/kb/modules/05-faza2-plan.md b/kb/phases/kb-m5-faza2.md
similarity index 99%
rename from docs/kb/modules/05-faza2-plan.md
rename to kb/phases/kb-m5-faza2.md
index 40b15ba..996734d 100644
--- a/docs/kb/modules/05-faza2-plan.md
+++ b/kb/phases/kb-m5-faza2.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-13
+links: []
+---
+
 # Modul 5, faza 2 — koperta dokumentow + embeddingi + cross-source (RECON + PLAN)
 
 > Status: RECON ZAKONCZONY (2026-07-13), architektura DO ZATWIERDZENIA. Zaden kod nie
diff --git a/docs/kb/modules/05-faza3-plan.md b/kb/phases/kb-m5-faza3.md
similarity index 99%
rename from docs/kb/modules/05-faza3-plan.md
rename to kb/phases/kb-m5-faza3.md
index b2856cf..35176f6 100644
--- a/docs/kb/modules/05-faza3-plan.md
+++ b/kb/phases/kb-m5-faza3.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-17
+links: []
+---
+
 # Moduł 5, faza 3 — warstwa kompilacji (RECON + PLAN)
 
 > Status: RECON ZAKOŃCZONY (2026-07-16), plan DO ZATWIERDZENIA. Zero kodu, zero migracji,
diff --git a/docs/kb/modules/05-fallback-dedup-raport.md b/kb/phases/kb-m5-faza4-fallback-dedup.md
similarity index 99%
rename from docs/kb/modules/05-fallback-dedup-raport.md
rename to kb/phases/kb-m5-faza4-fallback-dedup.md
index a4ea3d7..5762ffa 100644
--- a/docs/kb/modules/05-fallback-dedup-raport.md
+++ b/kb/phases/kb-m5-faza4-fallback-dedup.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-30
+links: []
+---
+
 # Raport dedup: fallback embed SOLARIA→PIHA — e7625cd (master) vs 3d4ee38 (task/kb-f4-fallback)
 
 **Data**: 2026-07-30 · **Worktree**: `task/kb-fallback-dedup` · **Status**: salvage **wykonany**
diff --git a/docs/kb/modules/05-faza4-plan.md b/kb/phases/kb-m5-faza4.md
similarity index 99%
rename from docs/kb/modules/05-faza4-plan.md
rename to kb/phases/kb-m5-faza4.md
index 79dd35d..0e11693 100644
--- a/docs/kb/modules/05-faza4-plan.md
+++ b/kb/phases/kb-m5-faza4.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-22
+links: []
+---
+
 # Moduł 5, faza 4 — kb-query + UI (RECON + PLAN)
 
 > Status: RECON ZAKOŃCZONY (2026-07-22), plan DO ZATWIERDZENIA. Zero kodu, zero
diff --git a/docs/infra/okit-cloudflare-migracja.md b/kb/phases/okit-cloudflare.md
similarity index 96%
rename from docs/infra/okit-cloudflare-migracja.md
rename to kb/phases/okit-cloudflare.md
index 6494b19..09778ce 100644
--- a/docs/infra/okit-cloudflare-migracja.md
+++ b/kb/phases/okit-cloudflare.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-07
+links: []
+---
+
 # Migracja okit.pl: 42.pl (FreeDNS) -> Cloudflare — plan faz
 
 Cel: okit.pl na Cloudflare (jak kapala.org) -> wildcard *.okit.pl DNS-01 ->
diff --git a/docs/infra/prometheus-shadow-etap2-analiza-2026-07-15.md b/kb/phases/prometheus-cutover-etap2.md
similarity index 99%
rename from docs/infra/prometheus-shadow-etap2-analiza-2026-07-15.md
rename to kb/phases/prometheus-cutover-etap2.md
index 3561402..1bfc4dd 100644
--- a/docs/infra/prometheus-shadow-etap2-analiza-2026-07-15.md
+++ b/kb/phases/prometheus-cutover-etap2.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-15
+links: []
+---
+
 # Prometheus cutover — Etap 2: analiza zgodności shadow-run (2026-07-15)
 
 Analiza READ-ONLY logów `SHADOW_LIVENESS_MISMATCH` observera (parallel-run od
diff --git a/docs/architecture/PLAN-subsystem-a-2026-07-28.md b/kb/phases/subsystem-a-naprawa.md
similarity index 97%
rename from docs/architecture/PLAN-subsystem-a-2026-07-28.md
rename to kb/phases/subsystem-a-naprawa.md
index 7f17f65..986a1a0 100644
--- a/docs/architecture/PLAN-subsystem-a-2026-07-28.md
+++ b/kb/phases/subsystem-a-naprawa.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: phase
+visibility: private
+status: active
+updated: 2026-07-28
+links: []
+---
+
 # Plan naprawy subsystemu A (control-plane) — 2026-07-28
 
 Kontekst: docs/architecture/RECON-multiagent-2026-07-27.md. Decyzje bazowe: