Cómo migrar de Google Antigravity a Claude Code sin perder el contexto (2026)

Reglas: qué carga Antigravity y qué lee Claude Code

Antigravity describe las reglas como "instrucciones persistentes, estándares de codificación y restricciones arquitectónicas que dan forma al comportamiento de Antigravity en su base de código". Las descubre en varios lugares: un archivo AGENTS.md o GEMINI.md en cualquier directorio, archivos de reglas en .agents/rules/ y archivos globales bajo ~/.gemini/. Además, los combina. "Las reglas son acumulativas en lugar de basarse en el reemplazo", y "Cuando las instrucciones entran en conflicto, las reglas de directorio más específicas tienen prioridad".

Los archivos de instrucciones de Claude Code son los archivos CLAUDE.md y .claude/rules/. También puede leer AGENTS.md, con una condición que debe conocer antes de añadir nada. Su documentación indica: "Por defecto, Claude lee AGENTS.md solo cuando no hay ningún CLAUDE.md en su directorio de trabajo o por encima de este". Los archivos que cuentan para esa comprobación son "un CLAUDE.md, .claude/CLAUDE.md o CLAUDE.local.md en su directorio de trabajo o en cualquier directorio por encima de este".

Esto le ofrece tres casos para planificar:

• Su proyecto solo utiliza AGENTS.md. Claude Code lo lee sin cambios, siempre que no añada un CLAUDE.md.
• Quiere ambos. Claude Code tiene una configuración de instrucciones de proyecto con el valor claude-md-and-agents-md, que lee "Sus archivos CLAUDE.md y AGENTS.md juntos". Alternativamente, un CLAUDE.md puede importar el AGENTS.md.
• Su proyecto depende de GEMINI.md. La documentación de memoria de Claude Code no incluye GEMINI.md entre los archivos que lee. Cualquier cosa que viva únicamente allí debe trasladarse.

La misma división se aplica a las reglas globales. Los archivos globales independientes de Antigravity incluyen ~/.gemini/AGENTS.md y ~/.gemini/GEMINI.md. El archivo personal de Claude Code es ~/.claude/CLAUDE.md, con reglas personales en ~/.claude/rules/.

Los modos de activación no se mapean uno a uno

Aquí es donde se oculta la mayor parte del cambio de comportamiento. Cada una de las reglas modulares de Antigravity declara un trigger (activador) en su frontmatter, con cuatro valores posibles: always_on, model_decision, glob y manual.

Las reglas de Claude Code tienen dos estados. "Las reglas sin un campo paths se cargan incondicionalmente y se aplican a todos los archivos". Una regla con paths "se carga cuando Claude utiliza la herramienta Read, Write o Edit en un archivo coincidente".

Por lo tanto, el mapeo se ve así:

• always_on se convierte en una regla sin paths, o en contenido dentro de CLAUDE.md.
• glob se convierte en una regla con paths. Antigravity escribe los patrones como una cadena separada por comas en globs. Los ejemplos de Claude Code los listan bajo paths como entradas YAML, por lo que debe reescribirlos en lugar de copiar la línea tal cual.
• model_decision es el caso interesante. Antigravity inyecta solo la ruta y la descripción de la regla por adelantado, y "El agente lee la regla completa bajo demanda cuando su tarea coincide con la descripción". El equivalente más cercano en Claude Code es una skill. Su documentación indica que las skills "solo se cargan cuando las invoca o cuando Claude determina que son relevantes para su prompt".
• Las reglas manual se cargan solo cuando las menciona. En Claude Code, una skill que invoque por su nombre realiza la misma función.

Vale la pena comprobar un detalle más de Antigravity antes de migrar nada. Si un archivo de reglas "omite el frontmatter o especifica un valor de trigger no reconocido (como camelCase alwaysOn o modelDecision), Antigravity descarta la regla silenciosamente". Es posible que algunos archivos de reglas en su repositorio nunca hayan estado activos. Portarlos a Claude Code los activaría por primera vez.

Las referencias a archivos se comportan de manera diferente

Ambas herramientas permiten que una regla apunte a otros archivos, pero tratan la referencia de manera diferente, y esto puede cambiar silenciosamente lo que está en contexto.

Antigravity tiene dos formas. @[label](path) "inserta el contenido del archivo de destino directamente en la regla" antes de que se evalúe el prompt y se comprueben los límites de tamaño. Un simple @filename no inserta nada. Antigravity resuelve la ruta y la reescribe para que el agente tenga una referencia inequívoca al archivo.

Claude Code tiene una sola forma, y realiza una importación. "Los archivos CLAUDE.md pueden importar archivos adicionales utilizando la sintaxis @path/to/import. Los archivos importados se expanden y se cargan en el contexto al inicio junto con el CLAUDE.md que los referencia".

