RESPOSTA
Como aposentar um sistema legado sem documentação?
Revisado em · Revisado por Paulo Pierrondi, fundador.
Dá para aposentar um sistema legado sem documentação, desde que a documentação seja reconstruída a partir do comportamento real antes do corte. Em vez de confiar em manuais desatualizados ou na memória de quem já saiu, você observa o que o sistema recebe e entrega, escreve isso como contrato de equivalência e só desliga quando o substituto prova, em paralelo, que entrega o mesmo resultado dentro do critério combinado.
Passo a passo
- Liste quem usa o sistema, para quê, e quais relatórios, integrações e arquivos dependem dele.
- Reconstrua o comportamento a partir de entradas e saídas reais, logs e dados históricos, não de manuais antigos.
- Transforme o que foi observado em um contrato de equivalência com regras, tolerâncias e critério de corte.
- Rode o substituto em paralelo com o legado e classifique cada divergência antes de olhar a taxa agregada.
- Corte por etapas, com plano de volta escrito e com a documentação nova guardada como evidência do processo.
Como um agente faz isso
Na AgenticosCore o contrato de equivalência vira a documentação que faltava. O Paralelo compara o agente com o sistema atual, a Trilha guarda cada execução e decisão, e o Evidence Pack reúne o que foi provado antes do corte, que continua sendo decisão sua.
Perguntas frequentes
Precisamos documentar o sistema inteiro antes de começar?
Não. Comece pelo processo que será aposentado primeiro e documente o comportamento dele. O resto do sistema pode continuar como está até chegar a vez dele.
E se ninguém da equipe original estiver mais na empresa?
Isso é comum. O comportamento observado em entradas, saídas e dados históricos substitui a memória da equipe, e quem opera o processo hoje valida o que foi encontrado.
Fontes primárias
- Managing legacy technology — GOV.UK
- Retiring service components securely — UK Government Security