Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents
Este artigo apresenta o Reversa, um framework multiagente que faz engenharia reversa de software legado para especificações operacionais rastreáveis para agentes de IA, extraindo regras implícitas, marcando explicitamente os níveis de confiança e preservando lacunas para validação humana, conforme demonstrado em um estudo de caso que migrou um sistema de caixa eletrônico de COBOL para Go.
Artigo original sob licença CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Esta é uma explicação gerada por IA do artigo abaixo. Não foi escrita nem endossada pelos autores. Para precisão técnica, consulte o artigo original. Ler aviso legal completo
Imagine que você tem uma biblioteca antiga e empoeirada, repleta de milhares de livros manuscritos. Esses livros contêm as regras para operar um banco, mas estão escritos em uma língua que ninguém fala mais (como COBOL), a tinta está desbotando e não há índice nem sumário. Os autores originais já se foram, e as únicas pessoas que sabem lê-los são alguns bibliotecários muito idosos que estão se aposentando.
Agora, imagine que você deseja contratar uma equipe de robôs superinteligentes e rápidos (agentes de IA) para reescrever essas regras em uma linguagem moderna (como Go), para que o banco possa funcionar em novos computadores. O problema? Se você apenas disser aos robôs: "Vão consertar isso", eles podem errar as suposições. Podem interpretar uma regra como significando uma coisa quando, na verdade, significa outra, e o banco pode colapsar.
Este artigo apresenta o Reversa, um novo framework projetado para resolver exatamente esse problema. Pense no Reversa não como uma varinha mágica que traduz código instantaneamente, mas como uma fábrica especializada de "Documentação Reversa".
Veja como funciona, usando analogias simples:
1. O Problema: O Sistema Legado "Silencioso"
Sistemas de software antigos são como uma casa onde o proprietário saiu há 20 anos. As luzes ainda estão acesas, a geladeira está zumbindo, mas ninguém sabe por que a luz da cozinha está ligada à porta da frente, ou o que acontece se você ligar o forno enquanto a máquina de lavar está funcionando. As regras estão escondidas dentro das paredes (o código). Se você tentar reformar sem conhecer essas regras ocultas, pode acidentalmente cortar a energia de todo o bairro.
2. A Solução: Uma Equipe de Detetives Robôs Especializados
Em vez de pedir a um único robô que leia toda a casa e adivinhe as regras, o Reversa envia uma equipe de agentes especializados, cada um com uma função específica, como uma linha de produção:
- O Explorador: Caminha pela casa primeiro. "Ok, há 5 cômodos, um porão e uma porta estranha na cozinha." (Mapeia a superfície do projeto).
- O Arqueólogo: Cava dentro das paredes. "Encontrei um projeto aqui que diz que este cano se conecta àquela válvula." (Analisa módulos).
- O Detetive: Procura por pistas. "Por que a luz está ligada à porta? Ah, as anotações dizem que é um recurso de segurança." (Extrai regras de negócios ocultas).
- O Arquiteto: Desenha um novo mapa com base no que foi encontrado. "Então, a cozinha é o coração da casa, e o porão abriga a água." (Sintetiza a arquitetura).
- O Escritor: Escreve as regras claramente. "Regra nº 1: Se a porta abrir, a luz acende." (Redige especificações).
- O Revisor: O mais importante. Eles verificam o trabalho do Escritor. "Espere, encontramos alguma nota sobre a luz? Não? Então não podemos afirmar com certeza. Vamos marcar isso como 'Talvez' ou 'Precisamos que um humano verifique isso'." (Revisa a confiança e as lacunas).
3. O Segredo: "Confiança" e "Lacunas"
A maioria das ferramentas de IA tenta soar 100% certa, mesmo quando estão adivinhando. O Reversa é diferente. Ele usa um sistema de semáforo para cada regra que encontra:
- 🟢 Verde (Confirmado): Encontramos isso no código. É um fato.
- 🟡 Amarelo (Inferido): Não encontramos uma nota direta, mas o padrão sugere isso. É uma suposição inteligente, mas tenha cuidado.
- 🔴 Vermelho (Lacuna): Não temos ideia. O código está faltando essa informação. Pare! Um humano precisa vir aqui e nos dizer o que fazer.
Isso é crucial. Impede que os robôs cometam erros com confiança. Diz ao humano: "Conhecemos 97% das regras, mas aqui estão os 3% onde precisamos da sua ajuda."
4. O Resultado: Um "Contrato" para os Robôs
A saída não é apenas um manual chato para humanos lerem. É um contrato operacional para os agentes de IA. Diz:
- "Aqui está o que o sistema faz."
- "Aqui está a prova (em qual arquivo do código antigo encontramos isso)."
- "Aqui está o que ainda não sabemos."
Isso permite que os agentes de IA reescrevam com segurança o sistema antigo (migração de COBOL para Go), pois possuem um mapa claro e sabem exatamente onde está a "neblina de guerra".
5. O Teste do Mundo Real: A Máquina de Caixa Eletrônico (ATM)
Os autores testaram isso em um projeto real (mas simples): um antigo caixa eletrônico escrito em COBOL que precisava ser reconstruído em Go.
- O Processo: Executaram o pipeline do Reversa.
- A Saída: O sistema produziu 517 "afirmações" (regras). Marcou 490 como fatos, 24 como suposições e encontrou 3 peças faltantes (lacunas).
- O Papel Humano: Humanos intervieram para resolver as peças faltantes e as "suposições".
- O Resultado: Criaram um plano para reconstruir o caixa eletrônico e escreveram 53 cenários de teste (como "Se eu inserir $20, devo receber $20 de volta"). Iniciaram com sucesso a reconstrução, completando 9 das 11 tarefas principais.
O Que Este Artigo Não Afirma
É importante saber o que este artigo não diz:
- Ele não afirma que isso é perfeito ou que funciona para cada sistema antigo no mundo ainda.
- Ele não afirma que os robôs podem fazer todo o trabalho sem humanos. Humanos ainda são necessários para corrigir as lacunas "Vermelhas".
- Ele não afirma que isso é mais rápido ou barato do que fazer do jeito antigo ainda. Eles apenas provaram que é possível e que cria um processo mais seguro e organizado.
Em Resumo
O Reversa é um framework que trata software antigo como uma cena de crime. Usa uma equipe de detetives de IA para mapear cuidadosamente o que o sistema faz, marcando explicitamente o que estão certos e o que estão adivinhando. Isso cria um "manual de instruções" seguro que permite que novos robôs de IA atualizem ou reescrevam sistemas antigos sem quebrá-los, mantendo humanos no ciclo para resolver os mistérios que os robôs não conseguem decifrar.
Afogado em artigos na sua área?
Receba digests diários dos artigos mais recentes que correspondam às suas palavras-chave de pesquisa — com resumos técnicos, no seu idioma.