Área Claude → Codex · workspace agnóstico de modelo
No migres tu cerebro. Separa el cerebro del modelo.
Solo CLAUDE.md y AGENTS.md están atados al proveedor. Todo lo demás que has acumulado — contexto, reglas, decisiones, tareas, skills, handoffs y memoria — es Markdown portátil. Cuando ese material vive en una capa portátil dentro del proyecto, Claude Code, Codex CLI, Gemini o un modelo local en un contenedor pasan a ser solo ejecutores: cambiar de modelo se vuelve cambiar un borde, no el centro. Esta área reúne la tesis, el método, el curso de 3 rutas, el kit de scripts y los mega-prompts que lo hacen en la práctica.
El curso es abierto y está disponible en español; el kit y los prompts son abiertos y están en portugués. El encuentro en vivo tiene fecha por anunciar en la comunidad.
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 1
Auditar
¿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 2
Adaptar
¿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 3
Probar
¿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 4
Handoff
¿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 clic
Importar 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 comando
Migrar 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 · duradero
La 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.
¿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.
Tres rutas: entender, hacer y aplicar en proyectos reales.
El curso Claude → Codex: migra o mantente agnóstico es abierto, con versiones en español, portugués e inglés. Según su propio currículo, son 3 rutas, 18 módulos y 108 temas; cada módulo tiene seis temas de alrededor de media hora. Público: quien ya usa Claude Code o Codex y quiere usar los dos — o no quedar atado a ninguno.
Ruta 1 · Fundamentos
Por qué y qué
Define cada término en su primera aparición: modelo, runtime, harness, skill, MCP, hook, handoff. Es la ruta que responde "por qué no basta con copiar el CLAUDE.md".
También en portugués e inglés. Las versiones PT y EN son espejos completos, con sus propios assets y progreso separado por idioma. Cada página tiene el selector PT / EN / ES arriba.
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.
Del lado de la empresa. Si tu pregunta no es qué ejecutor usar, sino cómo gestionar agentes dentro de la empresa — roles, niveles de decisión, costo por resultado y evaluación —, el área Gestión de IA continúa esa conversación.
El mejor primer paso es un proyecto tuyo, en modo audit.
Elige un proyecto que conozcas bien, ejecuta el diagnóstico y lee la auditoría antes de cambiar cualquier archivo. En una sesión ya sabes qué es portátil, qué necesita adaptador y qué depende de un hook. El curso y el kit son abiertos; el encuentro en vivo sobre migrar o ser agnóstico tiene fecha por anunciar en la comunidad.
Curso · gratuito y abierto
Hacer el curso
Tres rutas: entender por qué separar el cerebro del modelo, ejecutar el kit comando a comando y aplicarlo en seis proyectos con criterio de aceptación.
Fundamentos: vocabulario, tres niveles, núcleo portátil
Manos a la obra: doctor, audit, adapt, polyskill, readback
Proyectos: primer proyecto real, MCP y hooks, memoria curada
Donde se va a anunciar el encuentro en vivo "migrar o ser agnóstico", con el sistema real en pantalla: auditar, adaptar, probar, handoff. Y donde puedes discutir tu migración con quien ya hizo la suya.
Clonar, ejecutar doctor.sh, leer la auditoría. Nada en ~/.claude o ~/.codex se copia en masa ni se borra, e instalar una skill hace una copia de seguridad al lado.
Scripts de diagnóstico, adaptación, prueba y drift
Plantilla del núcleo portátil para cualquier proyecto