Regole di Google Antigravity: configura istruzioni globali e di progetto

Che cosa sono le regole di Antigravity?

Le regole di Google Antigravity sono istruzioni persistenti, standard di codice o vincoli architetturali che l’agente individua nei file e applica alle attività pertinenti. Un messaggio in chat di solito vale per una sola conversazione. Una regola diventa contesto salvato e può influenzare le conversazioni successive nell’ambito in cui Antigravity la trova. È utile per le decisioni che spieghi spesso, come quali test eseguire, come trattare i file generati o quali convenzioni di database usa un progetto.

Una configurazione utile delle regole di Google Antigravity risponde a tre domande: quali attività copre l’istruzione, che cosa deve fare l’agente e quale limite deve rispettare. Sii abbastanza specifico da guidare un’azione, ma mantieni il testo breve e facile da rivedere. Le regole non concedono automaticamente il permesso di eseguire qualsiasi comando o azione esterna. Continua a controllare modifiche proposte, comandi shell, accesso alla rete, segreti e operazioni distruttive secondo il tuo normale processo di revisione.

• Messaggio Una richiesta una tantum per la conversazione corrente.
• Regola Un’istruzione persistente individuata in un file e in un ambito supportati.
• Skill Un pacchetto riutilizzabile di procedure e risorse per un’attività; consulta la guida separata alle Skills di Antigravity.

Scegli l’ambito globale, dello spazio di lavoro o della directory

Scegli l’ambito più ristretto che includa tutte le persone e i progetti interessati. Una regola globale segue il tuo profilo utente tra gli spazi di lavoro, quindi riservala a preferenze personali sicure ovunque. Una regola dello spazio di lavoro rimane con il repository e può essere esaminata dal team insieme al codice. Una regola di directory è adatta quando una parte di un progetto grande segue convenzioni che non devono influenzare le altre cartelle.

Le regole di Google Antigravity sono cumulative: Antigravity combina le istruzioni trovate invece di considerare ogni nuovo file una sostituzione. Se due indicazioni sono in conflitto, le regole di directory più specifiche hanno la precedenza. Evita di creare istruzioni globali e di repository contraddittorie; descrivi chiaramente le eccezioni locali. La tabella mostra i percorsi attualmente documentati per l’app Antigravity.

Crea una regola nell’app Antigravity

Nell’app Antigravity, apri il pannello Customizations dal menu dell’applicazione o dalle impostazioni del progetto, seleziona la scheda Rules e scegli + Global oppure + Workspace in base all’ambito necessario. L’app crea una regola basata su file che puoi controllare e modificare. Nelle interfacce IDE o CLI i controlli possono essere diversi: segui i percorsi documentati e le istruzioni specifiche per ciascuna superficie.

Per una regola di repository, parti da una decisione ricorrente invece che da un manifesto generale. Specifica i file o le attività interessate, il comportamento da seguire e come verificarlo. Un’indicazione verificabile come «esegui i test unitari pertinenti dopo aver modificato il parser» è più utile di «fai attenzione». Mantieni i fatti specifici del progetto nella regola del repository, così gli altri collaboratori possono rivederli e aggiornarli insieme al codice.

1. Scegli l’ambitoDecidi se l’istruzione appartiene al profilo utente, allo spazio di lavoro o a una sottocartella.
2. Apri RulesNell’app, entra in Customizations e poi in Rules; crea una voce Global o Workspace.
3. Descrivi un comportamentoIndica lo scopo, le attività interessate, l’azione richiesta e una verifica utile.
4. Controlla il fileConferma il percorso salvato e rileggi il testo definitivo prima di farci affidamento.

Configura il frontmatter e le modalità di attivazione

I file autonomi AGENTS.md e GEMINI.md non usano frontmatter. Il loro contenuto Markdown rimane attivo nell’ambito della directory. Ogni file Markdown modulare dentro una cartella rules/ deve iniziare con frontmatter YAML e dichiarare un trigger valido. Il trigger stabilisce quando la regola viene caricata nel contesto: sceglilo in base alla prevedibilità e alla frequenza delle attività interessate.

Usa always_on per una breve istruzione necessaria in ogni turno del relativo ambito. Scegli model_decision per una guida più lunga che l’agente apre quando la descrizione corrisponde all’attività. Usa glob se la regola dipende da modelli di file e includi il campo obbligatorio globs. Usa manual se l’agente deve caricarla solo dopo una menzione esplicita con @. La documentazione attuale elenca questi quattro valori di trigger.

---
trigger: glob
globs: "*.ts, *.tsx"
description: "Applica queste convenzioni quando modifichi file TypeScript."
---

# Modifiche TypeScript

- Assegna tipi alle funzioni esportate.
- Esegui il test TypeScript mirato dopo la modifica.
- Non modificare a mano i file generati.

Verifica che la regola si applichi

Il fatto che il file sia salvato non dimostra che l’istruzione prevista sia stata caricata. Prova la regola con una richiesta piccola e a basso rischio che rientri chiaramente nel suo ambito. Per una regola glob, usa un file che corrisponde al modello e un file vicino che non corrisponde. Per manual, menziona esplicitamente la regola una volta e confronta il risultato con un’attività senza menzione. Mantieni il test circoscritto così puoi osservare l’influenza della regola.

Durante la revisione, cerca il comportamento preciso che hai scritto, non un’impressione generale di maggiore prudenza. Controlla i file modificati e i comandi. Se manca il comportamento atteso, verifica percorso, radice dello spazio di lavoro, ortografia del frontmatter, trigger, modello glob e possibili regole più specifiche. Cambia una causa alla volta e ripeti la stessa prova per capire se la correzione ha funzionato.

1. Scegli un’attività chiaraUsa un’azione limitata che dovrebbe risentire della regola ed evita modifiche rischiose.
2. Controlla il confinePer le regole sui file, confronta un file corrispondente con uno che non corrisponde.
3. Esamina le proveConfronta risposta, comandi, file modificati e test con il testo della regola.
4. Ripeti dopo le modificheCambia un dettaglio dell’ambito o del trigger e ripeti lo stesso controllo.

Risolvi i problemi e mantieni aggiornate le regole

Se le regole di Google Antigravity sembrano ignorate, verifica prima che il file si trovi nello spazio di lavoro attivo e in una posizione supportata. Controlla poi il nome esatto, la grafia .agents e i delimitatori o l’indentazione YAML. Una regola modulare senza trigger valido potrebbe non essere caricata come previsto. Per glob, prova un percorso che dovrebbe corrispondere e controlla le virgolette del modello. Una regola manual richiede una menzione esplicita con @ e non è pensata per attivarsi automaticamente.

Le regole hanno anche limiti di contesto. La documentazione indica un limite di 24 KB per file dopo l’espansione delle inclusioni e un budget condiviso di 20.000 token per le regole globali attive e quelle always_on. Se il budget complessivo viene superato, i file più grandi possono essere ridotti a riferimenti con percorso e descrizione. Mantieni breve always_on, sposta il materiale lungo in una regola model_decision e spiega in description quando l’agente dovrebbe aprirla.