Refactoring ist eine Änderung am Code, die seine Struktur verbessert, ohne zu ändern, was die Software tut. Refactoring oder Neuschreiben ist eine Entscheidung darüber, wie viele Monate Roadmap Sie anhalten wollen. Meist gewinnt Refactoring in kleinen Schritten, denn das Produkt verdient währenddessen weiter Geld.
Neu schreiben lohnt sich in drei Fällen: Der Code tut das Falsche, er gehört Ihnen nicht, oder er läuft auf einer Technologie ohne Support. Unten finden Sie eine Entscheidungstabelle und ein Vorgehen, ohne die Roadmap zu stoppen.
KI schreibt heute unseren gesamten Code, für das Ergebnis haftet ein Senior. Filip hat davor jahrelang ein SaaS entwickelt, das täglich 60.000+ Menschen nutzten. Es wurde nie von Grund auf neu geschrieben. Es änderte sich in kleinen, reviewten Schritten, direkt im laufenden Produkt.
Warum ist ein großes Neuschreiben fast immer teurer, als es aussieht?
Neuschreiben wirkt sauber, weil neuer Code noch keine Geschichte hat. Genau diese Geschichte brauchen Sie aber. Hinter jeder seltsamen Bedingung im alten Code steckt meist eine Kundenbeschwerde.
Die häufigsten Gründe, warum Neuschreiben teuer wird:
Neu schreiben
Sie verlieren die Fixes. Alter Code enthält Jahre kleiner Korrekturen, und Kunden finden die Fehler erneut.
Sie zahlen für zwei Systeme. Bis die Neuentwicklung fertig ist, braucht das alte System Wartung und Funktionen.
Die Roadmap steht. Der Vertrieb wartet auf Funktionen, und das neue System kann anfangs weniger.
Das Ziel läuft davon. Bis die Neuentwicklung aufholt, hat das alte System neue Funktionen.
Keine dieser Kosten
Refactoring in kleinen Schritten
Das Produkt läuft und verdient weiter.
Kunden merken nichts.
Jede Änderung ist umkehrbar.
Neue Funktionen laufen parallel zum Refactoring.
Wann Refactoring, wann neu schreiben: eine Entscheidungstabelle
Situation
Unsere Empfehlung
Warum
Der Code tut das Richtige, lässt sich aber schwer ändern
Refactoring
Sie behalten das Verhalten und ändern nur die Form des Codes.
Es gibt keine Tests
Erst Tests, dann Refactoring
Ohne Tests wissen Sie nicht, was Sie kaputt gemacht haben.
Ein Teil bremst alles andere
Diesen Teil ersetzen, den Rest refaktorieren
Ein Modul hinter einer stabilen Schnittstelle ist beherrschbar.
Der Code tut das Falsche, das Geschäft hat sich geändert
Diesen Teil neu schreiben
Verhalten, das Sie nicht wollen, müssen Sie nicht erhalten.
Der Code gehört Ihnen nicht oder Sie haben keinen Zugriff
Neues System und Datenumzug
Es gibt nichts zu refaktorieren.
Die Technologie hat keinen Support und keine Sicherheitsupdates
Schrittweise Migration
Teil für Teil umziehen, nicht alles auf einmal.
Niemand im Team versteht den Code
Erst verstehen, dann entscheiden
Unverstandener Code ist kein Grund zum Neuschreiben. Er ist ein Grund für Tests.
Achten Sie auf die letzte Zeile. „Das versteht keiner“ ist das häufigste Argument fürs Neuschreiben. Und das schlechteste. Ein neues Team, das den alten Code nicht versteht, schreibt ihn ohne die Korrekturen neu, die darin stecken.
Neu schreiben ist auch der einfachste Upsell. Beim Audit des Produkts eines Gründers lag ein Monorepo und ein Backend-Rewrite in TypeScript nahe. Wir haben das Gegenteil geschrieben: Die Repositories sind in Ordnung, TypeScript Modul für Modul einführen und mit Login und Berechtigungen beginnen.
Wie refaktoriert man, ohne die Roadmap zu stoppen?
01
Tests für das heutige Verhalten
Beschreiben Sie zuerst, was das System heute tut, samt Fehlern. Erst dann ändern.
02
Kleine Schritte im normalen Ablauf
Kein Branch, der einen Monat lang nicht gemergt wird. Jede Änderung geht durch Review und CI.
03
Refaktorieren, wo Sie ein Feature bauen
Code, den einen Monat niemand anfasst, kann warten.
04
Den neuen Teil neben dem alten bauen
Schrittweise umschalten, bis Sie den alten abschalten können.
05
CI, das eine schlechte Änderung wirklich stoppt
Ein grüner Haken ohne Tests beweist nichts.
KI übernimmt hier das Langsame und Langweilige. Tests für bestehendes Verhalten, Code verschieben, umbenennen. Ein Senior entscheidet, was sich ändert und in welcher Reihenfolge. Welche Regeln wir der KI dafür geben, beschreiben wir in Regeln für KI-Code im Team.
Wenn du Tests hast, ist Refactoring leicht.
Filip Papranec
Gründer von Digitaliko
Ohne Tests und Review lässt KI Ihre technischen Schulden nur schneller wachsen. Deshalb sagen wir, ein Agent ist Modell plus Rahmen. Der Rahmen ist das, was eine schlechte Änderung stoppt.
Wann ist Neuschreiben die richtige Wahl?
Wenn Ihnen der Code nicht gehört. Gehört das alte System nicht Ihnen, gibt es nichts zu refaktorieren: Ein neues wird gebaut und die Daten ziehen um.
Auch beim Neuschreiben gilt dieselbe Reihenfolge. Zuerst die Daten und ein Verständnis dafür, was das System wirklich tut. Dann Bildschirm für Bildschirm, nicht alles an einem Tag.
Gehen Sie vor der Entscheidung sechs Punkte durch. Haken Sie ab, was für Ihr System gilt:
Am schwersten wiegt der vierte Punkt. Tut der Code das Richtige, nur schlecht, refaktorieren Sie.
Wann wir es nicht empfehlen
Sie haben einen Senior, der das System kennt und Zeit dafür hat. Refaktorieren Sie selbst. Die Tabelle oben reicht.
Das System wird in ein paar Monaten abgeschaltet. Investieren Sie nicht in Code, der endet. Investieren Sie in den Datenumzug.
Wollen Sie mit jemandem entscheiden, der das täglich macht?
Ein Senior steigt ab dem ersten Tag in Ihr Repository und Ihre Pull Requests ein. Erst Tests, dann Änderungen in kleinen Schritten, und die Roadmap läuft weiter. So arbeiten wir als externer Entwickler für Produktteams.
Schreiben Sie uns, welcher Teil des Codes Sie bremst. Wir melden uns innerhalb von zwei Arbeitstagen und wählen gemeinsam, was wir zuerst lösen.
Refactoring, wenn der Code das Richtige tut, sich aber schwer ändern lässt. Neu schreiben, wenn er das Falsche tut, der Code Ihnen nicht gehört oder die Technologie keinen Support mehr hat. Auch dann in Teilen, nicht auf einmal.
Kann man ohne Tests refaktorieren?
Man kann, aber es ist ein Glücksspiel. Schreiben Sie zuerst Tests für das heutige Verhalten, Fehler eingeschlossen. Erst dann ändern Sie den Code. Ohne Tests erfahren Sie vom Fehler durch einen Kunden.
Wie lange dauert ein Refactoring?
Es hat kein festes Ende, und das ist in Ordnung. Es passiert laufend in normalen Pull Requests, dort, wo Sie ohnehin arbeiten. Ein eigenes Refactoring-Projekt über Monate wird meist nie fertig.
Hilft KI beim Refactoring?
Ja, beim Schreiben von Tests, beim Verschieben von Code und beim Umbenennen. Was sich ändert und in welcher Reihenfolge, entscheidet ein Senior. Ohne Tests und Review macht KI Fehler nur schneller.
Fragen Sie eine KI zu diesem Artikel
Die KI nutzt dabei auch unsere anderen Artikel und Erfahrung aus echten Projekten.
Claude Code Pricing laut der öffentlichen Preisliste von Anthropic (Oktober 2026): Pro, Max, Team-Seats, Enterprise und API-Tokens. Was zu Entwicklern passt, worauf ein dauerhaft laufender Agent und ein CI-Reviewer laufen, und die Leitplanken, die einen Hintergrund-Agenten davon abhalten, das Budget zu verbrennen.
Wir haben Vercel nicht ersetzt, wir haben die Arbeit aufgeteilt. Next.js-Websites bleiben auf Vercel, neue Apps laufen auf Cloudflare Workers und D1, in TypeScript mit Alchemy beschrieben. Preise mit Quellen, unsere Konfiguration und der blockierte Deploy eines KI-Agenten.
Better Auth vs. Clerk entscheidet sich daran, wo Ihre Nutzer und Sessions liegen. Wir sind in jeder neuen App von NextAuth auf Better Auth gewechselt und haben Clerk nie gewählt. Unsere echte Konfiguration, die Plugins in Produktion, die Clerk-Preise und wann Clerk die bessere Wahl ist.
Zeit, mit dem Planen aufzuhören und das Problem zu lösen.