Antigravity Rules einrichten: Rules & Workflows Tutorial (2026)
Rules sind feste Anweisungen, die Ihr Antigravity-Agent in jeder Unterhaltung befolgt; Workflows sind gespeicherte Abläufe, die Sie per Slash-Befehl immer wieder starten. Diese Anleitung folgt Schritt für Schritt einer sauberen Bildschirmaufnahme — jeder Screenshot geprüft, jeder Schritt mit der exakten Stelle im Quellvideo verlinkt.
Kurzantwort — was Antigravity Rules sind
- Rules sind dauerhafte Anweisungen, die Antigravity in jeder Runde in den Kontext des Agenten lädt — Codestandards, Einschränkungen, Stil. Workflows sind gespeicherte Checklisten, die der Agent auf einen Slash-Befehl hin abarbeitet.
- Beides entsteht im Agent-Panel: das Customization-Menü öffnen, zum Rules-Tab wechseln und + Global für alle Projekte oder + Workspace nur für das aktuelle klicken.
- Eine + Global-Regel landet in ~/.gemini/GEMINI.md (AGENTS.md funktioniert ebenfalls); Workspace-Regeln liegen im Repo unter .agents/rules/*.md. Frontmatter-Trigger bestimmen, wann jede modulare Regel lädt: always_on, model_decision, glob oder manual.
- Budgets beachten: Eine Regeldatei ist auf 24 KB begrenzt, und die ~20.000-Token-Grenze für inline geladene globale und always_on-Regeln stuft die größten Dateien zu Pfadzeigern herab, statt blind zu kürzen.
How To Use Google Antigravity Rules & Workflows [2026 GUIDE]
Video:Nexustech4:04
Rules — Google Antigravity documentation
Offizielle Doku:Google
Wo diese Anleitung über das Video hinausgeht, gilt Googles offizielle Rules-Dokumentation — inklusive 24-KB-Limit pro Datei, 20.000-Token-Inline-Budget und der vier Frontmatter-Trigger.
Screenshots sind Standbilder aus der namentlich genannten YouTube-Aufzeichnung und werden mit Quellenangabe verwendet; jedes Bild verlinkt auf die exakte Sekunde. Die Textschritte sind eigenständig verfasst.
Antigravity Rules und Workflows Schritt für Schritt
1 · Das Customizations-Panel öffnen
- 1
Antigravity öffnen und prüfen, welches Projekt aktiv ist
Starten Sie Antigravity und werfen Sie vor allem anderen einen Blick auf den Workspace-Namen im Explorer. Der Geltungsbereich zählt: Nur globale Regeln folgen Ihnen über Projekte hinweg, Workspace-Regeln gelten nur für das geöffnete Projekt — entscheiden Sie das also, bevor Sie schreiben.
Antigravity IDE vor jeder Anpassung — Workspace-Namen beachten, bevor der Geltungsbereich gewählt wird.Szene bei 0:20 ansehen - 2
Customization-Menü in der Agent-Panel-Kopfzeile öffnen
Fahren Sie im Agent-Seitenpanel über die Icons oben rechts, bis der Tooltip Customization und MCP Servers zeigt, und klicken Sie dann. Es öffnet sich das Customizations-Panel — der zentrale Ort für Rules und Workflows in Antigravity 2.x.
Das Customization-Symbol sitzt in der Kopfzeile des Agent-Panels neben MCP Servers.Szene bei 1:30 ansehen - 3
Rules-Tab öffnen
Das Customizations-Panel öffnet im Rules-Tab mit zwei Buttons: + Global und + Workspace. Darunter erklärt Antigravity, dass Rules das Verhalten des Agenten lenken. + Global für Anweisungen, die in jedem Projekt gelten sollen, + Workspace, um sie auf das Repo zu beschränken.
Eine leere Regelliste mit den Buttons + Global und + Workspace.Szene bei 1:38 ansehen
2 · Die erste Regel anlegen
- 4
+ Global klicken — Antigravity öffnet GEMINI.md von selbst
Nach einem Klick auf + Global öffnet sich die globale Regeldatei mit einer Platzhalterzeile im Editor. Beim Darüberfahren erscheint die Karte Global Antigravity IDE Rules File: globale Regeln werden agentenweit in allen Workspaces als konkrete Richtlinien geladen. Die Karte listet sogar vier Beispielregeln zum Übernehmen.
Die Hover-Karte zur globalen Regeldatei erklärt den Geltungsbereich und zeigt Beispielregeln.Szene bei 1:53 ansehen - 5
Regeln schreiben — kurze Zeilen, eine Anweisung je Zeile
Ersetzen Sie den Platzhalter durch klare Anweisungen, eine pro Zeile: My testing framework is php8, Don't use these APIs: ..., Before making changes, create these plans first. Jede Regel bleibt ein eindeutiger Satz — vage Absätze werden ignoriert.
Rules sind Klartext, eine Anweisung pro Zeile, ohne Markup.Szene bei 2:12 ansehen - 6
Datei speichern — die Regeln sind jetzt aktiv
Speichern Sie GEMINI.md (der Punkt im Tab zeigt ungespeicherte Änderungen). Ab dem Moment werden diese Zeilen in jeder Runde in jedem Workspace in den Kontext injiziert — dieselben Anweisungen im Chat entfallen. Das Info-Symbol neben dem Editor öffnet die Erklärung zum Geltungsbereich jederzeit wieder.
Drei gespeicherte Regeln in GEMINI.md — ab jetzt in jedem Workspace aktiv.Szene bei 2:27 ansehen
3 · Einen wiederverwendbaren Workflow speichern
- 7
Zum Workflows-Tab wechseln
Neben Rules liegt der Workflows-Tab. Antigravity beschreibt Workflows als gespeicherte Prompts, denen der Agent folgen kann — ausgelöst werden sie, indem Sie im Agent-Eingabefeld ein / tippen. Ideal für wiederkehrende Routinen: Projekt-Review, Dateianalyse, Release-Vorbereitung.
Der Workflows-Tab erklärt, wie ein Slash-Befehl eine gespeicherte Routine auslöst.Szene bei 2:58 ansehen - 8
Workflow anlegen und benennen
Ein Klick auf + Global oder + Workspace unter Workflows öffnet einen Namensdialog mit dem Beispiel debug-memory-leak. Enter bestätigt, Escape bricht ab. Der Name wird zum Slash-Befehl — kurz und aussagekräftig wählen, review-project schlägt workflow1.
Workflow benennen — aus diesem Namen wird sein Slash-Befehl.Szene bei 3:20 ansehen - 9
Fehler wegen ungültigem Namen? Nur Kleinbuchstaben und Bindestriche
Namen mit Leerzeichen oder Großbuchstaben werden abgelehnt: Invalid workflow name. Only lowercase letters, numbers, and hyphens are allowed. Ersetzen Sie Leerzeichen durch Bindestriche — read-the-main-files — schon nimmt der Dialog den Namen an.
Der Validierungsfehler, der bei Leerzeichen im Workflow-Namen erscheint.Szene bei 3:25 ansehen - 10
Den Workflow im Frontmatter beschreiben
Antigravity öffnet den Workflow als Markdown-Datei (vor der Benennung untitled.md) mit einem description-Feld im Frontmatter. Schreiben Sie eine Zeile dazu, wann er zum Einsatz kommt — der Agent liest sie, um zu entscheiden, ob der Workflow zur Anfrage passt.
Jeder Workflow ist eine Markdown-Datei mit description-Frontmatter.Szene bei 3:36 ansehen
4 · Schritte schreiben und Workflow ausführen
- 11
Schritte in der Ausführungsreihenfolge auflisten
Schreiben Sie unter dem Frontmatter nummerierte Schritte als Klartext: read the main files, find anything that looks wrong, explain the problem in simple terms, suggest a fix, wait for approval before changing anything. Eine geordnete Checkliste hält den Agenten strukturiert statt ratend.
Der erste Schritt read the main files unter dem Frontmatter eingetippt.Szene bei 3:48 ansehen - 12
Speichern, dann den Workflow per Slash-Befehl ausführen
Speichern Sie die Workflow-Datei, zurück im Agent-Feld listet ein / Ihre Workflows — wählen Sie Ihren aus, und der Agent arbeitet die gespeicherten Schritte ab. Rules halten das Verhalten des Agenten konsistent, Workflows machen Routinen mit einem Tastenschlag verfügbar.
Der fertige Workflow, bereit zum Auslösen per Slash-Befehl.Szene bei 3:57 ansehen
Antigravity Rules wirken nicht? Zuerst das prüfen
Regeln zeigen keine Wirkung
Prüfen Sie zuerst den Dateipfad: Globale Regeln liegen unter ~/.gemini/ (GEMINI.md oder AGENTS.md, modulare Dateien in ~/.gemini/config/rules/), Workspace-Regeln in .agents/rules/ auf der richtigen Verzeichnisebene — eingelesen werden nur direkte .md-Kinder eines rules-Ordners, tiefer liegende Dateien müssen in .agents/rules.json registriert werden. Auch das Frontmatter prüfen: Trigger wie alwaysOn (CamelCase) werden abgelehnt, es heißt snake_case always_on — und eine manual-Regel lädt erst, wenn Sie sie im Chat mit @ erwähnen.
Eine Regeldatei wird abgeschnitten
Eine einzelne Regeldatei über 24 KB wird nach dem Auflösen der Includes gekürzt — alles jenseits der Grenze erreicht das Modell nie. Teilen Sie übermäßige Regeln in kleinere modulare Dateien in einem rules/-Ordner auf, eine Datei pro Thema.
Regeln fehlen still im Kontext
Alle inline geladenen globalen und always_on-Regeln teilen sich ein Budget von rund 20.000 Tokens. Wird es überschritten, stuft Antigravity die größten Regeldateien zu Einzeilen-Pfadzeigern herab, die der Agent bei Bedarf liest — die Regel existiert weiter, wird aber nicht mehr voll eingefügt. Verkleinern oder teilen Sie Ihren Always-on-Bestand oder stellen selten genutzte Regeln auf model_decision oder manual um.