Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents
Este artículo presenta Reversa, un marco de trabajo multiagente que ingeniería inversa el software heredado para obtener especificaciones operativas rastreables para agentes de IA mediante la extracción de reglas implícitas, la marcación explícita de los niveles de confianza y la preservación de lagunas para la validación humana, tal como se demuestra en un estudio de caso que migra un sistema de cajero automático de COBOL a Go.
Artículo original bajo licencia CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Esta es una explicación generada por IA del artículo a continuación. No ha sido escrita ni avalada por los autores. Para mayor precisión técnica, consulte el artículo original. Leer descargo de responsabilidad completo
Imagina que tienes una biblioteca antigua y polvorienta llena de miles de libros manuscritos. Estos libros contienen las reglas para administrar un banco, pero están escritos en un idioma que nadie habla ya (como COBOL), la tinta se está desvaneciendo y no hay índice ni tabla de contenidos. Los autores originales han desaparecido hace mucho tiempo, y las únicas personas que saben leerlos son unos pocos bibliotecarios muy ancianos que se están jubilando.
Ahora, imagina que quieres contratar a un equipo de robots superinteligentes y rápidos (agentes de IA) para reescribir estas reglas en un lenguaje moderno (como Go) para que el banco pueda funcionar en computadoras nuevas. ¿El problema? Si simplemente le dices a los robots: "Arregla esto", podrían adivinar mal. Podrían pensar que una regla significa una cosa cuando en realidad significa otra, y el banco podría colapsar.
Este artículo presenta Reversa, un nuevo marco diseñado para resolver exactamente este problema. Piensa en Reversa no como una varita mágica que traduce código instantáneamente, sino como una fábrica especializada de "Documentación Inversa".
Así es como funciona, usando analogías simples:
1. El Problema: El Sistema Heredado "Silencioso"
Los sistemas de software antiguos son como una casa donde el propietario se fue hace 20 años. Las luces siguen encendidas, el refrigerador zumba, pero nadie sabe por qué la luz de la cocina está cableada a la puerta principal, o qué sucede si enciendes el horno mientras la lavadora está funcionando. Las reglas están ocultas dentro de las paredes (el código). Si intentas renovar sin conocer estas reglas ocultas, podrías apagar accidentalmente la electricidad de todo el vecindario.
2. La Solución: Un Equipo de Detectives Robot Especializados
En lugar de pedirle a un robot que lea toda la casa y adivine las reglas, Reversa envía un equipo de agentes especializados, cada uno con un trabajo específico, como una línea de producción:
- El Explorador: Recorre la casa primero. "Bien, hay 5 habitaciones, un sótano y una puerta extraña en la cocina". (Mapea la superficie del proyecto).
- El Arqueólogo: Excava en las paredes. "Encontré un plano aquí que dice que esta tubería se conecta a esa válvula". (Analiza los módulos).
- El Detective: Busca pistas. "¿Por qué la luz está cableada a la puerta? Ah, las notas dicen que es una característica de seguridad". (Extrae reglas de negocio ocultas).
- El Arquitecto: Dibuja un nuevo mapa basado en lo encontrado. "Así que la cocina es el corazón de la casa, y el sótano contiene el agua". (Sintetiza la arquitectura).
- El Escritor: Escribe las reglas claramente. "Regla #1: Si la puerta se abre, la luz se enciende". (Escribe especificaciones).
- El Revisor: El más importante. Verifica el trabajo del Escritor. "Espera, ¿encontramos una nota sobre la luz? ¿No? Entonces no podemos decirlo con certeza. Marquemos esto como 'Quizás' o 'Necesitamos que un humano verifique esto'". (Revisa la confianza y las brechas).
3. El Secreto: "Confianza" y "Brechas"
La mayoría de las herramientas de IA intentan sonar 100% seguras, incluso cuando están adivinando. Reversa es diferente. Utiliza un sistema de semáforo para cada regla que encuentra:
- 🟢 Verde (Confirmado): Encontramos esto en el código. Es un hecho.
- 🟡 Amarillo (Inferido): No encontramos una nota directa, pero el patrón sugiere esto. Es una suposición inteligente, pero ten cuidado.
- 🔴 Rojo (Brecha): No tenemos idea. El código carece de esta información. ¡Alto! Un humano debe venir aquí y decirnos qué hacer.
Esto es crucial. Evita que los robots cometan errores con confianza. Le dice al humano: "Conocemos el 97% de las reglas, pero aquí están el 3% donde necesitamos tu ayuda".
4. El Resultado: Un "Contrato" para los Robots
La salida no es solo un manual aburrido para que los humanos lo lean. Es un contrato operativo para los agentes de IA. Dice:
- "Esto es lo que hace el sistema".
- "Aquí está la prueba (en qué archivo del código antiguo lo encontramos)".
- "Esto es lo que aún no sabemos".
Esto permite a los agentes de IA reescribir el sistema antiguo de forma segura (migrar de COBOL a Go) porque tienen un mapa claro y saben exactamente dónde está la "niebla de guerra".
5. La Prueba del Mundo Real: La Máquina de Cajero Automático
Los autores probaron esto en un proyecto real (pero simple): una antigua máquina de cajero automático escrita en COBOL que necesitaba ser reconstruida en Go.
- El Proceso: Ejecutaron la tubería de Reversa.
- La Salida: El sistema produjo 517 "afirmaciones" (reglas). Marcó 490 como hechos, 24 como suposiciones y encontró 3 piezas faltantes (brechas).
- El Rol Humano: Los humanos intervinieron para resolver las piezas faltantes y las "suposiciones".
- El Resultado: Crearon un plan para reconstruir el cajero automático y escribieron 53 escenarios de prueba (como "Si ingreso $20, debería recibir $20 de vuelta"). Comenzaron exitosamente la reconstrucción, completando 9 de las 11 tareas principales.
Lo Que Este Artículo No Afirma
Es importante saber lo que este artículo no dice:
- No afirma que esto sea perfecto o que funcione para cada sistema antiguo del mundo todavía.
- No afirma que los robots puedan hacer todo el trabajo sin humanos. Los humanos aún son necesarios para arreglar las brechas "Rojas".
- No afirma que esto sea más rápido o barato que hacerlo a la antigua todavía. Solo demostraron que es posible y que crea un proceso más seguro y organizado.
En Resumen
Reversa es un marco que trata el software antiguo como una escena del crimen. Utiliza un equipo de detectives de IA para mapear cuidadosamente lo que hace el sistema, marcando explícitamente en qué están seguros y en qué están adivinando. Esto crea un "manual de instrucciones" seguro que permite a nuevos robots de IA actualizar o reescribir sistemas antiguos sin romperlos, mientras mantiene a los humanos en el ciclo para resolver los misterios que los robots no pueden descifrar.
¿Ahogado en artículos de tu campo?
Recibe resúmenes diarios de los artículos más novedosos que coincidan con tus palabras clave de investigación — con resúmenes técnicos, en tu idioma.