Modernizar codebases legacy con Stacked Sessions y PRs en GitHub Copilot

Introducción

Mantener codebases legacy es un dolor de cabeza recurrente en DevOps: dependencias desactualizadas, frameworks obsoletos y migraciones postergadas por el alto costo de tiempo. Un repositorio con React 15, Less y Bootstrap de 2016 no es rareza en entornos de infraestructura, especialmente en proyectos internos o herramientas de apoyo. La modernización manual de estos sistemas puede tomar semanas, con riesgo de introducir breaking changes en código crítico. Las Stacked Sessions y los pull requests integrados en la app de GitHub Copilot ofrecen una forma sistemática de abordar este problema, descomponiendo la migración en tareas incrementales y gestionables.

Esta guía te muestra cómo usar estas funcionalidades para actualizar un repositorio paso a paso, desde la planificación hasta la creación de PRs automáticos, minimizando el riesgo y el esfuerzo manual. El enfoque es aplicable a cualquier proyecto, pero resulta especialmente útil para equipos que mantienen aplicaciones en EKS o otros entornos cloud donde la estabilidad es prioridad.

Qué es y para qué sirve

El flujo es:

1. Planificación: Definís una lista de tareas ordenadas (ej: «Actualizar React a v18», «Reemplazar Less por Sass»).
2. Ejecución: GitHub Copilot procesa cada tarea en una sesión separada, reutilizando el contexto de la anterior.
3. Revisión: Cada session genera un diff que podés revisar antes de continuar.
4. Integración: Al finalizar, se crea un PR con todos los commits, listo para code review.

El beneficio clave es reduir la complejidad: en lugar de abordar todo de una vez (y lidiar con conflictos masivos), cada paso trabaja sobre un estado estable. Además, los PRs automáticos facilitan la revisión incremental y el control de calidad.

Prerequisitos

• GitHub Copilot app (no el extension de VS Code): instalada desde github.com (requiere suscripción a Copilot Pro o Enterprise).
• Repositorio en GitHub: con acceso de escritura para tu usuario.
• Branch base: un branch estable (ej: main o master) desde el cual crear las sesiones. Asegurate de que:

– Sea el branch que usás en producción (para evitar divergencias).

• Conocimientos básicos:

– Gestión de dependencias en tu lenguaje/ecosistema (ej: npm para Node.js, pip para Python).

• Permisos: Habilitar GitHub Copilot workspace en el repository settings (Settings > Features > Copilot).

Guía paso a paso

1. Analizar el estado actual

Antes de empezar, evaluá el scope del trabajo:

# Ejemplo para un proyecto Node.js
npx npm-check-updates --depth=0
npm outdated

Anotá las dependencias obsoletoas y versiones objetivo. En el caso del ejemplo original: React 15 → 18, Less → Sass, react-bootstrap → v2.

2. Crear un branch de trabajo

git checkout -b modernizacion-2024 main
git push -u origin modernizacion-2024

Usá un nombre descriptivo para rastrear el progreso.

3. Iniciar una Stacked Session en GitHub Copilot app

1. Abrí la app de GitHub Copilot y seleccioná tu repositorio.
2. Hacé clic en «New session» > «Stacked sessions».
3. Elegí el branch modernizacion-2024 como base.

4. Definir las tareas

En el campo de prompt, describí la lista de tareas en orden. Ejemplo para el caso React:

Modernizar un app React legacy. Seguí este orden:

1. Actualizar React a v18 y React DOM a v18. Elimina el package `less` y reemplazalo por `sass`.
2. Actualizar todas las dependencias de react-bootstrap a la versión 2.x. Ajustá el código para compatibilidad.
3. Reemplazar todos los archivos .less por .scss, actualizando la sintaxis y imports.
4. Actualizar Babel y Webpack a versiones compatibles con React 18.
5. Ejecutar `npm test` y fixear errores de tests.

Cré un pull request al finalizar.

5. Ejecutar la primera tarea

1. Hacé clic en «Start session» para la primera tarea.
2. GitHub Copilot analizará el repo y propondrá cambios. Revisá el diff:

– Asegurate de que no se hayan modificado archivos no relacionados.

1. Si todo está bien, hacé clic en «Accept and add to stack‘. GitHub Copilot creará un commit automático.

6. Revisar y ajustar

Antes de continuar:

git checkout modernizacion-2024
npm install
npm start

Verificá que la app levante sin errores críticos. Si hay problemas:

• Revertí el commit: git revert <commit-hash>.
• Ajustá el prompt para la tarea y reiniciá la session.

7. Continuar con las tareas restantes

Repetí el proceso para cada tarea en orden:

1. Hacé clic en «Next task» en la session stacked.
2. Revisá el diff, testea los cambios y aceptá.
3. Verificá que la app funcione después de cada commit.

3a. Convertir archivos .less en /src/components/ a .scss
3b. Convertir archivos .less en /src/pages/ a .scss

8. Crear el pull request

Al completar la última tarea, GitHub Copilot preguntará si querés crear un PR. Aceptá y completá:

• Title: «Modernización: actualizar React 18 y migrar a Sass».
• Description: Detallá los cambios principales y pruebas realizadas.
• Reviewers: Asigná a miembros del equipo.

Consideraciones y buenas prácticas

git checkout modernizacion-2024
git merge main

Luego reiniciá la stacked session desde el último commit válido.

git commit --allow-empty -m "ADR: Usar CSS Modules para estilos"

• Contexto: GitHub Copilot tiene un límite de contexto (32K tokens). Para repositorios muy grandes, dividí el trabajo en múltiples stacked sessions (ej: «Modernizar frontend» y «Modernizar backend»).
• Tests: No siempre lográ ejecutar tests automáticamente. Configurá un GitHub Actions workflow en tu repo para CI:

# .github/workflows/tests.yml
name: Tests
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '18'
      - run: npm install
      - run: npm test

1. Creá un branch por tarea.
2. Usá GitHub Copilot Chat para generar los cambios en cada branch.
3. Creamer PRs individuales y mergé los branches en orden.

Conclusión

Las Stacked Sessions de GitHub Copilot transforman la modernización de codebases legacy de un proyecto abrumador a una serie de pasos manejables. Al descomponer el trabajo en tareas secuenciales, cada una partiendo del estado anterior, reducís la complejidad y minimizás el riesgo de breaking changes. La integración con pull requests facilita la revisión incremental y el control de calidad, clave en entornos de infraestructura donde la estabilidad es crítica.

Para equipos que mantienen aplicaciones en EKS o otros entornos cloud, esta approach permite actualizar dependencias y frameworks sin reescribir todo desde cero, liberando recursos para focalizarse en features nuevos. El tiempo invertido en aprender a usar Stacked Sessions se amortiza rápidamente en el primer codebase legacy que modernices.

Fuentes

Stacked sessions and pull requests in the GitHub Copilot app