Regras do Google Antigravity: configure instruções globais e de projeto

O que são as regras do Antigravity?

As regras do Google Antigravity são instruções persistentes, padrões de código ou restrições de arquitetura que o agente encontra em arquivos e aplica ao trabalho correspondente. Uma mensagem de chat vale para uma conversa; uma regra fica salva e pode influenciar conversas futuras no escopo em que o Antigravity a encontra. Use-a para decisões recorrentes sobre testes, arquivos gerados e convenções de banco de dados.

Uma configuração útil das regras do Google Antigravity define quais tarefas cobre, o que o agente deve fazer e quais limites respeitar. Seja específico e conciso. Regras não autorizam automaticamente comandos ou ações externas; continue verificando alterações, acesso à rede, segredos e operações destrutivas conforme seu processo normal.

• Mensagem Um pedido pontual para a conversa atual.
• Regra Uma instrução persistente encontrada em um arquivo e escopo compatíveis.
• Skill Um pacote reutilizável de procedimentos e recursos para uma tarefa; veja o guia separado de Skills do Antigravity.

Escolha o escopo global, do espaço de trabalho ou do diretório

Escolha o escopo mais restrito que ainda atenda às pessoas e aos projetos que precisam da instrução. Uma regra global acompanha o perfil do usuário entre espaços de trabalho, então reserve-a para preferências pessoais seguras em qualquer lugar. Uma regra do espaço de trabalho fica com o repositório e pode ser revisada pela equipe junto com o código. Uma regra de diretório é útil quando uma parte de um projeto grande tem convenções que não devem afetar outras pastas.

As regras do Google Antigravity são cumulativas: o Antigravity reúne as instruções encontradas em vez de tratar cada arquivo novo como substituto dos anteriores. Quando duas orientações entram em conflito, regras mais específicas do diretório têm prioridade. Evite contradições entre instruções globais e as do repositório e descreva qualquer exceção local com clareza. A tabela mostra os locais descritos atualmente para o Antigravity App.

Crie uma regra no aplicativo Antigravity

No Antigravity App, abra o painel Customizations pelo menu do aplicativo ou pelas configurações do projeto. Escolha a aba Rules e selecione + Global ou + Workspace conforme o escopo necessário. O aplicativo cria uma regra baseada em arquivo que você pode revisar e editar. Nas interfaces IDE ou CLI, consulte os caminhos documentados e as instruções específicas de cada superfície, porque os controles podem ser diferentes.

Para uma regra do repositório, comece por uma decisão recorrente em vez de um manifesto amplo. Informe quais arquivos ou tarefas ela cobre, qual comportamento seguir e como verificar o resultado. Uma instrução verificável, como «execute os testes unitários relacionados após alterar o parser», é melhor do que «tenha cuidado». Mantenha os fatos do projeto na regra do repositório para que outras pessoas possam revisá-los e atualizá-los junto com o código.

1. Escolha o escopoDecida se a instrução pertence ao perfil do usuário, ao espaço de trabalho ou a um subdiretório.
2. Abra RulesNo aplicativo, entre em Customizations e depois em Rules; crie uma entrada Global ou Workspace.
3. Defina um comportamentoDescreva a finalidade, as tarefas cobertas, a ação necessária e uma verificação útil.
4. Confira o arquivoConfirme o caminho salvo e leia o texto final antes de depender dele.

Configure o frontmatter e os modos de ativação

Os arquivos independentes AGENTS.md e GEMINI.md não usam frontmatter. O conteúdo Markdown deles fica ativo no escopo do diretório. Cada arquivo Markdown modular dentro de uma pasta rules/ precisa começar com frontmatter YAML e declarar um trigger válido. O trigger determina quando a regra é carregada; escolha-o conforme a previsibilidade e a frequência das tarefas cobertas.

Use always_on para uma instrução curta que deve estar presente em todos os turnos dentro do escopo. Use model_decision para uma orientação mais extensa que o agente deve abrir quando a descrição corresponder à tarefa. Use glob quando a regra depender de padrões de arquivos e inclua o campo obrigatório globs. Use manual quando o agente só deve carregar a regra depois de uma menção explícita com @. A documentação atual lista esses quatro valores de trigger.

---
trigger: glob
globs: "*.ts, *.tsx"
description: "Aplique estas convenções ao alterar arquivos TypeScript."
---

# Alterações em TypeScript

- Tipifique as funções exportadas.
- Execute o teste direcionado de TypeScript depois da edição.
- Não altere arquivos gerados manualmente.

Verifique se a regra está sendo aplicada

Salvar um arquivo não prova que a instrução pretendida foi carregada. Teste a regra com um pedido pequeno e de baixo risco que se encaixe claramente no escopo. Para uma regra glob, use um arquivo que corresponda ao padrão e outro próximo que não corresponda. Para uma regra manual, mencione-a explicitamente uma vez e compare o resultado com uma tarefa sem a menção. Mantenha a tarefa limitada para conseguir observar se a regra alterou a resposta.

Ao revisar o resultado, procure o comportamento específico que você descreveu, não apenas a impressão de que o agente parece mais cuidadoso. Inspecione os arquivos alterados e os comandos executados. Se a ação esperada não aparecer, confira o caminho, a raiz do espaço de trabalho, a grafia do frontmatter, o trigger, o padrão glob e se uma regra mais específica muda a instrução. Altere uma causa por vez e repita o mesmo teste para saber se o ajuste funcionou.

1. Escolha uma tarefa claraUse uma ação pequena que deva ser afetada pela regra e evite alterações arriscadas.
2. Confira o limitePara regras por arquivo, compare um arquivo correspondente com outro que não corresponda.
3. Inspecione as evidênciasCompare a resposta, os comandos, os arquivos alterados e os testes com o texto da regra.
4. Repita depois de editarMude um detalhe do escopo ou trigger e execute novamente a mesma verificação.

Solucione problemas e mantenha as regras

Se as regras do Google Antigravity parecerem ignoradas, confirme primeiro se o arquivo está no espaço de trabalho ativo e em um local compatível. Depois confira o nome exato, a grafia .agents e os delimitadores ou a indentação YAML. Uma regra modular sem trigger válido pode não ser carregada como esperado. Para glob, teste um caminho que certamente corresponda e confira as aspas do padrão. Uma regra manual precisa ser mencionada com @; ela não deve ser ativada automaticamente.

As regras também têm limites de contexto. A documentação informa um limite de 24 KB por arquivo depois da expansão de inclusões e um orçamento compartilhado de 20.000 tokens para regras globais ativas e regras always_on. Se o total for excedido, os arquivos maiores podem ser reduzidos a referências com caminho e descrição. Mantenha o conteúdo always_on curto, mova material extenso para uma regra model_decision e explique em description quando o agente deve abri-la.