For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Codex

Codex use case

Executar migrações de código

Migre pilhas tecnológicas legadas em etapas controladas.

Difficulty Avançado
Time horizon 1 h

Use o Codex para mapear um sistema legado para uma nova pilha tecnológica, realizar a migração em etapas e validar a paridade antes de cada transição.

Ideal para

  • Migrações de pilhas tecnológicas legadas para pilhas modernas, quando frameworks, ambientes de execução, sistemas de build ou convenções de plataforma precisam mudar.
  • Equipes que precisam de camadas de compatibilidade, transições em fases e validação explícita em cada ponto de controle da migração.

Contents

    ← Todos os casos de uso

    Executar migrações de código

    Migre pilhas tecnológicas legadas em etapas controladas.

    Use o Codex para mapear um sistema legado para uma nova pilha tecnológica, realizar a migração em etapas e validar a paridade antes de cada transição.

    Avançado
    1 h

    Use o Codex para mapear um sistema legado para uma nova pilha tecnológica, realizar a migração em etapas e validar a paridade antes de cada transição.

    Avançado
    1 h

    Ideal para

    • Migrações de pilhas tecnológicas legadas para pilhas modernas, quando frameworks, ambientes de execução, sistemas de build ou convenções de plataforma precisam mudar.
    • Equipes que precisam de camadas de compatibilidade, transições em fases e validação explícita em cada ponto de controle da migração.

    Habilidades e Plug-ins

    • Verifique migrações arriscadas, alterações em dependências e superfícies expostas antes de mesclar.
    • Resolva as falhas de CI após cada etapa da migração, em vez de deixar a limpeza para o final.
    • Use orientações específicas para o framework quando uma migração afetar modelos de aplicativos ASP.NET Core, `Program.cs`, middleware, testes, desempenho ou atualizações de versão.
    Skill Why use it
    Security Best Practices Verifique migrações arriscadas, alterações em dependências e superfícies expostas antes de mesclar.
    Gh Fix Ci Resolva as falhas de CI após cada etapa da migração, em vez de deixar a limpeza para o final.
    Aspnet Core Use orientações específicas para o framework quando uma migração afetar modelos de aplicativos ASP.NET Core, `Program.cs`, middleware, testes, desempenho ou atualizações de versão.

    Prompt inicial

    Migre esta base de código de [legacy stack or system] para [target stack or system]. Requisitos: - Comece fazendo um inventário das premissas do sistema legado: roteamento, modelos de dados, autenticação, configuração, ferramentas de build, testes, implantação e contratos externos. - Mapeie a pilha tecnológica antiga para a nova e destaque tudo o que não tiver equivalente direto. - Proponha um plano de migração incremental com camadas de compatibilidade ou pontos de controle, em vez de uma única grande reescrita. - Mantenha o comportamento inalterado, a menos que a migração exija explicitamente uma mudança visível para o usuário. - Trabalhe em etapas e execute o lint, a verificação de tipos e testes direcionados após cada etapa. - Mantenha visíveis as opções de reversão ou contingência até que a transição seja concluída. - Se a validação falhar, corrija o problema antes de continuar. - Comece mapeando tudo o que será afetado pela migração e propondo o plano de pontos de controle.
    Migre esta base de código de [legacy stack or system] para [target stack or system]. Requisitos: - Comece fazendo um inventário das premissas do sistema legado: roteamento, modelos de dados, autenticação, configuração, ferramentas de build, testes, implantação e contratos externos. - Mapeie a pilha tecnológica antiga para a nova e destaque tudo o que não tiver equivalente direto. - Proponha um plano de migração incremental com camadas de compatibilidade ou pontos de controle, em vez de uma única grande reescrita. - Mantenha o comportamento inalterado, a menos que a migração exija explicitamente uma mudança visível para o usuário. - Trabalhe em etapas e execute o lint, a verificação de tipos e testes direcionados após cada etapa. - Mantenha visíveis as opções de reversão ou contingência até que a transição seja concluída. - Se a validação falhar, corrija o problema antes de continuar. - Comece mapeando tudo o que será afetado pela migração e propondo o plano de pontos de controle.

    Introdução

    Ao migrar de uma pilha tecnológica para outra, você pode usar o Codex para mapear e executar uma migração controlada: roteamento, modelos de dados, configuração, autenticação, tarefas em segundo plano, ferramentas de build, implantação, testes ou até mesmo as próprias convenções da linguagem e do framework.

    O Codex é útil nesse processo porque pode fazer um inventário do sistema legado, mapear conceitos antigos para novos e implementar a mudança em etapas, em vez de realizar uma enorme reescrita de uma só vez. Isso é importante ao deixar de usar um framework legado, migrar para um novo ambiente de execução ou substituir gradualmente uma pilha tecnológica por outra enquanto o produto precisa continuar funcionando.

    Como usar

    1. Comece fazendo um inventário de tudo o que será afetado pela migração: pacotes legados, convenções do framework, roteamento, acesso a dados, autenticação, configuração, ferramentas de build, testes, premissas de implantação e todos os contratos externos que precisam ser preservados durante a migração.
    2. Peça ao Codex para mapear os conceitos legados para a pilha tecnológica de destino e destacar o que não tiver equivalente direto.
    3. Escolha uma estratégia incremental: camada de compatibilidade, migração módulo a módulo, ramificação por abstração ou substituição pelo padrão estrangulador, um limite por vez.
    4. Mantenha o comportamento estável até que a própria migração imponha uma mudança visível e identifique explicitamente essas exceções.
    5. Após cada etapa, execute a validação mínima capaz de comprovar a paridade: lint, verificação de tipos, testes direcionados, testes de contrato, testes de fumaça ou uma comparação lado a lado com o fluxo legado.
    6. Após cada ponto de controle, analise o diff e os riscos de transição ainda existentes, em vez de aguardar a reescrita completa.

    Use os ExecPlans

    Em nosso guia prático de modernização de código, apresentamos os ExecPlans: documentos que permitem ao Codex acompanhar a limpeza como um todo, detalhar o estado final pretendido e registrar a validação após cada iteração. Quando você pedir ao Codex para executar uma migração complexa, peça que ele crie um ExecPlan para cada parte do sistema, a fim de garantir que todas as decisões e escolhas de pilha tecnológica sejam registradas e possam ser revisadas depois.

    Combine com uma meta

    Em etapas de migração que levam mais tempo, use uma meta para orientar o Codex durante o trabalho. Defina a meta com um estado final claro, verificações de paridade, expectativas de reversão e uma condição de parada.

    Casos de uso relacionados