01 · Lo que está cambiando
El lock-in no está en el modelo. Está en lo que dejaste dentro del runtime.
El curso arranca desde una molestia simple: quien usa un asistente de código desde hace unos meses ha acumulado instrucciones, memoria, skills, hooks y miles de sesiones en un formato que solo ese runtime lee. Cuando aparece un ejecutor mejor, más barato u obligatorio, llega la cuenta. Y no es técnica: es conocimiento atrapado en el lugar equivocado.
Cambio 1
El lock-in es invisible hasta el día del cambio
CLAUDE.md, la memoria nativa y las sesiones en JSONL parecen parte del trabajo. No lo son: son el almacenamiento del trabajo. El contenido es duradero, el formato es desechable — y mezclar ambos es lo que traba la migración.
Cambio 2
El mismo conocimiento, cualquier modelo
Reglas, decisiones aceptadas, tareas con criterio de terminado y handoffs son texto. Escritos en archivos con dueño y orden de lectura, cualquier agente que lea Markdown retoma donde el otro se quedó — incluido un modelo local corriendo en un contenedor.
Cambio 3
Menos dependencia, más control
Dejas de administrar prompts y pasas a administrar contexto, estado, herramientas, procesos y validación. El modelo se vuelve una elección reversible: si empeora, se encarece o desaparece, el centro sigue en tu repositorio.
Antes · el cerebro dentro del runtime
Un CLAUDE.md gigante · memoria nativa · sesiones JSONL · skills copiadas a mano · hooks del harness
Funciona muy bien — mientras uses solo ese runtime. Cambiar significa reconstruir, y reconstruir significa perder las decisiones que nadie anotó.
Después · el cerebro en el proyecto
AGENTS.md · context/overview.md · context/decisions/ · tasks/current.md · handoffs/latest.md · skills de fuente única
Los nombres son una convención: ningún runtime carga esas carpetas por su cuenta. Quien manda leerlas es el orden de lectura al inicio del AGENTS.md. Por eso funciona en cualquier ejecutor.
Los modelos cambian. Tu estructura permanece.
La tesis del curso, en una frase.
02 · El método
Auditar → Adaptar → Probar → Handoff. En ese orden, y nunca implementando antes de auditar.
Los mega-prompts del kit empiezan en MODE: audit a propósito: primero analizar, planificar y simular; solo después implementar. La regla que cierra el método es la más dura de aceptar — que el archivo exista no es prueba; que el agente lo haya leído y usado, sí.
Diagnosticar→Auditar→Adaptar→Instalar el núcleo→Portar skills→Probar→Handoff
Paso 1Auditar
¿Qué existe hoy, sin tocar nada?
Inventario de solo lectura de los dos runtimes: skills, comandos, subagentes, hooks y MCP. Cada skill queda clasificada como reutilizable, adaptador, nativa o sin resolver.
Paso 2Adaptar
¿Qué es portátil y qué es residuo?
El CLAUDE.md se divide: las reglas portátiles van al AGENTS.md; lo que depende de un plugin, un hook o un menú de Claude se queda en el archivo específico, que solo importa la parte portátil.
Paso 3Probar
¿Una sesión nueva logra continuar?
Cinco preguntas de continuidad — objetivo y criterio de terminado, una regla con su archivo de origen, la última decisión, la próxima acción, conflictos — en cada runtime.
Paso 4Handoff
¿Qué necesita saber la próxima sesión?
Decisiones, pendientes, próximos pasos y rutas en un Markdown. La sesión siguiente, en cualquier runtime, lo lee antes de actuar. Handoff antes de cerrar, siempre.
Qué es el núcleo portátil
Siete lugares, cada uno con un dueño y una regla de actualización. Es lo que el kit instala sin sobrescribir nada de lo que ya existe en el proyecto.
Los archivos
Dónde vive cada cosa
- AGENTS.md — reglas estables y orden de lectura
- context/overview.md — hechos verificados, con fuente y fecha
- context/current-state.md — qué funciona y qué está pendiente
- context/sources.md — de dónde viene cada información
- context/decisions/ — una decisión aceptada por archivo
- tasks/current.md — objetivo, dueño, criterio de terminado, próxima acción
- handoffs/latest.md — la continuación para la próxima sesión
Los tipos de información
Dueños, no carpetas
- Hecho — verificado, con origen y fecha
- Preferencia — cómo quieres que se haga
- Hipótesis — todavía sin confirmar
- Decisión — aceptada, con alcance y estado
- La procedencia gana al timestamp: nada se borra, se usa
superseded_by
- Los índices son reconstruibles a partir de las fuentes
- Los secretos y el material en bruto quedan fuera del repositorio
Por qué esto no es solo orden. Mezclar un hecho con una hipótesis, o una decisión con una preferencia, es lo que hace que el agente repita un error viejo y contradiga lo que ya estaba resuelto. El dueño y la fecha son lo que permite promover una información de memoria en bruto a contexto aprobado — con tu aprobación, nunca de forma automática.
03 · Migrar o ser agnóstico
Tres niveles. El primero resuelve hoy; el tercero resuelve también los próximos cambios.
El curso separa la decisión en niveles de esfuerzo, no en opiniones. Migrar es llegar al nivel 1 o 2. Ser agnóstico es el nivel 3 — y es el único que sobrevive al próximo cambio de modelo, que va a ocurrir otra vez.
Nivel 1 · un clicImportar en la app
El camino más corto cuando existe una importación lista. Rápido, y limitado a lo que el otro lado acepta recibir — el CLI de Codex, por ejemplo, no tiene importación nativa.
Nivel 2 · un comandoMigrar con el kit
Ejecutar los scripts de agente-claude-codex: auditar, adaptar instrucciones, instalar el núcleo, portar skills y probar en una sesión nueva en los dos runtimes.
Nivel 3 · duraderoLa capa personal portátil
Reorganizar el trabajo para que el conocimiento viva en el proyecto y el runtime sea intercambiable. Más trabajo una vez; ninguna migración después.
Migra ahora si…
- Necesitas usar el otro runtime esta semana, por costo, acceso o política.
- Tu setup está concentrado en pocos proyectos y pocas skills.
- La mayoría de las skills son Markdown puro (reutilizables en la auditoría).
- Quieres resultado antes de reorganizar tu método de trabajo.
Sé agnóstico si…
- Ya cambiaste de herramienta una vez y no quieres repetirlo.
- Quieres usar dos o más ejecutores al mismo tiempo, incluido uno local.
- Muchas skills dependen de MCP o de hooks del harness (adaptador y nativa).
- Hay trabajo de cliente, donde el alcance y el aislamiento deben ser explícitos.
Qué cambia al migrarLas instrucciones y las skills pasan al otro runtime. El método de trabajo sigue igual.
Qué cambia al ser agnósticoEl proyecto gana núcleo portátil, ciclo de handoff y skills de fuente única.
Qué no cambiaSigues eligiendo el ejecutor por tarea. Ser agnóstico no es abandonar Claude.
Costo de no hacer nadaEl conocimiento sigue acumulándose en un formato que solo un runtime lee.
Vale para los dosAudit antes de implement, y prueba por lectura en una sesión nueva.
No existe un estado final. Cada cambio de proveedor mejora un ejecutor y rompe otro: los modelos cerrados pueden prescindir de skills que un modelo local exige, y un hook que existe en un harness no existe en el otro. Por eso el método termina en mantenimiento — vigilar el drift entre las copias y registrar cada fallo en una línea, con la corrección más pequeña posible.
Nota: la cuenta es del runtime, no del proyecto
Ser agnóstico también vale para las cuentas. Con dos suscripciones de Codex (personal y de trabajo, por ejemplo), el login queda fuera de la capa portátil: cada cuenta vive en una carpeta propia, apuntada por la variable CODEX_HOME (por defecto ~/.codex). El proyecto, el AGENTS.md, las skills y el handoff siguen iguales para las dos cuentas.
# segunda cuenta: carpeta propia, con las mismas instrucciones por enlace
mkdir -p ~/.codex-trabalho
ln -s ~/.codex/config.toml ~/.codex-trabalho/config.toml
ln -s ~/.codex/AGENTS.md ~/.codex-trabalho/AGENTS.md
CODEX_HOME=~/.codex-trabalho codex login --device-auth
# probar por lectura, en sesión nueva, en las dos cuentas
codex exec --sandbox read-only 'Lee el AGENTS.md y enumera las 3 reglas principales'
CODEX_HOME=~/.codex-trabalho codex exec --sandbox read-only 'Lee el AGENTS.md y enumera las 3 reglas principales'
Va en la capa portátilAGENTS.md, skills y handoff, compartidos por las dos cuentas.
Queda fueraEl auth.json de cada cuenta, el historial y las sesiones. Nunca en el repositorio ni en el handoff.
Cambiar de cuenta no es migrarSolo cambia el CODEX_HOME. Ningún archivo del proyecto cambia.
Audit antesVerifica que el .gitignore cubra .codex*/ y que ningún script grabe el login dentro del proyecto.
El mismo principio en ClaudeEn Claude Code, la variable CLAUDE_CONFIG_DIR separa las cuentas de la misma manera.
Cuidados. codex login y logout sin el CODEX_HOME correcto cambian la cuenta principal. No copies el auth.json entre carpetas: el login se renueva solo y dos copias pueden invalidarse entre sí. Los servicios y terminales ya abiertos siguen en la cuenta con la que empezaron.
¿Quieres usar los dos juntos? Después de separar el cerebro del modelo, puedes usar Claude y Codex en el mismo proyecto — uno hace el trabajo, el otro lo revisa. El área Codex + Claude reúne los seis niveles del kit Use Both, quién hace qué y todos los cursos y proyectos de INEMA sobre las dos herramientas.
Abrir el área Codex + Claude →
05 · El kit agente-claude-codex
Línea de comandos y Markdown. Sin interfaz, sin copia masiva, sin borrar nada.
El kit es bash más archivos Markdown, y tiene tres formas de uso: los scripts, los mega-prompts (para hacer la migración conversando con un agente) y la plantilla del núcleo portátil, que se copia en cualquier proyecto incluso sin ejecutar ningún script.
Pasos 0 y 1
doctor.sh y audit.sh
doctor.sh responde "¿mi entorno está listo?" — cada ítem sale como ok, aviso o falta, con el comando para resolverlo. audit.sh graba un informe de solo lectura con el inventario de los dos runtimes y la clasificación de cada skill.
Pasos 2 y 3
adapt-instructions.sh e init-core.sh
El primero lee el CLAUDE.md del proyecto y graba dos propuestas al lado, sin sobrescribir. El segundo copia el núcleo portátil, listando lo que creó y lo que mantuvo. También existe faxina.sh, que clasifica sección por sección un CLAUDE.md largo.
Paso 4
sync-skills.sh con polyskill
Una fuente canónica por skill, copias generadas por runtime y un comando de drift que dice, por destino, si está igual o si divergió. Instalar hace una copia de seguridad al lado antes de sobrescribir.
Paso 5
readback-test.sh
Abre una sesión nueva en cada runtime dentro del proyecto, hace las cinco preguntas de continuidad y guarda la respuesta en bruto. La aprobación es tuya, leyendo el texto: ¿las respuestas citan los archivos correctos y la próxima acción coincide con la tarea?
Ciclo diario
session-handoff y prime
Las dos skills canónicas que vienen en el kit: una escribe el handoff al final de la sesión, la otra lee AGENTS.md, context/, tasks/ y handoffs/ antes de actuar y devuelve un briefing con las fuentes. Juntas, cierran el ciclo.
Mantenimiento
drift-report.sh y promover-memoria.sh
Un informe semanal de divergencia entre las copias de skills y el AGENTS.md global; y un flujo en el que el agente propone hechos con fuente y fecha a partir de la memoria en bruto, y solo lo que apruebas entra en el contexto.
Lo que ya se ejecutó de verdad en esta máquina (2026-09-13 y 2026-09-16). Según el README del kit: doctor.sh pasó con dos avisos; la auditoría encontró 89 skills existentes solo en Claude — 71 reutilizables, 15 adaptador, 2 nativas y 1 sin SKILL.md; la adaptación del CLAUDE.md global separó 71 líneas portátiles de 7 de residuo; el núcleo instalado en un clon aislado pasó el check; el readback pasó en los dos runtimes; las skills canónicas quedaron instaladas en cuatro destinos con drift cero; y una sesión nueva de Codex, después del prime, señaló tres contradicciones reales entre el handoff y la tarea. Son registros de ejecución en el propio repositorio, no un benchmark ni una medida de desempeño de modelo.
¿Prefieres hacerlo conversando? Los mega-prompts A (migrar un setup de Claude existente) y B (construir un workspace portátil, con add-ons personal y de cliente) están en texto copiable en el repositorio. Mantén MODE: audit en la primera ronda, lee el plan que devuelve el agente y solo entonces ejecútalo en modo de implementación.
Ver los prompts → (en portugués)