Tutorial de Antigravity Rules: configura Rules y Workflows (2026)
Las Rules son instrucciones permanentes que el agente de Antigravity respeta en cada conversación; los Workflows son rutinas de varios pasos que relanzas con un comando slash. Esta guía sigue una grabación de pantalla limpia paso a paso: cada captura verificada a mano y cada paso enlazado al segundo exacto del vídeo original.
Respuesta rápida — qué son las Rules de Antigravity
- Las Rules son instrucciones permanentes que Antigravity inyecta en el contexto del agente en cada turno: estándares de código, restricciones, estilo. Los Workflows son listas de pasos guardadas que el agente ejecuta cuando escribes un comando slash.
- Ambos se crean desde el panel Agent: abre el menú Customization, entra en la pestaña Rules y pulsa + Global para todos los proyectos o + Workspace solo para el actual.
- Una regla + Global se escribe en ~/.gemini/GEMINI.md (AGENTS.md también vale); las reglas de workspace viven en .agents/rules/*.md de tu repositorio. Los disparadores frontmatter deciden cuándo carga cada regla modular: always_on, model_decision, glob o manual.
- Ojo con los límites: un archivo de reglas se limita a 24 KB, y el presupuesto de unas 20.000 tokens para reglas globales y always_on en línea degrada los archivos más grandes a punteros de ruta en vez de truncarlos a ciegas.
How To Use Google Antigravity Rules & Workflows [2026 GUIDE]
Vídeo:Nexustech4:04
Rules — Google Antigravity documentation
Documentación oficial:Google
Cuando esta guía va más allá del vídeo, manda la documentación oficial de Rules de Google: el límite de 24 KB por archivo, el presupuesto en línea de 20.000 tokens y los cuatro disparadores frontmatter.
Las capturas son fotogramas de la grabación de YouTube acreditada, usados con atribución; cada imagen enlaza al segundo exacto de donde se tomó. Los pasos escritos son propios.
Configurar Rules y Workflows de Antigravity, paso a paso
1 · Abrir el panel Customizations
- 1
Abre Antigravity y confirma en qué proyecto estás
Arranca Antigravity y mira antes que nada el nombre del workspace en el Explorer. El alcance importa: solo las reglas globales te siguen entre proyectos; las de workspace se aplican únicamente al proyecto abierto. Decide el alcance antes de escribir nada.
El IDE Antigravity antes de cualquier personalización: fíjate en el nombre del workspace antes de elegir el alcance.Ver en 0:20 - 2
Abre el menú Customization en la cabecera del panel Agent
En el panel lateral Agent, pasa el cursor por los iconos de la esquina superior derecha hasta que el tooltip muestre Customization y MCP Servers, y haz clic. Se abre el panel Customizations, el único lugar donde viven rules y workflows en Antigravity 2.x.
El icono Customization está en la cabecera del panel Agent, junto a MCP Servers.Ver en 1:30 - 3
Abre la pestaña Rules
El panel Customizations se abre en la pestaña Rules con dos botones: + Global y + Workspace. Debajo, Antigravity explica que las rules ayudan a guiar el comportamiento del Agent. Elige + Global para instrucciones válidas en todos los proyectos, + Workspace para limitarlas al repositorio.
Una lista de reglas vacía con los botones + Global y + Workspace.Ver en 1:38
2 · Crear tu primera regla
- 4
Pulsa + Global — Antigravity te abre GEMINI.md
Al pulsar + Global se abre el archivo de reglas global en el editor con una línea de marcador. Al pasar el cursor aparece la tarjeta Global Antigravity IDE Rules File: las reglas globales se cargan en modo Agent en todos tus workspaces como pautas concretas. La tarjeta incluye hasta cuatro reglas de ejemplo que puedes copiar.
La tarjeta emergente del archivo de reglas global explica su alcance y muestra reglas de ejemplo.Ver en 1:53 - 5
Escribe tus reglas — líneas cortas, una instrucción por línea
Sustituye el marcador por instrucciones en texto plano, una por línea: My testing framework is php8, Don't use these APIs: ..., Before making changes, create these plans first. Cada regla, una frase clara — los párrafos vagos se ignoran.
Las reglas son texto plano, una instrucción por línea, sin marcado.Ver en 2:12 - 6
Guarda el archivo — las reglas ya están activas
Guarda GEMINI.md (el punto en la pestaña indica cambios sin guardar). Una vez guardadas, esas líneas se inyectan en el contexto del agente en cada turno y en cada workspace: dejas de repetir las mismas instrucciones en el chat. El icono de información junto al editor vuelve a abrir la explicación del alcance cuando quieras.
Tres reglas guardadas en GEMINI.md — activas en todos los workspaces a partir de ahora.Ver en 2:27
3 · Guardar un workflow reutilizable
- 7
Cambia a la pestaña Workflows
Junto a Rules está la pestaña Workflows. Antigravity los describe como prompts guardados que el Agent puede seguir: se disparan escribiendo / en el cuadro del Agent. Sirven para rutinas que repites: revisar un proyecto, analizar archivos, preparar un release.
La pestaña Workflows explica cómo un comando slash dispara una rutina guardada.Ver en 2:58 - 8
Crea el workflow y ponle nombre
Pulsa + Global o + Workspace bajo Workflows y aparecerá un diálogo de nombre con el ejemplo debug-memory-leak. Enter confirma, Escape cancela. Ese nombre se convierte en el comando slash: corto y descriptivo, review-project gana a workflow1.
Nombrar el workflow — ese nombre se convierte en su comando slash.Ver en 3:20 - 9
¿Error de nombre inválido? Solo minúsculas y guiones
Un nombre con espacios o mayúsculas se rechaza: Invalid workflow name. Only lowercase letters, numbers, and hyphens are allowed. Cambia los espacios por guiones — read-the-main-files — y el diálogo lo acepta.
El error de validación que aparece cuando el nombre del workflow contiene espacios.Ver en 3:25 - 10
Describe el workflow en su frontmatter
Antigravity abre el workflow como archivo Markdown (untitled.md hasta que lo nombras) con un campo description en el frontmatter. Escribe una línea sobre cuándo usarlo: el agente la lee para decidir si el workflow encaja con la petición actual.
Cada workflow es un archivo Markdown con frontmatter description.Ver en 3:36
4 · Escribir los pasos y ejecutar el workflow
- 11
Enumera los pasos en el orden en que deben ejecutarse
Bajo el frontmatter, escribe pasos numerados en texto plano: read the main files, find anything that looks wrong, explain the problem in simple terms, suggest a fix, wait for approval before changing anything. Una lista ordenada mantiene al agente estructurado en vez de adivinando.
El primer paso, read the main files, escrito bajo el frontmatter.Ver en 3:48 - 12
Guárdalo y ejecuta el workflow con un comando slash
Guarda el archivo del workflow, vuelve al cuadro del Agent y escribe / para listar tus workflows: elige el tuyo y el agente recorre los pasos guardados. Las Rules mantienen el comportamiento consistente; los Workflows ponen tus rutinas a un golpe de tecla.
El workflow terminado, listo para dispararse con su comando slash.Ver en 3:57
¿Las Rules de Antigravity no funcionan? Revisa esto
Las reglas no surten efecto
Comprueba primero la ubicación: las reglas globales deben vivir bajo ~/.gemini/ (GEMINI.md o AGENTS.md, archivos modulares en ~/.gemini/config/rules/), y las de workspace en .agents/rules/ al nivel de directorio correcto: solo se leen los .md hijos directos de una carpeta rules; los archivos más profundos deben registrarse en .agents/rules.json. Revisa también el frontmatter: disparadores en camelCase como alwaysOn se rechazan, escribe snake_case always_on — y una regla manual solo carga cuando la mencionas con @ en el chat.
Un archivo de reglas se trunca
Un archivo de reglas de más de 24 KB se trunca tras expandir los includes: nada de lo que quede fuera llega al modelo. Divide las reglas enormes en archivos modulares pequeños dentro de una carpeta rules/, un tema por archivo.
Las reglas desaparecen en silencio del contexto
Todas las reglas globales y always_on en línea comparten un presupuesto de unas 20.000 tokens. Al superarlo, Antigravity degrada los archivos más grandes a punteros de una línea que el agente lee bajo demanda: la regla sigue existiendo, pero ya no se inlinea. Recorta o divide tu conjunto always-on, o pasa las reglas poco usadas a model_decision o manual.