Projeto 3: Agentic com Antigravity

Guia Passo a Passo

Clique em cada tópico para expandir e ver os detalhes.

O Antigravity é um ambiente de desenvolvimento integrado (IDE) criado pelo Google com uma premissa radicalmente diferente dos editores tradicionais: o agente de IA é o operador principal, e o desenvolvedor humano é o supervisor.

Enquanto ferramentas como Cursor e GitHub Copilot adicionam IA como um assistente ao fluxo humano tradicional, o Antigravity inverte essa lógica. O agente planeja, executa, testa e verifica — o humano aprova ou redireciona.

Cursor / VSCode + Copilot

• Humano como operador
• IA como autocompletar
• Sugestões linha por linha
• Contexto limitado

Claude Code / Codex CLI

• Agente no terminal
• Contexto de repositório
• Execução de comandos
• Sem IDE integrado

Antigravity

• Agente como operador
• IDE + terminal + browser
• Plano → Executar → Verificar
• Google Cloud nativo

O Antigravity unifica editor, terminal, browser e ferramentas externas num único ambiente, com o agente Gemini orquestrando todas as partes via MCP (Model Context Protocol).

O ponto de entrada para qualquer projeto no Antigravity é o arquivo workspace.json. Ele define o modelo, as ferramentas disponíveis, os workflows e as permissões.

Estrutura básica do workspace.json

{
  "name": "meu-projeto",
  "agent": {
    "model": "gemini-2.0-flash-exp",
    "context_files": ["CONTEXT.md"],
    "auto_approve": false
  },
  "permissions": {
    "file_write": "ask",
    "shell_execute": "ask"
  }
}

Veja o tópico 2 para a configuração completa e detalhada de instalação.

O Antigravity é instalado como uma aplicação nativa para macOS, Windows e Linux. Diferente de plugins de editor, ele é um ambiente completo e autocontido que vem com servidor MCP integrado, runtime para ferramentas e sandbox de terminal.

Requisitos de sistema

• macOS 13+, Windows 11, Ubuntu 22.04+
• Node.js 20 LTS (gerenciado pelo instalador)
• 8GB RAM mínimo (16GB recomendado)
• Conta Google (obrigatória para autenticação)
• Conexão com internet (modelo em nuvem)

O que vem incluído

• Editor de código com syntax highlighting
• Terminal integrado com sandbox
• Browser embutido (Chromium)
• Servidor MCP local
• Painel de aprovação de ações

Baixar e instalar

Terminal

# macOS via Homebrew
brew install --cask antigravity

# Linux (Debian/Ubuntu)
curl -fsSL https://antigravity.dev/install.sh | sh

# Verificar instalação
antigravity --version

Autenticar com Google Account

# Autenticação interativa
antigravity auth login

# Verificar autenticação
antigravity auth status

Inicializar projeto

# Criar workspace.json no projeto
cd meu-projeto
antigravity init

# Abrir no Antigravity
antigravity open .

O CONTEXT.md é o arquivo de memória persistente do agente Gemini no Antigravity. Equivalente ao CLAUDE.md do Claude Code, ele é carregado automaticamente no início de cada sessão e fornece ao agente o contexto necessário para tomar decisões corretas.

CLAUDE.md (Claude Code)

• Carregado pelo Claude automaticamente
• Foco em comandos e convenções
• Markdown simples
• Sem suporte a seção de workflows

CONTEXT.md (Antigravity)

• Suporte a seção de Workflows
• Referenciado no workspace.json
• Múltiplos arquivos de contexto
• Seção de domínio e glossário

Você pode ter múltiplos arquivos de contexto (ex: CONTEXT.md e ARCHITECTURE.md), todos listados em context_files no workspace.json.

O Model Context Protocol (MCP) é o padrão aberto que permite ao agente se comunicar com ferramentas externas de forma padronizada. No Antigravity, o MCP é o mecanismo principal de extensibilidade — tudo que o agente pode fazer além de editar texto é feito via servidores MCP.

Servidores MCP disponíveis

