diff --git a/wiki/decisions/2026-04-volume-persistence.md b/wiki/decisions/2026-04-volume-persistence.md
index 6443476..c01a340 100644
--- a/wiki/decisions/2026-04-volume-persistence.md
+++ b/wiki/decisions/2026-04-volume-persistence.md
@@ -24,4 +24,23 @@ Drei Container-Resets (4.-6. April 2026) durch LanceDB-Installation ohne persist
 
 - ✅ Volume funktioniert, Permission-Fix dokumentiert
 - ❌ `.brv-cli`-Volume nie deployed → OAuth-Token weiterhin Container-lebensdauer
-- ❌ ByteRover Knowledge Mining blockiert seit 2026-04-11
\ No newline at end of file
+- ❌ ByteRover Knowledge Mining blockiert seit 2026-04-11
+## Hintergrund — Warum das passierte
+
+Vor dieser Entscheidung lief der Bot-Container mit einem **ephemeren Filesystem** — kein persistentes Volume, kein Bind-Mount. Drei Probleme häuften sich in der ersten Aprilwoche:
+
+1. **LanceDB-Installation am 2026-04-04** verursachte einen Container-Reset, weil das Datenverzeichnis `~/.lancedb` auf dem Container-Filesystem lag und beim Rebuild verloren ging.
+2. **Memory-System (Schicht 3)** baute auf LanceDB auf — Reset bedeutete Totalverlust des Vektor-Index.
+3. **OAuth-Tokens** (ByteRover `.brv-cli`, Subconscious-Plugin-Tokens) wurden gleich mitverloren.
+
+Die Entscheidung am 2026-04-06 zog daraus die Konsequenz: **alles, was über Container-Lebensdauer hinaus leben soll, gehört auf ein gemountetes Volume** — nicht "manchmal" oder "für wichtige Daten", sondern ausnahmslos.
+
+## Konsequenzen
+
+Die strikte Volume-Pflicht wurde zur Grundlage für alle späteren Architekturentscheidungen: Memory-System, Wiki-Repository, Plugin-State. Siehe [[wiki/architecture/container-volume-persistence]] für die allgemeinen Lessons Learned und [[wiki/architecture/byterover-knowledge-mining]] für die konkrete Pipeline, die an genau dieser Lücke scheiterte.
+
+## Verwandte Seiten
+
+- [[wiki/architecture/container-volume-persistence]] — ausführliche Lessons-Learned
+- [[wiki/architecture/memory-system]] — Memory-Schichten, die alle auf dem Volume liegen
+- [[wiki/architecture/byterover-knowledge-mining]] — Pipeline, die an fehlendem `.brv-cli`-Volume starb