💻 computer science

Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents

Dieser Beitrag stellt Reversa vor, ein Multi-Agenten-Framework, das Legacy-Software durch Extraktion impliziter Regeln, explizites Kennzeichnen von Konfidenzniveaus und Bewahren von Lücken für die menschliche Validierung in nachvollziehbare operative Spezifikationen für KI-Agenten reverse-engineert, wie in einer Fallstudie zur Migration eines Geldautomatensystems von COBOL nach Go demonstriert wird.

Ursprüngliche Autoren: Sanderson Oliveira de Macedo, Ronaldo Martins da Costa

Veröffentlicht 2026-05-19

📖 5 Min. Lesezeit🧠 Tiefgang

CC BY 4.0

Ursprüngliche Autoren: Sanderson Oliveira de Macedo, Ronaldo Martins da Costa

Originalarbeit lizenziert unter CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). ✨ Dies ist eine KI-generierte Erklärung des untenstehenden Papers. Sie wurde nicht von den Autoren verfasst oder gebilligt. Für technische Genauigkeit konsultieren Sie das Originalpaper. Vollständigen Haftungsausschluss lesen

Stellen Sie sich vor, Sie haben eine alte, staubige Bibliothek, die mit Tausenden handgeschriebener Bücher gefüllt ist. Diese Bücher enthalten die Regeln für den Betrieb einer Bank, sind jedoch in einer Sprache verfasst, die niemand mehr spricht (wie COBOL), die Tinte verblasst und es gibt keine Inhaltsverzeichnisse oder Register. Die ursprünglichen Autoren sind längst fort, und die einzigen Personen, die sie lesen können, sind ein paar sehr alte Bibliothekare, die in den Ruhestand gehen.

Stellen Sie sich nun vor, Sie möchten ein Team aus superscharfsinnigen, schnellen Robotern (KI-Agenten) einstellen, um diese Regeln in eine moderne Sprache (wie Go) umzuschreiben, damit die Bank auf neuen Computern laufen kann. Das Problem? Wenn Sie den Robotern einfach sagen: „Reparieren Sie das", könnten sie falsch raten. Sie könnten denken, eine Regel bedeute etwas anderes, als sie tatsächlich bedeutet, und die Bank könnte abstürzen.

Diese Arbeit stellt Reversa vor, ein neues Framework, das genau dieses Problem lösen soll. Denken Sie an Reversa nicht als Zauberstab, der Code sofort übersetzt, sondern als eine spezialisierte „Reverse-Dokumentations"-Fabrik.

So funktioniert es, unter Verwendung einfacher Analogien:

1. Das Problem: Das „stille" Legacy-System

Alte Softwaresysteme sind wie ein Haus, dessen Besitzer vor 20 Jahren gegangen ist. Die Lichter brennen noch, der Kühlschrank summt, aber niemand weiß, warum das Küchenlicht mit der Vordertür verdrahtet ist oder was passiert, wenn Sie den Ofen einschalten, während die Waschmaschine läuft. Die Regeln sind in den Wänden (dem Code) versteckt. Wenn Sie versuchen, zu renovieren, ohne diese versteckten Regeln zu kennen, könnten Sie versehentlich die Stromversorgung für die ganze Nachbarschaft abschalten.

2. Die Lösung: Ein Team spezialisierter Roboter-Detektive

Anstatt einen Roboter zu bitten, das ganze Haus zu lesen und die Regeln zu erraten, schickt Reversa ein Team spezialisierter Agenten hinein, jeder mit einer spezifischen Aufgabe, wie in einer Produktionslinie:

Der Kundschafter: Geht zuerst durch das Haus. „Okay, es gibt 5 Zimmer, einen Keller und eine seltsame Tür in der Küche." (Kartiert die Projektoberfläche).
Der Archäologe: Gräbt in den Wänden. „Ich habe hier einen Bauplan gefunden, der besagt, dass dieses Rohr mit diesem Ventil verbunden ist." (Analysiert Module).
Der Detektiv: Sucht nach Hinweisen. „Warum ist das Licht mit der Tür verdrahtet? Ah, die Notizen sagen, es ist eine Sicherheitsfunktion." (Extrahiert versteckte Geschäftsregeln).
Der Architekt: Zeichnet eine neue Karte basierend auf dem Gefundenen. „Also ist die Küche das Herz des Hauses, und der Keller beherbergt das Wasser." (Synthetisiert die Architektur).
Der Schreiber: Schreibt die Regeln klar auf. „Regel Nr. 1: Wenn die Tür öffnet, geht das Licht an." (Schreibt Spezifikationen).
Der Prüfer: Der wichtigste. Er überprüft die Arbeit des Schreibers. „Warten Sie, haben wir eine Notiz über das Licht gefunden? Nein? Dann können wir nicht sicher sein. Markieren wir dies als 'Vielleicht' oder 'Wir benötigen einen Menschen zur Prüfung'." (Überprüft Sicherheit und Lücken).

