Arquiteto de Migração de Código Legado com Agentes de IA — Human-in-the-Loop para Resultados Reproduzíveis

Pacote multi-arquivo (6 arquivos complementares) que transforma seu agente de IA em um Arquiteto Sênior de Plataformas de Migração de Código Legado. Não é um prompt solto: é um kit completo que leva o modelo de 'resposta plausível' a 'plano auditável e reproduzível', no mesmo padrão que um engenheiro de IA usa para levar um agente a ~99% de precisão numa tarefa real — a migração assistida por agentes.

O pacote é ancorado no caso real que dominou as discussões de engenharia recentes: a migração da suíte de testes React/Enzyme da Asana feita em 2 semanas (contra uma estimativa de ~5 anos / US$ 6M) usando OpenAI Codex com revisão humana duas vezes ao dia. A partir desse caso, o modelo aprende a desenhar a arquitetura do pipeline (análise, fatiamento independente, execução em sandbox, gate de revisão, verificação contínua) e a aplicá-la a QUALQUER migração sua: troca de framework de testes, mudança de runtime (.NET, Java→Kotlin, Python 2→3, Go), modernização de monolitos e até migração de banco.

CONTÉM:

• 01-prompt-principal.md — o prompt reusável de verdade, com persona de sistema, objetivo, formato de saída exigido (schema de 8 seções) e passo a passo de raciocínio.
• 02-regras-e-restricoes.md — guardrails imperativos: o que o modelo NUNCA deve fazer, casos de borda conhecidos (código sem testes, acoplamento oculto, god file, comportamento não-determinístico), como tratar informação faltante/ambígua, e o formato de erro exato quando não der para cumprir.
• 03-contexto-e-exemplos.md — glossário de domínio, premissas de ambiente + 2 exemplos completos few-shot (input → output esperado), incluindo um caso difícil com pedido vago e lacuna crítica.
• 04-harness-de-verificacao.md — checklist de autoverificação que o modelo roda ANTES de entregar, mais critérios objetivos de aceite (eliminatórios e de qualidade) que VOCÊ usa para validar as saídas.
• 05-templates-de-variacao.md — variações: modo curto/longo, adaptação para backend/runtime, migração de dados, e um script de kickoff do pipeline.
• 06-runbook-de-operacao.md — manual do operador: ciclos de execução, playbook do revisor, gatilhos de alerta e métricas de progresso.

Inclui ainda 3 diagramas de arquitetura em SVG (pipeline, gate de revisão e fatiamento) para usar na documentação do seu projeto.

PARA QUEM É: times de engenharia que querem adotar agentes de IA em tarefas de migração/modernização de código legado com segurança e controle humano, arquitetos de software, e engenheiros de plataforma que orquestram agentes em produção. POR QUE VALE MAIS: porque entrega 6 documentos complementares + 3 diagramas — não um parágrafo solto — com guardrails, few-shot e critérios de aceite prontos para o comprador validar as saídas do modelo de forma objetiva.