Field Notes · 6 Min.
Zuletzt geprüft: 6. Oktober 2026
Inhalt · 6 Abschnitte
Field Note: Was in eine vernünftige Projektübergabe gehört
Ich halte eine Projektübergabe erst dann für gelungen, wenn der nächste Entwickler nicht rekonstruieren muss, was der vorherige gedacht hat.
„Läuft“ ist kein Übergabestand
Bei einer Übergabe tauchen oft dieselben Dinge zuerst auf: ein Login, ein Repository und die Rückmeldung, dass das System läuft. Das ist nicht wertlos. Es beantwortet aber nur einen kleinen Teil der eigentlichen Frage: Kann jemand anderes verstehen, verändern und betreiben, was hier entstanden ist?
Ein Repository zeigt Code, aber nicht automatisch die Architektur dahinter. Ein Login öffnet eine Oberfläche, erklärt aber nicht, welche Dienste mit ihr verbunden sind. Und „läuft“ beschreibt einen Zustand – nicht, wie dieser Zustand zustande kommt oder was beim nächsten Deployment passieren soll.
Was dann fehlt, ist häufig kein einzelnes Dokument, sondern Zusammenhang. Welche Teile gehören zum System? Wo liegen Abhängigkeiten? Was wird automatisch ausgeführt? Welche externen Dienste sind beteiligt? Welche Sonderfälle wurden bewusst so gelöst, und welche Baustellen sind noch offen? Ohne diese Einordnung muss die übernehmende Person vieles aus dem Verhalten des Systems ableiten.
Das ist eine ungünstige Art, Wissen zu übertragen. Man sieht, was die Software tut, aber nicht unbedingt, warum sie es tut. Und wenn eine Entscheidung nicht sichtbar ist, kann eine spätere Änderung sie unbeabsichtigt rückgängig machen.
Mein erster Impuls war: mehr Punkte auf die Liste
Wenn Übergaben unvollständig sind, liegt der Reflex nahe, eine längere Checkliste zu schreiben. Welche Zugänge müssen übergeben werden? Welche Dateien gehören dazu? Was muss vor dem letzten Tag noch geprüft werden? Das kann helfen. Eine gute Übergabe enthält bereits eine praktische Checkliste; ich wiederhole sie hier nicht. Sie steht in „Was eine gute Übergabe enthält“.
Mit der Zeit ist mir klarer geworden: Eine Liste kann daran erinnern, etwas zu übergeben. Sie kann aber nicht von selbst den Zusammenhang herstellen. Ein Eintrag wie „Cronjobs dokumentiert“ sagt wenig, wenn nicht erkennbar ist, wofür sie laufen und was davon abhängt. „Externe Dienste“ aufzuzählen ist ebenfalls nicht dasselbe, wie ihre Rolle im System verständlich zu machen.
Die eigentliche Arbeit besteht deshalb nicht nur darin, Dinge zu sammeln. Ich muss entscheiden, welches Wissen für den nächsten sinnvollen Schritt wichtig ist. Was könnte jemand ändern müssen? Was sollte die Person vorher verstehen? Welche Annahme wäre gefährlich, wenn sie unbemerkt übernommen wird?
Dabei geht es nicht darum, jede Abwägung aus der Vergangenheit ausführlich zu protokollieren. Es geht darum, die Entscheidungen sichtbar zu machen, deren Fehlen später zu Rätselarbeit führt. Warum ist eine bestimmte Abhängigkeit vorhanden? Wo wird ein Prozess angestoßen? Was wurde bewusst nicht automatisiert? Welche Teile sind stabil, und wo ist noch Arbeit nötig? Eine knappe, klare Erklärung kann hier wertvoller sein als eine umfangreiche Beschreibung ohne Orientierung.
Übergabe heißt auch, Betriebswissen weiterzugeben
Ein digitales System besteht im Alltag nicht nur aus Quellcode. Es hängt an Daten, Einstellungen, Abläufen und Diensten, die außerhalb des sichtbaren Codes liegen können. Darum schaue ich bei einer Übergabe nicht nur darauf, ob die Software übergeben ist, sondern auch darauf, ob ihr Betrieb verständlich wird.
Dazu gehört, nachvollziehbar zu machen, wie Änderungen ihren Weg in die produktive Umgebung finden. Ebenso wichtig ist, welche automatisierten Abläufe regelmäßig oder durch bestimmte Ereignisse starten. Wenn ein Deployment, ein Cronjob oder eine externe Integration stillschweigend Teil des Systems ist, sollte die übernehmende Person nicht erst durch Zufall davon erfahren.
Auch bekannte Sonderfälle verdienen einen Platz. Nicht, weil jede Ausnahme für immer unverändert bleiben muss, sondern weil sie eine wichtige Spur sein kann. Vielleicht gibt es eine Regel, die auf den ersten Blick ungewöhnlich wirkt. Ohne Erklärung erscheint sie als unnötige Komplexität und wird womöglich entfernt. Mit etwas Kontext kann die nächste Person beurteilen, ob die Regel noch gebraucht wird oder ob sich inzwischen eine bessere Lösung anbietet.
Dasselbe gilt für offene Baustellen. Ein unfertiger Teil ist nicht automatisch ein Problem. Ein unerwähnter unfertiger Teil kann aber dazu führen, dass jemand ihn für abgeschlossen hält. Ich möchte lieber klar trennen können: Was ist bewusst fertig? Was funktioniert, hat aber Grenzen? Was wurde begonnen und muss noch entschieden oder umgesetzt werden?
Was ich heute anders mache: Ich behandle offene Punkte und bekannte Grenzen als Teil der Übergabe, nicht als Anhang, den man nur erwähnt, wenn noch Zeit bleibt. Sie helfen der nächsten Person, den tatsächlichen Zustand des Systems einzuschätzen.
Dokumentation ist kein Ersatz für Übergabe
Eine Übergabe ist ein Moment der Übertragung. Dokumentation ist das, was danach noch Orientierung geben kann. Beides gehört zusammen, ist aber nicht dasselbe. Eine Besprechung kann Zusammenhänge erklären und Rückfragen ermöglichen. Sie bleibt jedoch flüchtig, wenn das Wissen nirgends so festgehalten wird, dass es später wieder auffindbar ist.
Umgekehrt ersetzt ein Ordner voller Dokumente kein Gespräch. Ohne Einordnung ist schwer zu erkennen, was aktuell ist, was wichtig ist und wo man bei einer konkreten Änderung anfangen sollte. Eine gute Übergabe zeigt deshalb nicht nur auf vorhandene Unterlagen, sondern erklärt, wie sie zum System gehören und welche Fragen sie beantworten.
Ich denke dabei lieber von den Aufgaben aus, die nach der Übergabe anstehen könnten. Wenn jemand eine Änderung umsetzen soll, muss der aktuelle Zustand verständlich sein. Wenn die Änderung erfolgt ist, sollte sie sich überprüfen lassen. Dieses Denken passt zu meinem Arbeitsprinzip Know → Change → Prove: erst wissen, was vorhanden ist, dann gezielt verändern und anschließend belegen, was sich geändert hat. Wie ich dieses Prinzip auf WordPress-Änderungen anwende.
Eine technische Systemdokumentation kann diese Orientierung dauerhaft stützen. Sie muss nicht versuchen, jeden Gedanken festzuhalten. Entscheidend ist, dass sie die Architektur, wichtige Abhängigkeiten und relevante Abläufe so beschreibt, dass die nächste Person nicht bei null anfangen muss. Für WordPress-Systeme habe ich genauer beschrieben, was eine solche Dokumentation enthalten sollte.
Übergabe als Anfang, nicht als Schlussstrich
Eine vernünftige Projektübergabe macht ein System nicht automatisch einfach. Gewachsene Entscheidungen verschwinden nicht, nur weil sie aufgeschrieben wurden. Auch bleibt nicht jede Information für immer aktuell. Aber mit einer nachvollziehbaren Übergabe kann die nächste Person unterscheiden, was bekannt ist, was geprüft werden muss und was noch offen ist.
Für mich ist das der wichtige Unterschied: Ich muss nicht jede Entscheidung gutheißen, um sie verständlich zu machen. Die übernehmende Person soll sie prüfen und ändern können – ohne zuerst herausfinden zu müssen, dass es sie überhaupt gab. Genau dafür braucht es mehr als Zugänge und eine Erfolgsmeldung. Es braucht genug Kontext, um eigenständig weiterarbeiten zu können.
Meine Faustregel: Bei einer guten Projektübergabe kann die nächste Person den nächsten sinnvollen Schritt gehen, ohne die Gedanken des vorherigen Entwicklers rekonstruieren zu müssen.
Weiterführend
Verwandte Beiträge
Web-Architektur · 9 Min.
API-first Architektur: Wann eine API zum Kern des Systems gehörtErfahren Sie, wann eine API-first Architektur sinnvoll ist und wie Verträge, Versionierung und Betrieb die Entscheidung für komplexe digitale Systeme leiten.
KI & Automatisierung · 9 Min.
Automatische Recherche mit KI: Quellen prüfen und Ergebnisse belegenWie Unternehmen KI-Recherche mit Quellenregeln, Evidenz, Budgetgrenzen und Audit-Spur kontrollieren – für verlässliche Entscheidungen statt ungeprüfter Antworten.
Content & Sichtbarkeit · 10 Min.
Content-Audit: Inhalte sicher behalten, überarbeiten oder entfernenErfahren Sie, wie Geschäftsführung und Content-Verantwortliche Inhalte systematisch bewerten, Weiterleitungen planen und Entscheidungen dokumentieren.
Field Notes · 6 Min.
Field Note: Wie ich technische Entscheidungen dokumentiereIch halte technische Entscheidungen in vier Punkten fest: Problem, Optionen, Entscheidung und die Nachteile, die ich bewusst in Kauf nehme.