MÓDULO 2.1
Claude → Codex: separa el cerebro del modelo
Explicar por qué el lock-in está en el runtime y cómo el método Auditar → Adaptar → Probar → Handoff lleva el conocimiento del proyecto a un núcleo portátil.
Qué es
El área Claude → Codex parte de una frase: "No migres tu cerebro. Separa el cerebro del modelo." El "cerebro" es todo lo que has acumulado en un proyecto: contexto, reglas, decisiones, tareas, skills, handoffs y memoria. Según la página, solo CLAUDE.md y AGENTS.md dependen del proveedor; todo lo demás es Markdown portátil, texto simple que cualquier agente puede leer. Cuando ese material está en una capa portátil dentro del proyecto, Claude Code, Codex CLI, Gemini o un modelo local en un contenedor se convierten únicamente en ejecutores, es decir, programas que hacen el trabajo a partir de esos archivos. Cambiar de modelo pasa a ser cambiar un borde, no el centro. El área reúne la tesis, el método, un curso de 3 rutas, un kit de scripts y megaprompts que lo ponen en práctica.
Por qué aprender
Los modelos cambian con frecuencia por precio, acceso o calidad. Si el conocimiento del proyecto está en el lugar correcto, cada cambio cuesta poco en vez de exigir una reconstrucción.
Conceptos clave
cerebro = contexto, reglas, decisiones, tareas, skills, handoffs y memoria; Markdown portátil; ejecutor; cambiar el borde, no el centro
Qué es
Lock-in significa quedar atado a un proveedor porque salir cuesta caro. La página afirma: "El lock-in no está en el modelo. Está en lo que dejaste dentro del runtime." Runtime es el programa que ejecuta el agente, como Claude Code o Codex CLI. Quien usa un asistente de código durante algunos meses ha acumulado instrucciones, memoria, skills, hooks y miles de sesiones en un formato que solo ese runtime puede leer. La página describe tres cambios: el lock-in es invisible hasta el día del cambio; el mismo conocimiento puede servirle a cualquier modelo; y pasas a tener menos dependencia y más control. El contenido perdura, el formato es desechable, y mezclarlos es lo que bloquea la migración.
Por qué aprender
El área es para quienes usan Claude Code o Codex en proyectos reales y temen cambiar de modelo. Entender dónde está la dependencia muestra qué debe salir del runtime antes de que el cambio sea obligatorio.
Conceptos clave
lock-in; runtime; CLAUDE.md, la memoria nativa y las sesiones JSONL son almacenamiento del trabajo, no el trabajo; contenido duradero, formato desechable
Qué es
El método tiene cuatro pasos, en este orden: Auditar, Adaptar, Probar y Handoff, «nunca implementar antes de auditar». Auditar consiste en hacer un inventario de solo lectura de los dos entornos de ejecución: skills, comandos, subagentes, hooks y MCP; cada skill se clasifica como reutilizable, adaptador, nativa o sin resolver. Adaptar consiste en dividir el CLAUDE.md: las reglas portátiles van al AGENTS.md, y lo que depende de un plugin, hook o menú de Claude queda en el archivo específico, que solo importa el contenido portátil. Probar consiste en abrir una sesión nueva y hacer cinco preguntas de continuidad: objetivo y criterio para darlo por listo, una regla con su archivo de origen, la última decisión, la próxima acción y los conflictos. Handoff consiste en registrar decisiones, pendientes, próximos pasos y rutas en un Markdown que la próxima sesión lea antes de actuar.
Por qué aprender
El orden evita el error más costoso: cambiar archivos antes de saber qué existe. Y la regla de prueba evita que confundas un archivo creado con conocimiento realmente utilizado.
Conceptos clave
Auditar → Adaptar → Probar → Handoff; MODE: audit; portátil × residuo; cinco preguntas de continuidad; que el archivo exista no es una prueba
Qué es
El núcleo portátil tiene siete ubicaciones, cada una con un responsable y una regla de actualización. AGENTS.md guarda reglas estables y el orden de lectura; context/overview.md, datos verificados con fuente y fecha; context/current-state.md, lo que funciona y lo que está pendiente; context/sources.md, de dónde viene cada información. context/decisions/ contiene una decisión aceptada por archivo; tasks/current.md indica el objetivo, el responsable, el criterio para darlo por listo y la próxima acción; handoffs/latest.md permite continuar en la próxima sesión. La página advierte que estos nombres son convenciones: ningún entorno de ejecución carga esas carpetas por sí solo; lo que indica que deben leerse es el orden de lectura al inicio de AGENTS.md. Cada información tiene un tipo: hecho, preferencia, hipótesis o decisión, y «provenance vence timestamp», es decir, el origen importa más que la fecha y nada se borra; se usa superseded_by.
Por qué aprender
Mezclar hechos con hipótesis, o decisiones con preferencias, hace que el agente repita errores antiguos y contradiga lo que ya se resolvió. El responsable y la fecha permiten promover una información al contexto aprobado, siempre con tu aprobación.
Conceptos clave
AGENTS.md; context/; decisions/; tasks/current.md; handoffs/latest.md; hecho, preferencia, hipótesis, decisión; provenance vence timestamp; secretos fuera del repositorio
Qué es
La página divide la decisión en tres niveles de esfuerzo, no en opiniones. El nivel 1 es importar en la app con un clic: es rápido, pero se limita a lo que acepta el otro lado; por ejemplo, el CLI de Codex no tiene importación nativa. El nivel 2 es migrar con el kit y un comando: ejecutar los scripts de agente-claude-codex para auditar, adaptar, instalar el núcleo, portar skills y probar. El nivel 3 es la capa personal portátil y duradera: el conocimiento vive en el proyecto y el entorno de ejecución se puede intercambiar. Mantener la independencia, es decir, no depender de ningún modelo específico, corresponde al nivel 3 y, según la página, es lo único que sobrevive al próximo cambio. Mantener la independencia no significa abandonar Claude: sigues eligiendo qué herramienta ejecuta cada tarea.
Por qué aprender
No todo el mundo necesita el nivel 3 ahora. La página indica cuándo conviene migrar ya, por costo, acceso o políticas, y cuándo conviene mantener la independencia, por ejemplo, si usas dos herramientas de ejecución o tienes trabajo de clientes.
Conceptos clave
Nivel 1: importar; Nivel 2: migrar con el kit; Nivel 3: capa personal portátil; migrar ahora × mantener la independencia; costo de no hacer nada
Qué es
El curso Claude → Codex: migra o mantén tu independencia es abierto, está en portugués y tiene versiones en inglés y español; según el programa, son 3 rutas, 18 módulos y 108 temas. La Ruta 1 cubre fundamentos y vocabulario; la Ruta 2 es el kit, comando por comando; y la Ruta 3 presenta seis proyectos sobre un sistema real. El kit agente-claude-codex combina bash y Markdown, y tiene tres formas de uso: scripts, mega-prompts y la plantilla del núcleo portátil. doctor.sh responde «¿mi entorno está listo?» y audit.sh guarda un informe de solo lectura; también están adapt-instructions.sh, init-core.sh, sync-skills.sh con polyskill, readback-test.sh, drift-report.sh y promover-memoria.sh. La página lo resume así: «El mejor primer paso es un proyecto tuyo, en modo audit».
Por qué aprender
El curso explica por qué y el kit hace el trabajo sin borrar nada: no copia en masa ni borra nada de ~/.claude o ~/.codex, e instalar una skill crea una copia de seguridad al lado. Empezar por la auditoría muestra en una sesión qué es portátil y qué depende de un hook.
Conceptos clave
curso de 3 rutas; kit agente-claude-codex; doctor.sh; audit.sh; mega-prompts A y B; Mapa del tema; área hermana Codex + Claude