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
Theme
Codex

Codex use case

Migrar código

Migre stacks legadas em etapas e valide cada uma.

Difficulty Advanced
Time horizon 1h

Use o Codex para mapear as correspondências entre o sistema legado e a nova stack, fazer a migração em etapas e verificar se o comportamento é equivalente antes de cada transição.

Best for

  • Migrações de stacks legadas para stacks modernas que exigem mudanças em frameworks, ambientes de execução, sistemas de build ou convenções da plataforma.
  • Equipes que precisam de camadas de compatibilidade, transições graduais e validação explícita em cada ponto de verificação da migração.

Contents

    ← All use cases

    Migrar código

    Migre stacks legadas em etapas e valide cada uma.

    Use o Codex para mapear as correspondências entre o sistema legado e a nova stack, fazer a migração em etapas e verificar se o comportamento é equivalente antes de cada transição.

    Advanced
    1h

    Use o Codex para mapear as correspondências entre o sistema legado e a nova stack, fazer a migração em etapas e verificar se o comportamento é equivalente antes de cada transição.

    Advanced
    1h

    Best for

    • Migrações de stacks legadas para stacks modernas que exigem mudanças em frameworks, ambientes de execução, sistemas de build ou convenções da plataforma.
    • Equipes que precisam de camadas de compatibilidade, transições graduais e validação explícita em cada ponto de verificação da migração.

    Skills & Plugins

    • Antes do merge, revise as migrações de maior risco, as mudanças nas dependências e as partes do sistema que ficam expostas.
    • Resolva as falhas de CI ao fim de cada etapa da migração, sem acumular correções para o final.
    • Siga as orientações específicas do framework quando a migração envolver modelos de aplicativo do ASP.NET Core, `Program.cs`, middleware, testes, desempenho ou atualizações de versão.
    Skill Why use it
    Security Best Practices Antes do merge, revise as migrações de maior risco, as mudanças nas dependências e as partes do sistema que ficam expostas.
    Gh Fix Ci Resolva as falhas de CI ao fim de cada etapa da migração, sem acumular correções para o final.
    Aspnet Core Siga as orientações específicas do framework quando a migração envolver modelos de aplicativo do ASP.NET Core, `Program.cs`, middleware, testes, desempenho ou atualizações de versão.

    Starter prompt

    Migre esta base de código de [legacy stack or system] para [target stack or system]. Requisitos - Comece identificando as premissas do sistema legado quanto a roteamento, modelos de dados, autenticação e autorização, configuração, ferramentas de build, testes, implantação e contratos externos. - Mapeie as correspondências entre a stack antiga e a nova e destaque o que não tiver equivalente direto. - Proponha um plano de migração incremental com camadas de compatibilidade ou pontos de verificação, sem reescrever tudo de uma vez. - Preserve o comportamento atual, a menos que a migração exija explicitamente uma mudança visível para o usuário. - Trabalhe em etapas. Ao concluir cada uma, execute o linter, verifique os tipos e rode testes específicos para as mudanças feitas. - Mantenha visíveis as opções de reversão ou contingência até concluir a transição. - Se a validação falhar, corrija o problema antes de continuar. - Comece mapeando as partes do sistema afetadas pela migração e proponha um plano com os pontos de verificação.
    AstraMedium
    Migre esta base de código de [legacy stack or system] para [target stack or system]. Requisitos - Comece identificando as premissas do sistema legado quanto a roteamento, modelos de dados, autenticação e autorização, configuração, ferramentas de build, testes, implantação e contratos externos. - Mapeie as correspondências entre a stack antiga e a nova e destaque o que não tiver equivalente direto. - Proponha um plano de migração incremental com camadas de compatibilidade ou pontos de verificação, sem reescrever tudo de uma vez. - Preserve o comportamento atual, a menos que a migração exija explicitamente uma mudança visível para o usuário. - Trabalhe em etapas. Ao concluir cada uma, execute o linter, verifique os tipos e rode testes específicos para as mudanças feitas. - Mantenha visíveis as opções de reversão ou contingência até concluir a transição. - Se a validação falhar, corrija o problema antes de continuar. - Comece mapeando as partes do sistema afetadas pela migração e proponha um plano com os pontos de verificação.
    AstraMedium

    Introdução

    Ao migrar de uma stack para outra, você pode usar o Codex para mapear e executar a migração de forma controlada. Ela pode abranger o roteamento, os modelos de dados, a configuração, a autenticação, as tarefas em segundo plano, as ferramentas de build, a implantação, os testes e até as convenções da linguagem e do framework.

    O Codex pode fazer um inventário do sistema legado, identificar os conceitos equivalentes na nova stack e implementar a mudança em etapas, sem precisar reescrever tudo de uma vez. Isso é importante quando você precisa manter o produto em funcionamento enquanto deixa de usar um framework legado, adapta o código a um novo ambiente de execução ou substitui uma stack por outra aos poucos.

    Como usar

    1. Comece listando tudo o que a migração envolve. Inclua os pacotes legados, as convenções do framework, o roteamento, o acesso a dados, a autenticação, a configuração, as ferramentas de build, os testes, as premissas de implantação e os contratos externos que precisam continuar válidos após a migração.
    2. Peça ao Codex que relacione cada conceito do sistema legado ao correspondente na nova stack e indique quais conceitos legados não têm equivalente direto.
    3. Escolha uma estratégia incremental. Você pode criar uma camada de compatibilidade, portar um módulo por vez, usar a técnica de branch por abstração ou aplicar o padrão estrangulador para substituir o sistema legado, trabalhando em uma fronteira do sistema por vez.
    4. Mantenha o comportamento estável até que a própria migração exija alguma mudança visível e indique explicitamente cada exceção.
    5. Ao concluir cada etapa, faça a verificação mais simples que comprove a equivalência de comportamento. Conforme o caso, use análise de lint, verificação de tipos, testes específicos, testes de contrato, testes de fumaça ou uma comparação lado a lado com o fluxo legado.
    6. A cada ponto de controle, revise o diff e avalie os riscos que ainda existem na transição, sem esperar o fim da reescrita.

    Use ExecPlans

    No nosso guia prático de modernização de código, apresentamos os ExecPlans. Com esses documentos, o Codex pode acompanhar o trabalho de reorganização do código como um todo, detalhar o estado final pretendido e registrar os resultados da validação após cada rodada. Ao pedir ao Codex que execute uma migração complexa, peça também que crie um ExecPlan para cada parte do sistema. Assim, todas as decisões, inclusive as escolhas de stack, ficam registradas para revisão posterior.

    Combine a migração com uma meta

    Para etapas mais demoradas da migração, use uma meta para orientar o Codex. Ao definir a meta, especifique o estado final desejado, as verificações de equivalência, o que se espera em caso de reversão e o critério de parada.

    Related use cases