diff --git a/docs/architecture/ai-cluster-LEGACY.md b/kb/decisions/ai-cluster-legacy.md
similarity index 95%
rename from docs/architecture/ai-cluster-LEGACY.md
rename to kb/decisions/ai-cluster-legacy.md
index 05dc685..46604be 100644
--- a/docs/architecture/ai-cluster-LEGACY.md
+++ b/kb/decisions/ai-cluster-legacy.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: decision
+visibility: public
+status: active
+updated: 2026-07-30
+links: []
+---
+
 # ai-cluster — LEGACY, wygaszany (decyzja 2026-07-28)
 
 ## Decyzja
diff --git a/docs/architecture/ARCHITEKTURA.md b/kb/decisions/architektura-2026-07-28.md
similarity index 96%
rename from docs/architecture/ARCHITEKTURA.md
rename to kb/decisions/architektura-2026-07-28.md
index 30f270f..5a6cefe 100644
--- a/docs/architecture/ARCHITEKTURA.md
+++ b/kb/decisions/architektura-2026-07-28.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: decision
+visibility: private
+status: active
+updated: 2026-07-29
+links: []
+---
+
 # Architektura — decyzje obowiązujące
 
 Stan decyzji na 2026-07-28. Podstawa dowodowa:
diff --git a/docs/kb/modules/DECYZJE-do-podjecia.md b/kb/decisions/kb-dokumenty-otwarte.md
similarity index 98%
rename from docs/kb/modules/DECYZJE-do-podjecia.md
rename to kb/decisions/kb-dokumenty-otwarte.md
index 0e44445..8018060 100644
--- a/docs/kb/modules/DECYZJE-do-podjecia.md
+++ b/kb/decisions/kb-dokumenty-otwarte.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: decision
+visibility: private
+status: planned
+updated: 2026-07-09
+links: []
+---
+
 # Decyzje do podjęcia — filar dokumentów (moduły 2/3/4)
 
 > Zbiorcza lista decyzji z przygotowania configów (2026-07-06, branch
diff --git a/docs/kb/modules/01-sso-forgejo-oidc.md b/kb/decisions/sso-forgejo-oidc.md
similarity index 93%
rename from docs/kb/modules/01-sso-forgejo-oidc.md
rename to kb/decisions/sso-forgejo-oidc.md
index 3ffcac1..33333c6 100644
--- a/docs/kb/modules/01-sso-forgejo-oidc.md
+++ b/kb/decisions/sso-forgejo-oidc.md
@@ -1,3 +1,12 @@
+---
+okf: "0.1"
+type: decision
+visibility: private
+status: active
+updated: 2026-07-01
+links: []
+---
+
 # Modul 1 — SSO Forgejo-OIDC (decyzja + wzorzec wpiecia)
 
 > Fundament tozsamosci dla filaru dokumentow (i szerzej homelaba). Zapisuje decyzje
diff --git a/tech-debt.md b/kb/decisions/tech-debt-legacy.md
similarity index 86%
rename from tech-debt.md
rename to kb/decisions/tech-debt-legacy.md
index 12bd152..3b779f7 100644
--- a/tech-debt.md
+++ b/kb/decisions/tech-debt-legacy.md
@@ -1,3 +1,13 @@
+---
+okf: "0.1"
+type: decision
+visibility: private
+status: deprecated
+updated: 2026-06-24
+links: []
+superseded_by: "kb/phases/backlog.md (docs/backlog.md przejal ewidencje dlugu)"
+---
+
 # Tech Debt
 
 ## forgejo_runner (piha)