Refactoring

Refactoring scheitert selten am Umbauen selbst — es scheitert davor und danach. Deshalb decken die 24 Agenten dieser Kategorie den ganzen Bogen ab: Der Readiness-Assessor bewertet mit Hotspot-Ranking und Risikoeinstufung, ob und wo sich ein Umbau überhaupt lohnt. Der Scope-Splitter zerteilt beschlossene Vorhaben in unabhängig mergebare Etappen. Und wenn Tests fehlen, pinnen Charakterisierungstests zuerst das beobachtete Ist-Verhalten, bevor du eine Zeile anfasst.

Für die eigentliche Arbeit stehen spezialisierte Agenten bereit: Funktionen zerlegen bei unveränderter Signatur, if/else-Kaskaden vereinfachen, toten Code belegen und sicher entfernen, zirkuläre Abhängigkeiten auflösen, Altsysteme per Strangler-Muster ablösen. Am Ende prüft das Verification-Gate mit Diff-Analyse, Testlauf und Coverage-Delta, ob der Umbau wirklich verhaltensgleich ist — und fällt ein klares Ja/Nein-Urteil vor dem Merge. Jeder Agent liefert einen festen Output-Vertrag statt vager Ratschläge.

Typische Aufgaben

• Eine 500-Zeilen-Funktion ohne Tests umbauen: Charakterisierungstests pinnen erst das Ist-Verhalten, dann zerlegt der Extract-Function-Agent bei unveränderter öffentlicher Signatur.
• Ein Altsystem schrittweise ablösen: Der Strangler-Migration-Agent plant Routing-Fassade, Modul-Reihenfolge und messbare Abschalt-Kriterien.
• Einen Umbau, der einen PR sprengt, mit dem Scope-Splitter in unabhängig mergebare Etappen schneiden — samt Abhängigkeitsgraph und Prüfkriterium je Etappe.
• Vor dem Merge prüfen, ob der Umbau verhaltensgleich ist: Das Verification-Gate klassifiziert jede Änderung, wertet Testlauf und Coverage-Delta aus und fällt ein Ja/Nein-Urteil.

Alle 24 Agenten in kv-refactor

Jede Zeile ist eine Datei im ausgelieferten Paket — Name identisch mit dem Ordner im Download.

• kv-refactor-api-surface-tidy Vereinheitlicht gewachsene öffentliche Schnittstellen: Signaturen, Parameterobjekte, Deprecation-Hinweise.
• kv-refactor-async-untangle Entwirrt Callback-Hölle zu linearem Ablauf — das Nebenläufigkeits-Verhalten bleibt unverändert.
• kv-refactor-backward-compat-shim Erstellt eine Kompatibilitätsschicht mit Deprecation-Wrappern, Migrationshinweis und Entfern-Zeitplan.
• kv-refactor-branch-by-abstraction Plant Komponententausch im laufenden Betrieb: Abstraktionsschicht, Alt/Neu parallel, stufenweises Umschalten.
• kv-refactor-characterization-tests Erstellt Charakterisierungstests, die das beobachtete Ist-Verhalten vor einem Umbau festschreiben.
• kv-refactor-conditional-simplifier Vereinfacht verschachtelte if/else-Kaskaden zu lesbarer Logik mit nachweislich identischem Verhalten.
• kv-refactor-config-extraction Externalisiert Magic Numbers und hartcodierte Werte in benannte Konstanten samt vollständigem Mapping.
• kv-refactor-data-model-restructure Restrukturiert Datenmodelle mit Werttypen, gebündelten Feldern und Migrationspfad für alle Aufrufer.
• kv-refactor-dead-code-sweeper Spürt ungenutzte Funktionen und verwaiste Imports auf — belegte Liste toten Codes mit Entfern-Plan.
• kv-refactor-dependency-decoupler Löst zirkuläre Abhängigkeiten auf: Entkopplungs-Plan mit Interfaces, Dependency-Inversion und Zyklus-Abbau.
• kv-refactor-duplication-dedup Konsolidiert kopierte Code-Blöcke in eine extrahierte gemeinsame Einheit und stellt alle Aufrufer um.
• kv-refactor-error-handling-unify Erstellt ein einheitliches Fehlerkonzept mit konsistenten Pfaden und Liste behobener stiller Schlucker.
• kv-refactor-extract-function Zerlegt überlange, verschachtelte Funktionen in klar benannte Einheiten — öffentliche Signatur unverändert.
• kv-refactor-layering-enforcer Auditiert Schicht-Grenzen, listet Verletzungen und plant die Wiederherstellung definierter Schnittstellen.
• kv-refactor-legacy-seams Führt Bruchstellen in festverdrahteten Legacy-Code ein — eine Seam-Karte macht ihn isolierbar und testbar.
• kv-refactor-module-boundaries Schneidet überladene Dateien in Module — Modul-Schnittplan mit Abhängigkeitskarte vorher und nachher.
• kv-refactor-pattern-introducer Plant den begründeten Einsatz eines Entwurfsmusters — mit ausdrücklicher Warnung vor Over-Engineering.
• kv-refactor-perf-preserving Macht heiße Pfade lesbarer — mit Vorher/Nachher-Messprotokoll und Beleg der Nicht-Regression.
• kv-refactor-readiness-assessor Bewertet vor dem Umbau, ob und wo sich Refactoring lohnt — Readiness-Report mit Hotspot-Ranking.
• kv-refactor-rename-symbols Ersetzt irreführende oder nichtssagende Bezeichner durch präzise Namen — konsistent über alle Referenzen.
• kv-refactor-scope-splitter Zerteilt zu große Umbauten in einen geordneten Schnittplan mit unabhängig mergebaren Etappen.
• kv-refactor-smell-catalog Erstellt eine annotierte Smell-Liste mit Fundstelle, Typ, Schweregrad und vorgeschlagenem Refactoring-Schritt.
• kv-refactor-strangler-migration Plant die schrittweise Ablösung eines Altsystems: Routing-Fassade, Modul-Reihenfolge, Abschalt-Kriterien.
• kv-refactor-verification-gate Prüft, ob ein Refactoring verhaltensgleich ist — Gate-Report mit Diff-Analyse, Testlauf und Ja/Nein-Urteil.