3. Das Geheimnis: „Sicherheit" und „Lücken"

Die meisten KI-Tools versuchen, auch beim Raten zu 100 % sicher zu klingen. Reversa ist anders. Es verwendet ein Ampelsystem für jede gefundene Regel:

🟢 Grün (Bestätigt): Wir haben dies im Code gefunden. Es ist eine Tatsache.
🟡 Gelb (Abgeleitet): Wir haben keine direkte Notiz gefunden, aber das Muster deutet darauf hin. Es ist eine kluge Vermutung, aber seien Sie vorsichtig.
🔴 Rot (Lücke): Wir haben keine Ahnung. Dem Code fehlt diese Information. Stop! Ein Mensch muss hierher kommen und uns sagen, was zu tun ist.

Das ist entscheidend. Es verhindert, dass Roboter selbstbewusst Fehler machen. Es sagt dem Menschen: „Wir kennen 97 % der Regeln, aber hier sind die 3 %, bei denen wir Ihre Hilfe benötigen."

4. Das Ergebnis: Ein „Vertrag" für die Roboter

Die Ausgabe ist nicht nur ein langweiliges Handbuch für Menschen. Es ist ein operativer Vertrag für die KI-Agenten. Er besagt:

„Hier ist, was das System tut."
„Hier ist der Beweis (in welcher Datei im alten Code wir es gefunden haben)."
„Hier ist, was wir noch nicht wissen."

Dies ermöglicht es den KI-Agenten, das alte System sicher umzuschreiben (Migration von COBOL zu Go), da sie eine klare Karte haben und genau wissen, wo der „Nebel des Krieges" liegt.

5. Der Realwelt-Test: Der Geldautomat

Die Autoren testeten dies an einem realen (aber einfachen) Projekt: einem alten Geldautomaten in COBOL, der in Go neu aufgebaut werden musste.

Der Prozess: Sie führten die Reversa-Pipeline aus.
Die Ausgabe: Das System erzeugte 517 „Behauptungen" (Regeln). Es markierte 490 als Fakten, 24 als Vermutungen und fand 3 fehlende Teile (Lücken).
Die Rolle des Menschen: Menschen schritten ein, um die fehlenden Teile und die „Vermutungen" zu klären.
Das Ergebnis: Sie erstellten einen Plan für den Neubau des Geldautomaten und schrieben 53 Testszenarien (wie „Wenn ich 20 $ einwerfe, sollte ich 20 $ zurückbekommen"). Sie starteten erfolgreich den Neubau und schlossen 9 von 11 Hauptaufgaben ab.

Was diese Arbeit nicht behauptet

Es ist wichtig zu wissen, was diese Arbeit nicht sagt:

Sie behauptet nicht, dass dies perfekt ist oder dass es bereits für jedes einzelne alte System der Welt funktioniert.
Sie behauptet nicht, dass die Roboter den ganzen Job ohne Menschen erledigen können. Menschen werden immer noch benötigt, um die „Rot"-Lücken zu beheben.
Sie behauptet nicht, dass dies schneller oder günstiger ist als die alte Methode noch. Sie haben nur bewiesen, dass es möglich ist und dass es einen sichereren, organisierteren Prozess schafft.

Zusammenfassung

Reversa ist ein Framework, das alte Software wie einen Tatort behandelt. Es nutzt ein Team von KI-Detektiven, um sorgfältig zu kartieren, was das System tut, und markiert explizit, wovon sie sicher sind und wovon sie nur raten. Dies schafft ein sicheres „Bedienhandbuch", das es neuen KI-Robotern ermöglicht, alte Systeme zu aktualisieren oder umzuschreiben, ohne sie zu beschädigen, während Menschen im Kreis bleiben, um die Rätsel zu lösen, die die Roboter nicht herausfinden können.