Esto significa que una línea como "check @src/db/schema.ts first", que en Antigravity era un puntero, se convierte en una importación una vez que se encuentra en un CLAUDE.md. La documentación de Claude Code indica que las importaciones @path también se expanden dentro de un AGENTS.md, por lo que el contenido del archivo se carga junto con sus instrucciones. La documentación también ofrece una alternativa de escape: envolver una ruta entre comillas invertidas (backticks) la mantiene como texto literal. Revise sus reglas en busca de referencias simples a @filename y decida, una por una, si desea que se cargue el contenido del archivo o si solo quiere que se mencione su nombre.

Los límites también difieren. Antigravity trunca cualquier archivo de reglas que supere los 24.000 bytes y mantiene todas las reglas always-on dentro de un presupuesto de tokens compartido, degradando los archivos más grandes a punteros cuando lo superan. Claude Code sugiere "apuntar a menos de 200 líneas por archivo CLAUDE.md" y advierte que "Los archivos más largos consumen más contexto y reducen la adherencia". Una regla always-on grande que Antigravity estaba degradando silenciosamente se cargará al inicio en Claude Code si la porta como una regla incondicional.

Las skills se trasladan casi tal cual

Las skills son la parte más sencilla. Antigravity dice que "Las skills son un estándar abierto para ampliar las capacidades del agente", y Claude Code dice que sus skills "siguen el estándar abierto Agent Skills, que funciona en múltiples herramientas de IA". Ambas utilizan una carpeta con un archivo SKILL.md y frontmatter YAML.

Lo que cambia es la ubicación. Antigravity utiliza por defecto .agents/skills/ en el espacio de trabajo, con skills globales bajo ~/.gemini/. Claude Code lee las skills del proyecto desde .claude/skills/<skill-name>/SKILL.md y las skills personales desde ~/.claude/skills/<skill-name>/SKILL.md. Copie cada carpeta de skill en el lugar correspondiente y compruebe su descripción, ya que ambas herramientas la utilizan para decidir cuándo se aplica la skill.

Los servidores MCP necesitan un cambio de formato

Antigravity mantiene los servidores MCP en archivos dedicados: .agents/mcp_config.json para el espacio de trabajo y ~/.gemini/config/mcp_config.json a nivel global. Los servidores remotos utilizan una clave serverUrl.

Claude Code comparte los servidores del proyecto a través de un archivo .mcp.json. Su documentación es específica sobre las entradas remotas: "Una entrada JSON que tiene una url pero no un type es un error de configuración, porque Claude Code lee una entrada sin type como un servidor stdio". No describe ninguna clave serverUrl, por lo que debe reescribir cada entrada remota con una url y el type correcto en lugar de copiar el archivo directamente.

Las conversaciones y los elementos de conocimiento se quedan en Antigravity

Antigravity mantiene el historial de conversaciones por espacio de trabajo. La documentación de su CLI dice que "limita los historiales de conversación directamente a su directorio de trabajo actual". Puede reanudar, renombrar, bifurcar y eliminar conversaciones, y la CLI puede importar hilos iniciados en la aplicación Antigravity 2.0. El directorio de datos locales del agente, ~/.gemini/antigravity/, "contiene artefactos, elementos de conocimiento y más".

La documentación de Antigravity describe la gestión de ese historial dentro de Antigravity. No describe la exportación de conversaciones o elementos de conocimiento para otra herramienta, y la documentación de Claude Code no describe su importación. Trate ambos como material que debe leer y resumir, no como archivos que deba mover.

Paso 1: Inventariar lo que realmente carga Antigravity y decidir a dónde va cada pieza

Haga una lista de cada fuente de instrucciones en su repositorio y en su directorio de inicio: cada AGENTS.md y GEMINI.md, cada archivo en .agents/rules/ con su trigger, los archivos globales bajo ~/.gemini/, las skills y la configuración de MCP. Tome nota de qué interfaz utiliza, ya que la aplicación 2.0, la CLI y el IDE documentan sus propias ubicaciones globales.

Luego clasifique cada elemento:

• Las reglas de proyecto compartidas que todo agente debería leer van en AGENTS.md, si planea seguir utilizando más de una herramienta, o en CLAUDE.md si Claude Code es su único agente.
• El contenido de GEMINI.md que no sea específico de Gemini se traslada a uno de ellos.
• Las reglas glob se convierten en archivos .claude/rules/ con paths.
• Las reglas model_decision y manual se convierten en skills.
• Las reglas con frontmatter roto requieren una decisión: corregir y conservar, o eliminar.

Por último, abra sus conversaciones recientes de Antigravity y anote las decisiones que nunca llegaron a convertirse en una regla: por qué se eligió una biblioteca, qué enfoque se rechazó, qué asume un módulo complejo. Si también viene de Cursor, nuestra guía para mover las reglas de Cursor a Claude Code cubre el mismo tipo de clasificación para las reglas de Cursor.

Paso 2: Reconstruir las instrucciones, skills y servidores en los formatos de Claude Code, y luego comprobar qué se carga

Escriba los nuevos archivos. Mantenga CLAUDE.md corto y mueva cualquier tema específico a reglas o skills. Reescriba las referencias simples a @filename como importaciones deliberadas o como texto literal. Copie las carpetas de skills en .claude/skills/. Reescriba las entradas de MCP en .mcp.json con url y type.

