Wie man KI auf altem Legacy-Code loslassen kann, ohne etwas kaputtzumachen

Stellen Sie sich ein typisches Szenario vor: Sie haben ein Projekt mit fünf Jahren Geschichte geerbt. Es gibt keine Dokumentation, der ursprüngliche Codeautor ist vor drei Jahren ausgeschieden, und die Geschäftslogik ist über Hunderte von Dateien verstreut. Einen KI-Agent wie Claude Code oder Cursor mit einer solchen Codebasis zu verbinden, ist beängstigend. Sie bitten ihn, eine Funktion zu reparieren – er schreibt das benachbarte Modul um und zerstört implizite Abhängigkeiten, von denen niemand überhaupt wusste, dass sie existieren.

Kürzlich ist ein interessantes Tool namens Reversa auf GitHub erschienen, erstellt von einem Entwickler mit dem Benutzernamen sandeco. Das Framework löst dieses Problem auf originelle Weise: Es taucht in ein Legacy-Projekt ein, führt Reverse Engineering durch und transformiert den Quellcode in ausführbare Spezifikationen.

Warum Code durch Spezifikationen ersetzen

Die meisten Coding-Agents sind hervorragend darin, Projekte von Grund auf zu erstellen. Sie schreiben einen Prompt, das Tool generiert eine saubere Struktur und funktionierenden Code. Dieser Trick funktioniert nicht bei Legacy-Code. Wenn der Agent architektonische Einschränkungen und Kontext nicht versteht, arbeitet er blind.

Reversa fungiert als Brücke zwischen altem Code und modernen KI-Assistenten. Das Tool schreibt keine Dokumentation für Menschen im herkömmlichen Sinne. Stattdessen generiert es operative Verträge. Basierend darauf kann jeder Coding-Agent sofort die Spielregeln, Datenbanktabellen, Berechtigungsmatrizen und Algorithmen sehen, die nicht verletzt werden dürfen.

Wie der Forschungsprozess funktioniert

Die Installation erfolgt im Projektstammverzeichnis über einen einzigen Befehl:

npx reversa install

Der Installer erkennt automatisch installierte Engines im System – Cursor, Claude Code, Codex, Windsurf oder Copilot. Danach kopiert er Skill-Sets in das .agents/skills/ Verzeichnis und erstellt eine Konfigurationsdatei.

Wenn Sie den /reversa Befehl in Ihrem KI-Client ausführen, wird eine Pipeline von mehreren spezialisierten Agents gestartet. Jeder führt seine eigene Rolle im Analyseprozess aus:

• Scout scannt die Oberflächenstruktur, identifiziert Sprachen, Frameworks und Einstiegspunkte.
• Archaeologist taucht tief in Module ein, parst Datenstrukturen und komplexe Algorithmen.
• Detective extrahiert implizite Geschäftsregeln, Zustandsdiagramme und Zugriffsregeln.
• Architect kompiliert die gesammelten Daten in C4-Diagramme, ERD-Schemas und Integrationskarten.
• Writer formatiert die endgültigen Spezifikationen als Verträge mit Bindungen an bestimmte Codezeilen.

Ein interessantes Detail: Reversa markiert jede Aussage in den endgültigen Dokumenten mit einem speziellen Genauigkeits-Badge. Das 🟢-Symbol bedeutet, dass die Regel direkt durch Code mit Datei- und Zeilenreferenzen gestützt wird. Das 🟡-Symbol wird dort platziert, wo die KI eine logische Schlussfolgerung gezogen hat. Die rote Markierung 🔴 zeigt „Lücken