Cómo Migrar
Apps Legacy con IA
Una guía general, sin atajos, para migrar cualquier stack legacy usando agentes especializados
Cómo Migrar Aplicaciones Legacy con Agentes de IA
Leandro Sepúlveda • 2026
Serie IA Práctica
Descargar PDF¿Qué aprenderás?
El método general de migración asistida, aplicable a cualquier combinación de lenguajes y stacks
Auditar antes de migrar
Analizar el código legacy antes de tocar nada: estructura, dependencias, patrones y calidad real.
Arquitectura objetivo
Clean Architecture en capas: Domain, Application, Infrastructure, Web. Mapa de equivalencias entre stacks.
Skills de migración con IA
Enseñarle al agente a convertir construcciones del lenguaje origen al destino, con ejemplos concretos.
Autenticación y sesiones
El módulo que más dolores de cabeza da. Migrar sesiones del lado servidor a JWT sin romper nada.
Testing de migración
Tests xUnit equivalentes a los originales. Verificación de equivalencia funcional post-migración.
Estrategia Strangler Fig
Migración incremental módulo por módulo. CI/CD, rollback y puesta en producción sin apagar el sistema original.
Contenido del Libro
12 capítulos, 26 páginas. Usa PHP a .NET como ejemplo, pero el método aplica a cualquier stack.
Por qué migrar y por qué ahora
Cuándo migrar deja de ser un lujo y pasa a ser una necesidad. 50 mil líneas, 30 tablas, nadie se anima a tocarlas.
El método general de migración asistida
Los cinco pasos que aplican a cualquier stack: auditar, definir arquitectura, crear skills, migrar por módulos, validar.
Entendiendo el terreno
Cómo analizar tu código legacy antes de tocar nada. Instalación de OpenCode con modelos gratuitos y análisis automatizado.
La arquitectura objetivo
Clean Architecture y el archivo de definición de agentes (AGENTS.md). Mapeo de equivalencias entre lenguajes.
El Skill de migración
Enseñándole al agente a convertir un lenguaje en otro. Reglas generales, ejemplos por capa y el skill dotnet-migration.
Migrando módulo por módulo
El orden recomendado: Auth, Usuarios, Productos, Órdenes, Reportes. Script de migración completa con OpenCode.
Autenticación y sesiones
El módulo que más dolores de cabeza da. De sesiones del lado servidor a JWT. Migración de hashes de contraseñas.
Archivos, storage e integraciones
Migración de archivos a S3, pasarelas de pago, email transaccional y jobs asíncronos. Lo que vive fuera de la BD.
Testing de la migración
Por qué los tests importan más acá que en un proyecto nuevo. Skill de testing y verificación de equivalencia funcional.
CI/CD para el proyecto nuevo
GitHub Actions desde el primer módulo. Pipeline de migración asistida por agentes dentro del CI/CD.
Puesta en producción
Estrategia Strangler Fig con nginx. Plan de rollback y checklist final antes de dar la migración por terminada.
Glosario y recursos
Clean Architecture, MediatR, EF Core, Dapper, Minimal API, Strangler Fig y todos los términos del proceso.