RESPOSTA

O que é um contrato de equivalência?

Revisado em · Revisado por Paulo Pierrondi, fundador.

Um contrato de equivalência — o Equivalence Contract — é o critério escrito que diz o que precisa bater entre o sistema legado e o substituto antes do corte. Ele fixa campos, tolerâncias, blockers e as exceções que podem ser aprovadas com dono, justificativa e validade. Não é um percentual genérico de acerto: uma diferença pequena pode ser material, enquanto uma diferença grande de formatação pode ser irrelevante. No dual-run o legado continua em comando e o substituto não tem efeito em produção. O corte só vem depois, com aprovação humana, rollback ensaiado e um Evidence Pack que registra diffs, owners e o caminho de volta. Legacy Exit usa esse contrato para decidir com prova, não com fé.

Passo a passo

  • Liste outputs, campos críticos e regras de negócio que serão comparados.
  • Defina tolerância por campo e classe de risco, não um único percentual global.
  • Classifique previamente blocker, diferença material e diferença cosmética.
  • Nomeie dono, justificativa e validade para cada exceção aprovada.
  • Feche o contrato antes do dual-run: aprovadores, evidências mínimas e rollback ensaiado.

Como um agente faz isso

Na AgenticosCore, o Equivalence Contract orienta o Paralelo. Cada comparação e exceção entra na Trilha; Regras da Casa impedem o avanço fora dos critérios; e o Freio mantém o rollback operacionalmente acessível. Exceção aprovada entra no Evidence Pack com owner, justificativa e validade. O Equivalence Contract está em /recursos/contrato-de-equivalencia/.

Perguntas frequentes

O contrato de equivalência desliga o sistema legado?

Não. O contrato é o critério da comparação. Durante o dual-run o legado continua operando e o substituto não tem efeito em produção. O desligamento é decisão posterior, com aprovação humana e rollback.

Exceção sem dono entra no contrato?

Não. Toda exceção precisa de dono, justificativa e validade, registradas no Evidence Pack. Sem isso, a diferença continua blocker.

Fontes primárias