Google Antigravity
How rules and workflows work in Google Antigravity. Global rules, workspace rules, activation modes, @ mentions, workflows, slash commands, and agent-generated workflows.
For the official documentation, see Antigravity Customizations.
Rules
Rules are Markdown files that guide the agent to follow specific conventions for your use cases, stack, and style. They operate at both global and workspace levels.
Rule files are limited to 12,000 characters each. For complex guidelines, split the content across multiple rule files.
Getting Started
Open Customizations
Open the Customizations panel from the "..." dropdown at the top of the agent panel.
Navigate to Rules
Click the Rules panel.
Create a rule
Click + Global for global rules or + Workspace for workspace-specific rules.
Rule Scopes
Global rules are stored at ~/.gemini/GEMINI.md and apply across all workspaces. Use these for personal coding standards, language preferences, or conventions you want the agent to follow consistently.
Activation Modes
Activated with an @ mention in the agent's input box. The rule is applied only when you specifically reference it.
@ Mentions in Rules
You can reference other files using @filename in a rules file. Path resolution works as follows:
- Relative paths — resolved relative to the location of the rules file
- Absolute paths — resolved as true absolute paths first, then relative to the repository root
For example, @/path/to/file.md will first try to resolve to /path/to/file.md. If that file does not exist, it will resolve to workspace/path/to/file.md.
Workflows
Workflows let you set up a series of steps to assist the agent with repetitive tasks, such as deploying a service, responding to PR comments, or running a test suite. Workflows are saved as Markdown files and can be initiated using slash commands with the format /workflow-name.
While rules provide consistent, reusable context at the prompt level, workflows offer a structured series of steps at the trajectory level, guiding the model through related tasks.
Creating a Workflow
Open Customizations
Open the Customizations panel from the "..." dropdown at the top of the agent panel.
Navigate to Workflows
Click the Workflows panel.
Create a workflow
Click + Global for a global workflow available across all workspaces or + Workspace for a workspace-specific workflow.
Running Workflows
Invoke a workflow in the agent using /workflow-name. The agent processes each step in order, performing actions or generating responses as specified.
Workflows can also call other workflows. For example, /workflow-1 can include instructions like "Call /workflow-2" and "Call /workflow-3".
Agent-Generated Workflows
You can ask the agent to create workflows for you. This works especially well after you manually work through a series of steps. The agent can use the conversation history to create the workflow automatically.
Rules vs Workflows
| Feature | Rules | Workflows |
|---|---|---|
| Purpose | Persistent guidelines and limits | Step-by-step task automation |
| Scope | Prompt-level context | Trajectory-level sequencing |
| Triggered by | Automatic or manual activation | /slash-command invocation |
| Best for | Coding standards, conventions, patterns | Deployment, testing, repetitive tasks |
Tips for Antigravity
Selling Antigravity Rules on Skly
- List "Antigravity" as a supported AI tool so buyers can find compatible rules.
- Use plain Markdown — Antigravity rules are standard
.mdfiles. - Specify the activation mode — let buyers know if the rule is meant for Always On, Model Decision, or Glob activation.
- Stay under 12,000 characters to respect the platform's file size limit.
- Test with Antigravity's agent to confirm the rule works as expected in the agent panel.