Proceso de migración de proyectos legacy asistida por IA (v2.6.0)
Protocolo estandarizado de 8 etapas secuenciales para actualizar proyectos legacy hacia BaP Framework v2.6.0 utilizando agentes de IA y la habilidad ejecutable bap-migration-orchestrator.
Requisito Previo Fundamental de Espacios de Trabajo
Para que el agente de IA pueda ejecutar la migración automatizada, es IMPRESCINDIBLE que el entorno del asistente cuente con acceso de lectura/escritura (workspace) a ambos repositorios simultáneamente: el proyecto origen (BaP_Framework) y el proyecto destino (proyecto legacy).
🤖 Fusión No Destructiva de Directivas & Skills (.agents/)
A partir de la versión v2.6.0, el proceso de migración garantiza la integridad de las reglas y habilidades personalizadas del proyecto destino:
- Habilidades Executables (.agents/skills/): Se copian las habilidades oficiales
bap-*(comobap-migration-orchestrator) sin sobrescribir ni eliminar las skills creadas previamente por el desarrollador. - Reglas de Desarrollo (.agents/AGENTS.md): Si el proyecto destino ya cuenta con sus propias reglas, se conservan intactas y se integran las normas de BaP bajo la sección
## Directivas del Framework BaP (v2.6.0).
Protocolo Oficial de 8 Etapas
Etapa 1: Aislamiento y Respaldo Legacy
Creación de rama aislada refactor/bap-migration-ia y respaldo completo en /legacy-temp dejando la raíz limpia.
Etapa 2: Copia e Instalación Limpia de BaP + Fusión .agents/
Instalación de la base limpia de BaP v2.6.0 con Fusión No Destructiva del directorio .agents/ (skills bap-* y anexado de AGENTS.md).
Etapa 3: Depuración del Boilerplate
Remoción de páginas demo (src/pages/*, /pages/core/*, /pages/migrator/*), estilos base y dependencias obsoletas en package.json.
Etapa 4: Inventario y Declaración de Configuración
Parametrización de bap.config.json, variables .env, firebase.json, rutas dbRoutes y eventos de analítica.
Etapa 5: Reconstrucción e Inyección de Recursos
Restauración de estilos, assets, componentes identitarios y refactorización de código legacy (props.id, replaceTokensInDOM, AES-GCM, Constants). Los servicios core (storage, googleDrive, markdown, ai) quedan disponibles para adopción libre.
Etapa 6: Prueba de Compilación y Calidad
Ejecución de npm install y npm run optimize (Gulp build) asegurando resolución del 100% de tokens i18n.
Etapa 7: Generación de Pruebas Unitarias
Diseño de suite de pruebas con Vitest + JSDOM y mocking genérico de dependencias de red/CDN.
Etapa 8: Estabilización y Limpieza Final
Remoción permanente de legacy-temp/, actualización del README.md original y entrega local.