# Portabilitaet: UNIVERSAL
# Zuletzt validiert: 2026-01-28 (Gemini)
# Naechste Pruefung: 2027-01-28
# Quellen: [skills/_protocols/migrate-rename.md]

EVOLUTIONAERE MIGRATION (MIGRATE RENAME)
========================================

Stand: 2026-01-28

DAS PROBLEM: TOTALITÄRE MIGRATIONEN SCHEITERN
---------------------------------------------
In vernetzten Systemen (wie BACH mit vielen KI-Partnern, Scripts und Doku) ist es unmoeglich, ALLE Referenzen auf eine Datei gleichzeitig zu kennen und zu aendern.
Eine "harte" Umbenennung (`mv old new`) fuehrt zu "Broken Links" und Fehlern an unerwarteten Stellen (z.B. in einem 3 Wochen alten Prompt im Cache).

DIE LÖSUNG: EVOLUTIONAERES GLEITEN
----------------------------------
Statt eines harten Schnitts nutzen wir eine Uebergangsphase. Wir akzeptieren, dass alte Verweise existieren, und fangen sie ab.

DAS "WRAPPER" KONZEPT
---------------------
Wenn `alte_datei.md` zu `neue_datei.md` wird:
1. `neue_datei.md` enthaelt den echten Content.
2. `alte_datei.md` wird NICHT geloescht, sondern zu einem "Wrapper" (Stub).

Inhalt des Wrappers:
- **Status:** "Moved to..."
- **Link:** Klickbarer Verweis zum neuen Ziel.
- **Log-Tabelle:** Ein "Gästebuch" fuer verirrte Besucher.

SELF-HEALING (DER LERNEFFEKT)
-----------------------------
Wenn ein User oder eine KI auf dem Wrapper landet:
1. Sie finden den Weg zum Ziel (Link).
2. Sie merken: "Mein Bookmark/Prompt ist veraltet."
3. Sie aktualisieren ihre eigene Referenz.

So reinigt sich das System selbst ueber die Zeit ("Organisches Update").

CLEANUP
-------
Nach einer Karenzzeit (z.B. 30 Tage ohne Log-Eintraege) kann der Wrapper gefahrlos geloescht werden. Das System hat sich "ausgeheilt".

SIEHE AUCH
----------
skills/_protocols/migrate-rename.md      Workflow-Schritte
docs/help/practices.txt                       Architekturprinzipien
