Reglas de Google Antigravity: configura instrucciones globales y de proyecto

¿Qué son las reglas de Antigravity?

Las reglas de Antigravity son instrucciones persistentes que el agente encuentra en archivos y aplica al trabajo correspondiente. A diferencia de un mensaje de chat, una regla queda guardada y puede influir en tareas futuras dentro de su ámbito. Úsala para decisiones recurrentes sobre pruebas, archivos generados o convenciones de base de datos.

Una configuración útil de reglas de Google Antigravity define qué tareas cubre, qué debe hacer el agente y qué límites debe respetar. Sé preciso y conciso. Las reglas no autorizan automáticamente comandos ni acciones externas; revisa los cambios, el acceso a la red, los secretos y las operaciones destructivas según tu proceso habitual.

• Mensaje Una petición para la conversación actual.
• Regla Una instrucción persistente que se descubre desde un archivo y un ámbito admitidos.
• Skill Un paquete reutilizable de procedimientos y recursos para una tarea; consulta la guía independiente de Skills de Antigravity.

Elige entre ámbito global, del espacio de trabajo o del directorio

Elige el ámbito más limitado que cubra a las personas y proyectos que lo necesitan. Una regla global sigue tu perfil entre espacios de trabajo: resérvala para preferencias personales válidas en todas partes. Las reglas del espacio de trabajo permanecen con el repositorio para que el equipo las revise. Usa reglas de directorio cuando una parte del proyecto tenga convenciones distintas.

Las reglas de Google Antigravity se acumulan; las de directorio más específicas tienen prioridad en caso de conflicto. Evita contradicciones entre las pautas globales y las del repositorio y documenta las excepciones. La tabla recoge las ubicaciones actuales admitidas.

Crea una regla en la aplicación de Antigravity

En la aplicación de Antigravity, abre el panel Customizations desde el menú de la aplicación o la configuración del proyecto, selecciona la pestaña Rules y elige + Global o + Workspace según el ámbito que necesites. La aplicación crea una regla basada en un archivo que puedes revisar y editar. En las superficies IDE o CLI, usa las ubicaciones de archivo documentadas y consulta sus instrucciones específicas, porque los controles pueden ser distintos.

Para una regla del repositorio, empieza por una decisión recurrente, no por un manifiesto general. Indica qué archivos o tareas cubre, qué comportamiento debe seguir el agente y cómo comprobarlo. Es mejor una indicación revisable como «ejecuta las pruebas unitarias específicas después de cambiar código del analizador» que una frase vaga como «ten cuidado». Mantén los datos del proyecto en la regla del repositorio para que otros colaboradores puedan revisarlos y actualizarlos junto al código.

1. Elige el ámbitoDecide si la instrucción pertenece a tu perfil, al espacio de trabajo o a un subdirectorio.
2. Abre RulesEn la aplicación, entra en Customizations y luego en Rules; crea una entrada Global o Workspace.
3. Define un comportamientoExplica el objetivo, las tareas aplicables, la acción requerida y una forma útil de verificarla.
4. Revisa el archivoConfirma la ruta guardada y lee el texto final antes de depender de él.

Configura el frontmatter y los modos de activación

Los archivos independientes AGENTS.md y GEMINI.md no usan frontmatter. Su contenido Markdown permanece activo en el ámbito del directorio. Cada archivo Markdown modular dentro de una carpeta rules/ debe comenzar con frontmatter YAML y un trigger válido. Ese trigger determina cuándo se carga la regla, así que elige el modo según la previsibilidad y la frecuencia del trabajo que cubre.

Usa always_on para una instrucción breve que debe estar presente en cada turno dentro del ámbito. Usa model_decision para una guía más extensa que solo debe abrirse cuando la descripción encaje con la tarea. Usa glob si la regla depende de patrones de archivos e incluye el campo globs requerido. Usa manual si el agente solo debe cargarla tras una mención explícita con @. La documentación actual enumera estos cuatro valores de trigger.

---
trigger: glob
globs: "*.ts, *.tsx"
description: "Aplica estas convenciones al cambiar archivos TypeScript."
---

# Cambios de TypeScript

- Mantén tipadas las funciones exportadas.
- Ejecuta la prueba de TypeScript específica después de editar.
- No cambies manualmente los archivos generados.

Comprueba que la regla se aplica

Que el archivo esté guardado no demuestra que se haya cargado la instrucción prevista. Prueba la regla con una petición pequeña y de bajo riesgo que encaje claramente en su ámbito. Para una regla glob, usa un archivo que coincida con el patrón y otro cercano que no coincida. Para una regla manual, menciónala explícitamente una vez y compara el resultado con una tarea en la que omitas la mención. Mantén la prueba acotada para poder observar si la regla influyó en la respuesta.

Al revisar el resultado, busca el comportamiento concreto que escribiste, no una impresión general de que el agente parece más cuidadoso. Inspecciona los archivos modificados y los comandos. Si el comportamiento esperado no aparece, comprueba la ruta, la raíz del espacio de trabajo, la ortografía del frontmatter, el trigger, el patrón glob y si una regla más específica cambia la instrucción. Cambia una causa cada vez y repite la misma prueba para saber si la corrección tuvo efecto.

1. Elige una tarea claraUsa una acción pequeña que deba verse afectada y evita cambios arriesgados.
2. Comprueba el límitePara reglas de archivos, compara un archivo coincidente con otro que no lo sea.
3. Inspecciona la evidenciaCompara la respuesta, los comandos, los archivos modificados y las pruebas con el texto de la regla.
4. Repite tras editarCambia un detalle de ámbito o trigger y vuelve a ejecutar la misma comprobación.

Soluciona problemas y mantén las reglas

Si las reglas de Google Antigravity parecen ignoradas, comprueba primero que el archivo está en el espacio de trabajo activo y en una ubicación admitida. Después revisa el nombre exacto, la grafía .agents y los delimitadores o la sangría YAML. Una regla modular sin trigger válido puede no cargarse como esperas. Para una regla glob, prueba una ruta que sepas que coincide y revisa las comillas del patrón. Una regla manual requiere una mención explícita con @; no está pensada para activarse automáticamente.

Las reglas también tienen límites prácticos de contexto. La documentación indica un límite de 24 KB por archivo después de ampliar las inclusiones y un presupuesto de 20.000 tokens compartido por las reglas globales activas y las reglas always_on. Si se supera el presupuesto total, los archivos de regla más grandes pueden convertirse en referencias de ruta y descripción. Mantén breve el contenido always_on, mueve el material extenso a una regla model_decision y explica en su description cuándo debe abrirla el agente.