Guia de Configuração: Google Antigravity (Agent-First IDE)

Gemini_antigravity

Filosofia e Características

O Antigravity trata a pasta .agent/ como a memória de trabalho e o manual de conduta do assistente. Suas principais características são:

  • Ativação Contextual: O agente utiliza filtros glob para carregar apenas as regras pertinentes ao arquivo em edição, economizando memória e aumentando a precisão.
  • Separação de Preocupações: Divide o conhecimento em Rules (instruções), Context (fatos), Skills (ferramentas) e Workflows (automação).
  • Interconectividade: Permite que arquivos se comuniquem através de referências cruzadas (@), criando um grafo de conhecimento técnico vivo.

Estrutura de Diretórios

Exemplo de diretórios/arquivos para um projeto Django, Python, HTMX e Docker ...

.agent/
├── rules/                # 🛠️ "O MANUAL" (Normas e Padrões)
│   ├── python.md         # Padrões PEP8, tipagem e Pydantic.
│   ├── django.md         # ORM, Views, Mixins e Segurança.
│   ├── htmx.md           # Triggers, targets e fragments HTML.
│   └── docker.md         # Configuração de containers e volumes.
├── context/              # "A ENCICLOPÉDIA" (Fatos e Referências)
│   ├── stack.md          # Versões de software e bibliotecas.
│   ├── architecture.md   # Desenho das apps e fluxo de dados.
│   └── db_schema.md      # Estrutura de tabelas e campos críticos.
├── skills/               #  "AS HABILIDADES" (Execução de Tarefas)
│   └── ui-gen.md         # Ferramenta para gerar componentes UI padrão.
└── workflows/            # "OS WORKFLOWS" (Comandos e Processos)
    └── audit.md          # Automação de revisão via comando "/audit".

Marcações Internas e Metadados

  • Frontmatter (YAML): Define o escopo no topo do arquivo.
  • Menções Cruzadas (@): Conecta arquivos. Exemplo: "Consulte as versões em @/.agent/context/stack.md".
  • Hierarquia Semântica: Use # para domínios e ## para categorias.
  • Exemplos de Código: Utilize blocos de código com comentários "✅ Certo" e "❌ Errado" para guiar o estilo de escrita do agente.
---
name: "Django Views"
glob: "**/views.py"
---

Skills e Workflows (Ação e Automação)


Skills (Habilidades)

Skills são capacidades específicas que o agente "equipa" para realizar ações determinísticas. Elas transformam instruções em ferramentas executáveis, ideais para gerar boilerplates complexos ou realizar refatorações em larga escala seguindo um padrão rígido.

Workflows (Fluxos de Trabalho)

Workflows são scripts interativos baseados em intenção. Eles permitem definir sequências de tarefas executadas via chat através de comandos iniciados por /`.

---
description: "Realiza uma auditoria completa na funcionalidade antes de um commit"
---

# Workflow: Auditoria de Funcionalidade

Ao rodar este workflow (/audit), execute os seguintes passos:

1. **Revisão de Código:** Verifique se o código segue as regras em `@/.agent/rules/python.md` e `@/.agent/rules/django.md`.
2. **Checagem de UI:** Valide os novos elementos HTML contra `@/.agent/rules/htmx.md`.
3. **Validação de Testes:** Verifique se existem testes unitários correspondentes para a nova lógica.
4. **Relatório:** Gere um resumo de conformidade com a `@/.agent/context/stack.md`.
5. Adaptação e Manutenção

Para cada nova tecnologia adicionada ao projeto:

  1. Atualize o Contexto: Adicione a tecnologia e versão em context/stack.md.
  2. Crie a Regra: Adicione um arquivo em rules/ (ex: redis.md) com o glob específico.
  3. Vincule: Use o símbolo @ para que as novas regras conheçam o contexto existente.