📁

filesystem

Leitura e escrita de arquivos

⬡

github

PRs, issues, branches

🔵

google-workspace

Drive, Calendar, Gmail

🔥

firebase

Firestore, Auth, Hosting

⬛

postgres

Queries e migrações

🌐

browser

Automação web (Playwright)

Servidores MCP são configurados na seção tools.mcp_servers do workspace.json:

workspace.json — seção mcp_servers

"mcp_servers": [
  {
    "name": "filesystem",
    "command": "npx @modelcontextprotocol/server-filesystem",
    "args": ["--root", "."]
  },
  {
    "name": "github",
    "command": "npx @modelcontextprotocol/server-github",
    "env": {
      "GITHUB_TOKEN": "${GITHUB_TOKEN}"
    }
  },
  {
    "name": "google-workspace",
    "command": "npx @google/mcp-server-workspace",
    "auth": "google-oauth"
  }
]

Variáveis de ambiente nos servidores MCP

Use a sintaxe "${NOME_DA_VAR}" para referenciar variáveis de ambiente do sistema no workspace.json. Nunca hardcode tokens ou secrets diretamente no arquivo.

Os Workflows são sequências de passos pré-definidos que o agente executa ao receber um determinado tipo de tarefa. O Antigravity implementa o padrão Plan → Execute → Verify como loop fundamental de desenvolvimento.

Loop fundamental do Antigravity

PLAN

Analisa e descreve

→

EXECUTE

Implementa

→

VERIFY

Testa e confirma

→

APPROVE

Humano revisa

Workflow: feature

1plan — mapear mudanças

2implement — escrever código

3test — criar e rodar testes

4review — aguardar aprovação

Workflow: bugfix

1analyze — reproduzir bug

2fix — implementar correção

3verify — confirmar solução

Workflows são definidos no workspace.json e ativados por comandos no chat do agente:

workspace.json — seção workflows

"workflows": {
  "feature": {
    "steps": ["plan", "implement", "test", "review"]
  },
  "bugfix": {
    "steps": ["analyze", "fix", "verify"]
  }
}

Chat com o agente — exemplos de trigger

# Ativar workflow de feature
@agent implement feature: autenticação com Google OAuth

# Ativar workflow de bugfix
@agent fix bug: usuários não conseguem fazer logout no Safari

# Ativar workflow de deploy
@agent deploy to staging

Por ser um produto do Google, o Antigravity tem integração nativa com todo o ecossistema Google Cloud. O agente pode interagir com serviços GCP usando as credenciais da sua Google Account sem configuração adicional.

Firebase

• Firestore: queries e escritas via MCP
• Authentication: gerenciar usuários
• Hosting: deploy automático do frontend
• Functions: deploy de cloud functions
• Storage: upload e download de arquivos

Google Cloud Platform

• Cloud Run: deploy de containers
• Vertex AI: modelos de ML e embeddings
• Cloud SQL: banco de dados gerenciado
• Secret Manager: gerenciar credenciais
• Cloud Build: CI/CD pipelines

Vertex AI

• Acesso a Gemini 1.5 Pro e Flash
• Embeddings para search semântica
• Fine-tuning de modelos customizados
• AI Pipelines para batch processing

Google Workspace

• Sheets: ler e escrever planilhas
• Docs: gerar documentação
• Drive: gerenciar arquivos
• Calendar: sincronizar eventos

A integração nativa elimina a fricção entre desenvolvimento e deploy. Ao invés de sair do IDE para acessar o console do Firebase ou o Cloud Run, o agente faz isso diretamente do Antigravity enquanto você observa.

Cenário real: feature completa em um único prompt

@agent implement feature: sistema de notificações por email
quando uma task é atribuída a um usuário

O agente vai:

Criar a Cloud Function de envio de email
Configurar o trigger no Firestore
Integrar com Gmail API via Workspace MCP
Escrever testes unitários
Fazer deploy no Firebase Functions
Verificar os logs de execução

A integração com GCP requer apenas estar autenticado com uma Google Account que tenha as permissões corretas:

