Migrationshandbuch (Migration Runbook)

Ein Migrationshandbuch ist eine operative Schrittfolge für den Wechsel von einem Systemzustand in einen anderen. In KI- und Softwareprojekten beschreibt es nicht nur, was geändert werden soll, sondern in welcher Reihenfolge, mit welchen Prüfungen, durch wen und mit welchem Rückweg. Typische Inhalte sind Inventar der betroffenen Dienste, Abhängigkeiten, Testfälle, Verantwortlichkeiten, Zeitfenster, Kommunikationspunkte, Rollback-Kriterien und die genauen Kommandos oder Konfigurationsänderungen für den Wechsel. Der Unterschied zu einer losen Checkliste liegt in der Ausführbarkeit: Ein gutes Migrationshandbuch kann unter Zeitdruck abgearbeitet werden, ohne dass kritisches Wissen nur im Kopf einzelner Personen steckt. Bei Modell- oder API-Migrationen ist das besonders wichtig, weil alte Versionen oft zu einem festen Datum verschwinden. Dann reicht es nicht, eine neue Modellkennung einzutragen. Prompts, Kosten, Latenz, Tool-Aufrufe, Sicherheitsregeln und Qualitätsmetriken müssen vor dem Cutover geprüft sein. Das Migrationshandbuch macht diese Arbeit reproduzierbar und auditierbar. Es hält außerdem fest, welche Signale nach der Umstellung beobachtet werden und ab wann ein Rollback ausgelöst wird.