Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents
Cet article présente Reversa, un cadre multi-agent qui rétro-ingénierie les logiciels hérités en spécifications opérationnelles traçables pour les agents IA en extrayant des règles implicites, en marquant explicitement les niveaux de confiance et en préservant les lacunes pour une validation humaine, comme le démontre une étude de cas migrant un système de distributeur automatique de billets du COBOL vers Go.
Article original sous licence CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Ceci est une explication générée par l'IA de l'article ci-dessous. Elle n'a pas été rédigée ni approuvée par les auteurs. Pour une précision technique, consultez l'article original. Lire la clause de non-responsabilité complète
Imaginez une vieille bibliothèque poussiéreuse remplie de milliers de livres manuscrits. Ces livres contiennent les règles de fonctionnement d'une banque, mais ils sont rédigés dans une langue que plus personne ne parle (comme le COBOL), l'encre s'efface et il n'y a ni table des matières ni index. Les auteurs originaux sont depuis longtemps disparus, et les seules personnes capables de les lire sont quelques bibliothécaires très âgés qui partent à la retraite.
Maintenant, imaginez que vous souhaitiez engager une équipe de robots super-intelligents et rapides (agents IA) pour réécrire ces règles dans un langage moderne (comme Go) afin que la banque puisse fonctionner sur de nouveaux ordinateurs. Le problème ? Si vous dites simplement aux robots : « Réparez cela », ils pourraient se tromper. Ils pourraient interpréter une règle comme signifiant une chose alors qu'elle en signifie une autre, et la banque pourrait s'effondrer.
Ce papier présente Reversa, un nouveau cadre conçu pour résoudre exactement ce problème. Ne voyez pas Reversa comme une baguette magique traduisant instantanément le code, mais plutôt comme une usine spécialisée de « Documentation Inverse ».
Voici comment cela fonctionne, en utilisant des analogies simples :
1. Le Problème : Le Système Hérité « Silencieux »
Les anciens systèmes logiciels sont comme une maison dont le propriétaire est parti il y a 20 ans. Les lumières sont toujours allumées, le réfrigérateur bourdonne, mais personne ne sait pourquoi la lumière de la cuisine est câblée à la porte d'entrée, ou ce qui se passe si vous allumez le four pendant que la machine à laver tourne. Les règles sont cachées à l'intérieur des murs (le code). Si vous tentez de rénover sans connaître ces règles cachées, vous risquez de couper accidentellement l'électricité de tout le quartier.
2. La Solution : Une Équipe de Détectives Robots Spécialisés
Au lieu de demander à un seul robot de lire toute la maison et de deviner les règles, Reversa envoie une équipe d'agents spécialisés, chacun ayant un travail spécifique, comme sur une chaîne de production :
- L'Éclaireur : Parcourt d'abord la maison. « D'accord, il y a 5 pièces, un sous-sol et une porte étrange dans la cuisine. » (Cartographie la surface du projet).
- L'Archéologue : Fouille dans les murs. « J'ai trouvé un plan ici indiquant que ce tuyau se connecte à cette vanne. » (Analyse les modules).
- Le Détective : Cherche des indices. « Pourquoi la lumière est-elle câblée à la porte ? Ah, les notes indiquent qu'il s'agit d'une fonctionnalité de sécurité. » (Extrait les règles métier cachées).
- L'Architecte : Dessine une nouvelle carte basée sur ce qui a été trouvé. « Donc, la cuisine est le cœur de la maison, et le sous-sol contient l'eau. » (Synthétise l'architecture).
- Le Rédacteur : Écrit les règles clairement. « Règle n°1 : Si la porte s'ouvre, la lumière s'allume. » (Rédige les spécifications).
- Le Réviseur : Le plus important. Il vérifie le travail du Rédacteur. « Attendez, avons-nous trouvé une note concernant la lumière ? Non ? Alors nous ne pouvons pas affirmer cela avec certitude. Notons cela comme « Peut-être » ou « Nous avons besoin qu'un humain vérifie cela ». » (Examine la confiance et les lacunes).
3. L'Ingrédient Secret : La « Confiance » et les « Lacunes »
La plupart des outils d'IA tentent de sembler sûrs à 100 %, même lorsqu'ils devinent. Reversa est différent. Il utilise un système de feux de circulation pour chaque règle qu'il trouve :
- 🟢 Vert (Confirmé) : Nous avons trouvé cela dans le code. C'est un fait.
- 🟡 Jaune (Inféré) : Nous n'avons pas trouvé de note directe, mais le motif suggère cela. C'est une hypothèse intelligente, mais soyez prudent.
- 🔴 Rouge (Lacune) : Nous n'en savons rien. Le code manque cette information. Arrêtez ! Un humain doit venir ici et nous dire quoi faire.
Ceci est crucial. Cela empêche les robots de commettre des erreurs avec assurance. Cela indique à l'humain : « Nous connaissons 97 % des règles, mais voici les 3 % où nous avons besoin de votre aide. »
4. Le Résultat : Un « Contrat » pour les Robots
La sortie n'est pas simplement un manuel ennuyeux à lire pour les humains. C'est un contrat opérationnel pour les agents IA. Il indique :
- « Voici ce que fait le système. »
- « Voici la preuve (dans quel fichier du vieux code nous l'avons trouvé). »
- « Voici ce que nous ne savons pas encore. »
Cela permet aux agents IA de réécrire en toute sécurité l'ancien système (migration du COBOL vers Go) car ils disposent d'une carte claire et savent exactement où se trouve le « brouillard de guerre ».
5. Le Test Réel : Le Distributeur Automatique de Billets (DAB)
Les auteurs ont testé cela sur un projet réel (mais simple) : un vieux distributeur automatique de billets écrit en COBOL qui devait être reconstruit en Go.
- Le Processus : Ils ont exécuté le pipeline Reversa.
- La Sortie : Le système a produit 517 « affirmations » (règles). Il en a marqué 490 comme des faits, 24 comme des hypothèses, et a trouvé 3 pièces manquantes (lacunes).
- Le Rôle Humain : Les humains sont intervenus pour résoudre les pièces manquantes et les « hypothèses ».
- Le Résultat : Ils ont créé un plan pour reconstruire le DAB et ont rédigé 53 scénarios de test (comme « Si je dépose 20 $, je devrais recevoir 20 $ »). Ils ont lancé avec succès la reconstruction, achevant 9 tâches majeures sur 11.
Ce Que Ce Papier Ne Prétend Pas
Il est important de savoir ce que ce papier ne dit pas :
- Il ne dit pas que c'est parfait ou que cela fonctionne pour chaque ancien système du monde pour l'instant.
- Il ne prétend pas que les robots peuvent faire tout le travail sans humains. Les humains sont toujours nécessaires pour corriger les lacunes « Rouges ».
- Il ne prétend pas que c'est plus rapide ou moins cher que de le faire à l'ancienne pour l'instant. Ils ont seulement prouvé que c'est possible et que cela crée un processus plus sûr et mieux organisé.
En Résumé
Reversa est un cadre qui traite l'ancien logiciel comme une scène de crime. Il utilise une équipe de détectives IA pour cartographier soigneusement ce que fait le système, en marquant explicitement ce dont ils sont sûrs et ce qu'ils devinent. Cela crée un « manuel d'instructions » sûr permettant aux nouveaux robots IA de mettre à jour ou de réécrire d'anciens systèmes sans les casser, tout en gardant les humains dans la boucle pour résoudre les mystères que les robots ne peuvent pas élucider.
Noyé(e) sous les articles dans votre domaine ?
Recevez des digests quotidiens des articles les plus récents correspondant à vos mots-clés de recherche — avec des résumés techniques, dans votre langue.