Como criar um novo projeto no Antigravity: o passo a passo

Você instalou o Antigravity, abriu, e travou na primeira ação

É o ponto onde mais gente empaca: a ferramenta está lá, mas cadê o botão pra começar de fato? Antes de qualquer coisa vale entender o modelo. No Antigravity o trabalho é organizado por Projeto, e um projeto é formado por uma ou mais pastas locais ou repositórios Git que definem o ambiente e o escopo do agente

Cada projeto guarda configurações e políticas de segurança próprias e isoladas, então o que você faz num projeto não vaza pro outro

A ideia aqui é te dar o caminho de tela completo, da abertura do seletor até o agente rodando o primeiro comando 🙂

O que você precisa antes de começar

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

Pra criar o projeto em si, duas coisas

• Antigravity instalado: ele é multiplataforma e roda em Windows, macOS e Linux, com download em antigravity.google. Se ainda não instalou, resolve isso primeiro
• A pasta ou repositório que vai virar o projeto: já no seu computador. Pode ser uma pasta vazia pra um app do zero ou um repositório Git existente que você quer evoluir

Um aviso antes de você seguir até a parte prática: lá mais pra baixo eu monto o app usando o Antigravity Kit 2.0, que é uma camada extra por cima do Antigravity. Os quatro passos de criação de projeto abaixo NÃO dependem dele. Mas os comandos de barra (/brainstorm, /debug), os workflows e a pasta agent com skills que aparecem no relato sim. Se você for reproduzir o teste na íntegra, vai precisar do Kit instalado também

Se você conhece um gerenciador de dependências tipo NPM ou composer, a lógica de "apontar pra uma pasta e trabalhar dentro dela" vai soar familiar

Passo a passo para criar um novo projeto no Antigravity

São quatro etapas. Vou marcar o erro comum de cada uma, porque é sempre no detalhe bobo que a gente se ferra

1. Abra o seletor de projeto e escolha Novo Projeto: o caminho é Select Project > New Project. É por aqui que tudo começa, e não pela tela de chat direto

O erro comum deste passo: procurar um "criar projeto" solto na interface. A porta de entrada é o seletor de projeto, então é ali que você clica primeiro

2. Associe as pastas com Add Folder: depois de escolher Novo Projeto, clique em Add Folder (Adicionar Pasta) pra apontar a pasta ou o repositório. Dá pra adicionar várias pastas, o que serve pra dar contexto cross-repositório ao agente (útil quando seu app tem front e back em repositórios separados, por exemplo)

O erro comum deste passo: adicionar só uma pasta quando o contexto real está espalhado. Se o agente precisa "enxergar" mais de um repositório pra fazer sentido, some as pastas agora

3. Finalize em Create: com as pastas associadas, clique em Create (Criar) pra fechar a criação do projeto. E se você não configurou nada além disso, relaxa: as configurações do projeto podem ser ajustadas depois

O erro comum deste passo: travar procurando um monte de opção pra preencher antes de criar. Não precisa. Cria primeiro, ajusta o resto quando quiser

4. Dispare o agente pelo chat: projeto criado, agora é digitar o objetivo ou a instrução no campo de chat e pressionar Enter. É esse Enter que coloca o agente pra trabalhar em cima das suas pastas

O erro comum deste passo: escrever um objetivo vago demais. Quanto mais claro o que você quer, melhor o agente entende o escopo do projeto que você acabou de montar

Local Mode ou New Worktree Mode: qual escolher ao iniciar a tarefa

Assim que você inicia uma tarefa, o Antigravity te oferece dois modos de atuação. Vale decidir isso logo depois de criar o projeto, porque muda como o agente mexe nos seus arquivos

A regra prática: se é coisa rápida na sua pasta, Local Mode resolve. Se é uma tarefa grande, ou você vai ter vários agentes trabalhando ao mesmo tempo, o New Worktree Mode isola o serviço num worktree Git próprio e te protege de um agente pisar no trabalho do outro

Pensa no worktree isolado como uma bancada separada: o agente faz a bagunça dele lá, sem misturar com o que já está funcionando nas suas pastas ativas

Testando a criação de projeto na prática

No vídeo abaixo eu monto um projeto do zero usando o Antigravity Kit 2.0, e dá pra sentir bem como o fluxo de criação e disparo do agente funciona na vida real

Quando testei, instalei o Kit rodando um comando no terminal dentro de um projeto do Antigravity, abrindo o terminal pelo botão direito (new terminal). Um detalhe que me travou: pra instalar e disparar os comandos com barra eu precisava estar na visão de editor. Na visão do agent manager os workflows por comando de barra não eram invocados

A instalação baixa os arquivos e coloca tudo numa pasta agent, que guarda os agentes, as skills e os workflows. Se você quer entender melhor essa parte, dá uma olhada em como criar uma skill no Antigravity

Comecei o planejamento com o workflow /brainstorm, junto de um prompt pedindo um app de gerenciamento de tarefas parecido com o Todoist. Aqui vai um aviso que aprendi na marra: o comando de barra precisa ficar isolado, sozinho, senão o workflow não é ativado de verdade

Outra coisa: o kit responde em inglês por padrão. Se você quer português, pede explicitamente. Eu costumo colocar isso pelo menos no fim do primeiro prompt

O brainstorm me fez algumas perguntas iniciais antes de planejar, o tal ‘Socratic Gate’: estilo de design, escopo de autenticação e complexidade das tags. Depois que respondi, o Antigravity gerou o plano do projeto e passou a ativar os agentes sob demanda conforme a tarefa (front-end, back-end, segurança)

Se liga num ponto que quase todo mundo estranha: o primeiro prompt é o que MAIS demora. É ele que cria a estrutura de pastas e instala os pacotes, então prepara pra aceitar bastante comando nessa hora

Não saiu perfeito de primeira. O projeto nasceu sem autenticação funcional e travou na tela de login. Mandei um novo prompt pedindo login e registro funcionais. Aí, ao testar o cadastro, tomei um erro ao registrar usuário. Copiei a mensagem e usei o workflow /debug, que tem um processo de depuração próprio, pra analisar e corrigir. Depois desse ajuste, registro e login passaram a funcionar

Dali segui evoluindo o app com novos prompts: edição de perfil do usuário, estrutura do banco (perfil, tarefas com título, descrição e status) e o CRUD de tarefas, com categorias fixas e tags criadas na hora. Se o seu caso é mobile em vez de web, o caminho é parecido: eu mostro isso em criar app mobile com IA no Antigravity

Projeto criado: qual o próximo passo

Recapitulando o essencial: você abriu o seletor, foi em New Project, associou as pastas com Add Folder e finalizou em Create. Se ficou algo pela metade na configuração, sem estresse, dá pra ajustar as configurações do projeto depois

O próximo passo é o que realmente coloca a máquina pra andar: escrever a primeira instrução clara pro agente no chat e apertar Enter

Quanto mais nítido o objetivo, menos idas e vindas você tem. Bora criar? 🙂