RESPOSTA
Como descobrir regras de negócio escondidas no legado?
Revisado em · Revisado por Paulo Pierrondi, fundador.
Regras de negócio escondidas aparecem quando você observa o que o sistema legado faz de verdade, não o que o manual diz. O caminho é registrar entradas e saídas reais durante um ciclo completo do processo, ler o código e os logs onde há exceções e transformar cada comportamento encontrado numa regra escrita, com dono, exemplo e critério de teste. Regra que não foi escrita não entra no contrato de equivalência, e o que fica fora do contrato vira surpresa no cutover.
Passo a passo
- Capture entradas e saídas reais durante um ciclo inteiro do processo, incluindo fechamento de mês e exceções sazonais.
- Leia o código, as procedures e os jobs agendados procurando condicionais, tabelas de parâmetros e valores fixos no código.
- Entreviste quem opera o processo e anote ajustes manuais, planilhas paralelas e contornos que viraram rotina.
- Escreva cada regra com dono, exemplo de entrada, saída esperada e a evidência de onde ela foi encontrada.
- Valide as regras rodando o substituto em paralelo e trate cada divergência nova como uma possível regra ainda não mapeada.
Como um agente faz isso
Na AgenticosCore a descoberta alimenta o contrato de equivalência. O agente roda em sombra no Paralelo, cada divergência vira candidata a regra na Trilha, e nenhuma regra nova entra no contrato sem a aprovação de um responsável seu.
Perguntas frequentes
Dá para descobrir as regras só lendo o código?
Raramente. Parte das regras vive em parâmetros, dados históricos e na prática da equipe. O código mostra o que pode acontecer, e a observação das saídas reais mostra o que acontece.
O que fazer com uma regra que ninguém sabe explicar?
Registre a regra com a evidência encontrada e defina um dono para decidir. Ela pode ser preservada, corrigida ou aposentada, mas a decisão precisa estar escrita antes do corte.
Fontes primárias
- Patterns of Legacy Displacement — martinfowler.com
- Managing legacy technology — GOV.UK