Autenticar no GCP via Antigravity

# No painel lateral do Antigravity
Google Cloud > Sign in with Google

# Ou via configuração de projeto
Settings > Integrations > Google Cloud > Connect

Selecionar projeto GCP

# workspace.json — adicionar config do GCP
"gcp": {
  "project_id": "meu-projeto-123456",
  "region": "us-central1"
}

Habilitar APIs necessárias

# O agente pode habilitar as APIs automaticamente
@agent enable required GCP APIs for this project

# Ou manualmente via gcloud (no terminal integrado)
gcloud services enable run.googleapis.com
gcloud services enable firebase.googleapis.com
gcloud services enable aiplatform.googleapis.com

workspace.json — Referência completa

Arquivo de configuração do Antigravity com comentários explicando cada campo.

workspace.json

Antigravity Config

{
  // Nome do projeto — aparece no painel do Antigravity
  "name": "meu-projeto-agentic",
  "version": "1.0.0",

  // Configurações do agente Gemini
  "agent": {
    // Modelo a ser usado — gemini-2.0-flash-exp é mais rápido e barato
    "model": "gemini-2.0-flash-exp",

    // temperature 0.2 = respostas mais determinísticas para código
    "temperature": 0.2,

    // Arquivos carregados como contexto no início de cada sessão
    "context_files": ["CONTEXT.md", "ARCHITECTURE.md"],

    // false = agente sempre pede aprovação antes de agir
    "auto_approve": false,

    // Número máximo de passos por tarefa antes de parar e pedir orientação
    "max_iterations": 20
  },

  // Ferramentas disponíveis para o agente
  "tools": {
    "mcp_servers": [
      {
        "name": "filesystem",
        // npx baixa e executa o servidor MCP automaticamente
        "command": "npx @modelcontextprotocol/server-filesystem",
        // --root . limita acesso apenas ao diretório do projeto
        "args": ["--root", "."]
      },
      {
        "name": "github",
        "command": "npx @modelcontextprotocol/server-github",
        // ${GITHUB_TOKEN} lê da variável de ambiente do sistema
        "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
      }
    ],
    // Browser embutido (Chromium) para verificar resultado visual
    "browser": { "enabled": true, "headless": false },
    // Terminal com sandbox = isolado do sistema host
    "terminal": { "enabled": true, "sandbox": true }
  },

  // Workflows pré-definidos com seus passos
  "workflows": {
    "feature": {
      "steps": ["plan", "implement", "test", "review"]
    },
    "bugfix": {
      "steps": ["analyze", "fix", "verify"]
    }
  },

  // Permissões: "ask" = pede aprovação, "allow" = automático, "deny" = bloqueado
  "permissions": {
    "file_write": "ask",
    "network": "ask",
    "shell_execute": "ask"
  }
}

CONTEXT.md — Estrutura de exemplo

Seções essenciais que todo CONTEXT.md deve ter para um agente eficiente.

CONTEXT.md

Markdown

# CONTEXT.md — Antigravity / Gemini Agent Context

> Este arquivo é carregado automaticamente pelo Antigravity como contexto persistente.

---

## Stack Tecnológica

- **Frontend:** React 18 + TypeScript + Tailwind CSS
- **Backend:** Node.js 20 + Fastify + Prisma
- **Cloud:** Google Cloud (Cloud Run + Firebase + Cloud SQL)

## Convenções de Código

- Arquivos de componentes: PascalCase (UserProfile.tsx)
- Commits: Conventional Commits em inglês
- Nunca usar \`any\` no TypeScript — usar \`unknown\`

## Restrições Obrigatórias

### O agente NUNCA deve:
- Commitar diretamente para \`main\`
- Armazenar ou logar credenciais
- Fazer deploy sem aprovação explícita

## Glossário de Domínio

- **Task:** Unidade de trabalho dentro de um Sprint
- **Sprint:** Período de 2 semanas de desenvolvimento
- **Archived:** Task concluída e removida da listagem ativa