For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal
Theme
Codex

Codex use case

Migrar código

Migra stacks heredados con puntos de control en cada etapa.

Difficulty Advanced
Time horizon 1h

Usa Codex para identificar las correspondencias entre un sistema heredado y el nuevo stack, migrar por etapas y verificar que el comportamiento sea equivalente antes de cada transición.

Best for

  • Migraciones de un stack heredado a uno moderno que requieren cambios en los frameworks, los entornos de ejecución, los sistemas de compilación o las convenciones de la plataforma.
  • Equipos que necesitan capas de compatibilidad, transiciones por etapas y una validación explícita en cada punto de control de la migración.

Contents

    ← All use cases

    Migrar código

    Migra stacks heredados con puntos de control en cada etapa.

    Usa Codex para identificar las correspondencias entre un sistema heredado y el nuevo stack, migrar por etapas y verificar que el comportamiento sea equivalente antes de cada transición.

    Advanced
    1h

    Usa Codex para identificar las correspondencias entre un sistema heredado y el nuevo stack, migrar por etapas y verificar que el comportamiento sea equivalente antes de cada transición.

    Advanced
    1h

    Best for

    • Migraciones de un stack heredado a uno moderno que requieren cambios en los frameworks, los entornos de ejecución, los sistemas de compilación o las convenciones de la plataforma.
    • Equipos que necesitan capas de compatibilidad, transiciones por etapas y una validación explícita en cada punto de control de la migración.

    Skills & Plugins

    • Revisa las migraciones de riesgo, los cambios en las dependencias y las superficies expuestas antes de fusionar los cambios.
    • Resuelve las fallas de CI al terminar cada etapa de la migración para que no se acumulen hasta el final.
    • Consulta las recomendaciones específicas del framework si la migración afecta a los modelos de aplicación de ASP.NET Core, `Program.cs`, el middleware, las pruebas, el rendimiento o las actualizaciones de versión.
    Skill Why use it
    Security Best Practices Revisa las migraciones de riesgo, los cambios en las dependencias y las superficies expuestas antes de fusionar los cambios.
    Gh Fix Ci Resuelve las fallas de CI al terminar cada etapa de la migración para que no se acumulen hasta el final.
    Aspnet Core Consulta las recomendaciones específicas del framework si la migración afecta a los modelos de aplicación de ASP.NET Core, `Program.cs`, el middleware, las pruebas, el rendimiento o las actualizaciones de versión.

    Starter prompt

    Migra esta base de código de [legacy stack or system] a [target stack or system]. Requisitos: - Empieza por hacer un inventario de los supuestos del sistema heredado sobre el enrutamiento, los modelos de datos, la autenticación y la autorización, la configuración, las herramientas de compilación, las pruebas, el despliegue y los contratos externos. - Identifica las correspondencias entre el stack anterior y el nuevo, y señala qué elementos no tienen un equivalente directo. - Propón un plan de migración incremental con capas de compatibilidad o puntos de control para evitar reescribir todo el código de una sola vez. - Conserva el comportamiento actual salvo que la migración exija explícitamente un cambio visible para el usuario. - Trabaja por etapas. Al terminar cada una, ejecuta el linter, verifica los tipos y realiza pruebas específicas. - Mantén a la vista las opciones para revertir los cambios o recurrir a una alternativa hasta que termine la transición. - Si la validación falla, corrige el problema antes de continuar. - Empieza por identificar qué partes del sistema abarca la migración y proponer un plan con puntos de control.
    AstraMedium
    Migra esta base de código de [legacy stack or system] a [target stack or system]. Requisitos: - Empieza por hacer un inventario de los supuestos del sistema heredado sobre el enrutamiento, los modelos de datos, la autenticación y la autorización, la configuración, las herramientas de compilación, las pruebas, el despliegue y los contratos externos. - Identifica las correspondencias entre el stack anterior y el nuevo, y señala qué elementos no tienen un equivalente directo. - Propón un plan de migración incremental con capas de compatibilidad o puntos de control para evitar reescribir todo el código de una sola vez. - Conserva el comportamiento actual salvo que la migración exija explícitamente un cambio visible para el usuario. - Trabaja por etapas. Al terminar cada una, ejecuta el linter, verifica los tipos y realiza pruebas específicas. - Mantén a la vista las opciones para revertir los cambios o recurrir a una alternativa hasta que termine la transición. - Si la validación falla, corrige el problema antes de continuar. - Empieza por identificar qué partes del sistema abarca la migración y proponer un plan con puntos de control.
    AstraMedium

    Introducción

    Cuando pasas de un stack tecnológico a otro, puedes usar Codex para planificar y ejecutar una migración controlada. La migración puede abarcar el enrutamiento, los modelos de datos, la configuración, la autenticación, las tareas en segundo plano, las herramientas de compilación, el despliegue, las pruebas o incluso las convenciones del lenguaje y del framework.

    Codex puede hacer un inventario del sistema heredado, identificar qué conceptos del nuevo stack corresponden a los anteriores e incorporar los cambios en etapas que puedes revisar por separado. Esto es importante cuando dejas atrás un framework heredado, adaptas el código a un nuevo entorno de ejecución o reemplazas un stack por otro de forma gradual mientras el producto debe seguir funcionando.

    Cómo usar Codex

    1. Empieza por hacer un inventario de todo lo que abarca la migración. Incluye los paquetes heredados, las convenciones del framework, el enrutamiento, el acceso a los datos, la autenticación, la configuración, las herramientas de compilación, las pruebas, los supuestos en los que se basa el despliegue y los contratos externos que deben seguir vigentes tras la migración.
    2. Pídele a Codex que identifique los equivalentes de los conceptos heredados en el stack de destino y señale cuáles no tienen una correspondencia directa.
    3. Elige una estrategia incremental. Puedes usar una capa de compatibilidad, adaptar el código módulo por módulo, aplicar el patrón de ramificación por abstracción o usar el patrón estrangulador para reemplazar una parte delimitada del sistema a la vez.
    4. Mantén el comportamiento estable hasta que la propia migración exija un cambio visible e indica explícitamente esas excepciones.
    5. Al alcanzar cada hito, ejecuta la validación mínima que demuestre que el comportamiento sigue siendo equivalente. Según el caso, puede bastar con ejecutar un linter, verificar los tipos, realizar pruebas específicas, de contrato o de humo, o comparar en paralelo la ruta de ejecución nueva con la heredada.
    6. En cada punto de control, revisa el diff y los riesgos que aún presenta la transición, sin esperar a que termine la reescritura completa.

    Usa ExecPlans

    En nuestra guía práctica de modernización de código presentamos los ExecPlans. Estos documentos permiten a Codex mantener una visión de conjunto de la limpieza del código, detallar el estado final previsto y registrar las validaciones después de cada iteración. Cuando le pidas a Codex que ejecute una migración compleja, pídele que cree un ExecPlan para cada parte del sistema. Así te aseguras de que queden registradas todas las decisiones, incluidas las relativas a la elección del stack tecnológico, y puedas revisarlas más adelante.

    Combina la migración con un objetivo

    Si una etapa de la migración lleva mucho tiempo, usa un objetivo para guiar a Codex durante esa etapa. Al definir el objetivo, especifica claramente el estado final, las comprobaciones de paridad, qué esperas que ocurra si hay que revertir los cambios y en qué momento debe detenerse Codex.

    Related use cases