A continuación, verifique. La guía de resolución de problemas de Claude Code sugiere ejecutar /context y revisar la lista de archivos de memoria para ver qué archivos se cargan al inicio, y señala que las reglas con alcance de ruta y los archivos de subdirectorio se cargan bajo demanda. Si depende de AGENTS.md, también sugiere ejecutar /memory y buscar su ruta. Pídale a Claude Code que resuma las instrucciones de su proyecto y compare la respuesta con su inventario.

Si ahora dos archivos ofrecen pautas contradictorias, corríjalo antes de confiar en cualquiera de ellos. Claude Code advierte que "si dos instrucciones se contradicen entre sí, Claude puede elegir una de forma arbitraria". Nuestra guía para conciliar capas conflictivas de CLAUDE.md explica cómo hacerlo.

La migración manual mueve sus reglas. No mueve el razonamiento que vivía en las conversaciones de Antigravity, y vincula el conocimiento de su proyecto a cualquier formato de archivo que lea el agente actual.

Los archivos de reglas son buenos para decirle a un agente qué hacer. Son menos buenos para retener el porqué: el historial de decisiones, los enfoques rechazados, el contexto detrás de una convención. Ese conocimiento tiende a perderse cuando cambia de herramienta, como muestra desde otro ángulo nuestro análisis de por qué los agentes ignoran los archivos de instrucciones que usted escribió.

MemoryLake está diseñado para eso: una capa de memoria que conserva una vez y conecta a los agentes de codificación que utiliza.

Usted mismo escribe las entradas, con sus propias palabras. No se lee, escribe ni elimina nada de sus datos de Antigravity, de su configuración de Claude Code ni del almacenamiento de ningún proveedor. Si el código pertenece a un empleador o cliente, consulte su política antes de copiar detalles del proyecto en otro lugar.

Paso 1: Crear una clave API

Inicie sesión y genere una clave desde el panel de control. La clave pertenece a su espacio de trabajo de MemoryLake, de forma independiente a sus cuentas de Google y Anthropic.

Paso 2: Subir sus primeras memorias

Comience con las decisiones que anotó de sus conversaciones de Antigravity en el Paso 1. Una decisión por entrada, con la fecha, el motivo y la parte de la base de código a la que afecta.

Paso 3: Conectar su IA y agentes

Conecte Claude Code y cualquier otro agente que utilice. Las mismas decisiones del proyecto estarán disponibles en cada uno de ellos, sin necesidad de reescribirlas en el formato de archivo de cada herramienta.

La primera diferencia es que las reglas y los motivos están separados. Las reglas permanecen en CLAUDE.md, .claude/rules/ y en las skills, donde Claude Code las carga. Los motivos viven donde cualquier agente puede encontrarlos.

La segunda es que la próxima migración será más sencilla. Los formatos de instrucciones siguen cambiando, como describe nuestro análisis de lo que realmente leen los agentes de codificación. Las decisiones que se mantienen fuera de esos formatos no tienen que traducirse de nuevo.

La tercera es que habrá menos explicaciones repetidas. Claude Code inicia cada sesión a partir de sus archivos de instrucciones. Si sigue preguntando sobre un contexto que ya había resuelto, nuestra guía sobre por qué Claude Code olvida el contexto del proyecto cubre las causas comunes.

La cuarta es una biblioteca de skills más limpia. Las skills son procedimientos, no memoria, una distinción que se aborda en por qué las skills de los agentes no son memoria. Mantener las decisiones fuera de las skills hace que cada una se concentre en una sola tarea.

Decida sobre AGENTS.md primero. Añadir un CLAUDE.md cambia el hecho de que Claude Code lo lea o no.

No deje contenido en GEMINI.md. La documentación de Claude Code no lo incluye.

Mapee los activadores deliberadamente. glob se convierte en paths, y model_decision normalmente se convierte en una skill.

Audite las referencias @. Un puntero en Antigravity se convierte en una importación completa en Claude Code.

Compruebe las reglas con frontmatter roto. Es posible que Antigravity nunca las haya cargado.

Reescriba las entradas de MCP. Utilice url con un type en .mcp.json.

Anote las decisiones de las conversaciones. No se trasladan por sí solas.

La mayor parte de una configuración de Antigravity tiene cabida en Claude Code. AGENTS.md se puede leer tal cual cuando no hay un CLAUDE.md, las skills siguen el mismo estándar abierto y los servidores MCP necesitan un cambio de formato. Las diferencias que importan son más sutiles: GEMINI.md no está en la lista de Claude Code, los activadores de activación se reducen a paths y skills, y un simple @filename que solo era un puntero en Antigravity se convierte en una importación en Claude Code.

Las conversaciones y los elementos de conocimiento se quedan atrás. Léalos, anote las decisiones que contienen y guarde esas decisiones en un lugar que no dependa del formato de archivo de ningún agente en particular.