O que faz um prompt para Antigravity funcionar
Prompts para Antigravity funcionam quando transformam uma intenção ampla em uma tarefa observável. “Melhore o app” não cria limite. “Descubra por que o total da fatura é arredondado duas vezes, altere somente o cálculo, adicione um teste de regressão e mostre o diff” define objetivo, escopo e parada. O princípio vale para o desktop, o Antigravity CLI e fluxos com várias ferramentas.
Esta página trata do desenho de prompts e de exemplos reutilizáveis. O guia Antigravity Workflows cobre processos repetíveis, permissões e checkpoints; o guia Antigravity CLI cobre instalação e comandos. Manter essa fronteira evita que um prompt peça mudanças de configuração ou de módulos não relacionados.
Considere cada resposta uma proposta até conferir os arquivos, comandos e evidências citados. Um prompt curto com teste de aceitação visível é mais útil que um texto longo com toda função possível. Regras estáveis devem ficar no repositório ou em configurações revisadas; o prompt atual deve se concentrar na decisão da vez.
O quadro de quatro partes do prompt
Um prompt confiável pode ser escrito em quatro blocos: objetivo, contexto, limites e evidência. Não é preciso mostrar todos os rótulos em uma pergunta simples, mas a estrutura ajuda quando a tarefa envolve código, credenciais, ferramentas externas ou vários arquivos. Ela também mostra qual bloco faltou quando a resposta falha.
O objetivo precisa de verbo e objeto: diagnosticar um parser, adicionar uma rota, comparar APIs, explicar um teste ou revisar código. Contexto informa onde está o trabalho e o que já se sabe. Limites dizem o que não pode mudar, quais comandos são permitidos e se pode escrever arquivos. Evidência é a prova final: teste focado, HTML renderizado ou incerteza declarada.
Mantenha o critério de aceitação realista. “Zero bugs” não é testável em um turno. Um teste nomeado passar, uma resposta mudar de 404 para 200 ou uma linha aparecer na tabela são verificáveis. Se o agente não puder executar um comando, peça que diga isso e entregue o comando exato para a revisão humana.
Objetivo
Comece pelo resultado mínimo útil: identificar, planejar, alterar, explicar, testar ou revisar.
Contexto
Nomeie pasta, arquivos, framework, erro, comportamento esperado e referência confiável.
Limites
Defina caminhos editáveis, ações proibidas, dependências, segurança e condição de parada.
Evidência
Especifique comando, diff, captura, saída ou pergunta aberta que prove o resultado.
Prompts para planejar e entender um projeto
Use prompts de planejamento antes de uma mudança grande ou em um repositório desconhecido. Peça ao agente que examine a árvore real e cite os arquivos usados. Um bom plano é um mapa, não uma reescrita especulativa: indica os menores arquivos, os riscos e o teste que confirmará a escolha.
Peça que as incógnitas sejam listadas. Se houver mais de um comando de build, caminho de autenticação ou fonte de tradução, o agente deve mostrar as alternativas e dizer qual verificou. Isso evita que um README presumido ou um framework adivinhado oriente todas as mudanças seguintes.
Revise o plano e inicie outro prompt para executar somente a parte aprovada. Separar inspeção de escrita cria um checkpoint e facilita rejeitar aumento de escopo.
01. Mapear o repositório
Inspecione este repositório sem editar arquivos. Identifique framework, entrada, build, testes, configuração e os três arquivos que controlam [comportamento]. Cite cada caminho e o que não pôde verificar.Por que ajuda: Fatos e caminhos vêm antes da implementação.
02. Transformar pedido em plano
Crie um plano de cinco passos para [objetivo]. Limite mudanças a [caminhos permitidos]. Para cada passo, indique saída e teste. Aponte suposições, dependências e reversão. Não escreva arquivos.Por que ajuda: A sequência fica revisável e limitada.
03. Encontrar o responsável
Trace como [entrada ou rota] vira [saída]. Comece no ponto público, siga função ou template até a fonte de verdade e retorne um grafo curto com o arquivo dono do ajuste.Por que ajuda: O patch fica no módulo responsável.
15 modelos práticos de prompts para Antigravity
Estes prompts para Antigravity são curtos de propósito. Troque os valores entre colchetes, remova passos desnecessários e acrescente um comando ou saída esperada. Eles cobrem entender o projeto, implementar, depurar, testar, revisar e documentar.
Mapa do repositório
Inspecione a árvore e resuma runtime, entrada, build, testes e deploy.
Antes de tocar em código desconhecido.Separar requisitos
Reescreva este pedido como obrigatório, fora do escopo, dúvidas e critérios: [pedido].
Quando o ticket mistura objetivos.Design mínimo
Proponha o menor design para [objetivo]. Compare duas opções e custos antes de escolher.
Antes de criar abstração.Implementação focada
Implemente [comportamento] em [caminhos]. Preserve APIs e estilo. Mostre arquivos e pare após o teste focado.
Para um patch limitado.Refatoração segura
Encontre duplicação em [módulo]. Sugira refatoração, liste o que deve permanecer igual e só mude após aprovação.
Quando a limpeza pode alterar comportamento.Reproduzir erro
Reproduza [erro] com a menor entrada. Registre comando, saída e primeiro valor incorreto antes de corrigir.
Quando falta reprodução confiável.Depurar regressão
Compare o caminho que falha com o último comportamento correto. Teste uma causa e traga evidência.
Para depurar trabalho do Antigravity.Teste de regressão
Adicione teste para [bug]. Ele deve falhar antes do ajuste e passar depois, sem fixtures alheios.
Para manter a correção.Triagem de testes
Rode o teste mais estreito para [mudança]. Separe falha do produto, teste, ambiente e dependência.
Quando um teste vermelho tem várias causas.Revisão de código
Revise este diff por correção, segurança, compatibilidade e testes ausentes. Ordene achados com caminhos e linhas.
Antes de aceitar código gerado.Checklist de migração
Planeje migrar de [antigo] para [novo]. Inclua dados, compatibilidade, rollback e consulta de verificação.
Para mudanças com estado.Atualizar documentação
Leia a implementação e atualize apenas documentação incorreta. Cite a mudança e mantenha exemplos executáveis.
Depois de mudar comportamento.Sonda de desempenho
Meça [operação] com amostra repetível. Identifique baseline, gargalo e uma melhoria de baixo risco.
Antes de otimizar.Revisão de release
Confira versão, changelog, build, testes, links e rollback. Liste bloqueios e evidências.
Antes de publicar.Explicar resultado
Explique o que mudou, por quê, como foi verificado e o que permanece incerto em cinco pontos com caminhos.
Para uma entrega auditável.Exemplos de prompts para codificar e depurar
Um prompt de código deve proteger o comportamento atual antes de pedir o novo. Informe arquivos que podem mudar, API ou marcação que deve continuar estável e o teste do caminho. Se surgir outro problema, peça para registrá-lo como acompanhamento, sem corrigi-lo silenciosamente no mesmo patch.
Para depuração, exija reprodução antes de teoria. Inclua entrada, comando, resposta, saída esperada e ambiente. Depois peça uma hipótese e uma checagem estreita. Assim uma lista de correções especulativas não vira um patch sem relação.
Quando o prompt precisar de código, mantenha o bloco pequeno e indique onde ele entra. Peça diff, resultado do teste e arquivos considerados mas não alterados, para que o escopo fique documentado.
04. Implementar com parada
Em [arquivo], adicione [comportamento]. Preserve assinatura e mensagens de erro. Crie o teste focado, rode [comando], mostre o diff e pare antes do commit.Por que ajuda: Impede que um patch vire refatoração não solicitada.
05. Depurar com evidência
Reproduza esta falha: [comando/entrada e saída]. Inspecione o código, formule hipótese e rode uma checagem que possa refutá-la. Só então proponha patch e teste.Por que ajuda: Deixa o raciocínio falsificável.
06. Revisar código gerado
Revise o diff como mantenedor. Confira casos extremos, segurança, acessibilidade, localização e testes. Retorne achados primeiro e não edite.Por que ajuda: Cria revisão independente antes da aceitação.
07. Corrigir tentativa falha
A tentativa anterior falhou com [erro]. Leia arquivos atuais e saída. Preserve mudanças úteis, faça o menor reparo, rode [checagem] e relate incertezas.Por que ajuda: Evita repetir patch obsoleto.
Prompts de CLI, arquivos, mídia e subagentes
Prompts do Antigravity CLI têm uma questão extra: a sessão pode conter texto em várias linhas, referências de arquivo ou mídia colada. Use a documentação oficial para teclas e envio atuais. No prompt, diga se o arquivo é contexto de leitura, alvo editável ou exemplo que não deve ser copiado.
Uma referência de arquivo não autoriza varrer o computador. Informe a menor pasta ou arquivo necessário. Para imagem ou log, explique o que deve ser provado e o que deve ser ignorado. Nunca cole segredos, cookies, chaves privadas ou dados de produção.
Subagentes são úteis para verificações independentes. Dê uma pergunta a cada um, exija relatório curto com evidências e deixe a tarefa principal resolver contradições. Não una mudanças opostas automaticamente.

Verificação, permissões e limites do prompt
Um prompt termina quando uma pessoa pode decidir se o resultado é aceitável. Peça o teste exato, sua saída e o ambiente. Um teste verde ainda pode ignorar link quebrado, idioma errado ou permissão perigosa; associe a evidência ao risco.
Mantenha permissões estreitas enquanto aprende o fluxo. Explicar um comando shell não autoriza executá-lo nem ler fora do workspace. Exija aprovação para escrita, rede, credenciais, migrações e releases. Se faltar acesso, o agente deve parar e apontar a evidência pendente.
Prompts longos também têm limites. Logs repetidos e documentação copiada escondem o critério. Resuma regras estáveis em arquivo revisado, use fonte confiável e concentre o prompt na decisão. Quando falhar, reescreva o bloco que faltou em vez de adicionar prosa.
- Verifique a camada certa. Combine teste unitário com rota, HTML, permissão ou saída visível quando a mudança cruzar camadas.
- Deixe escrita explícita. Nomeie caminhos permitidos e exija diff; o prompt não é aprovação global do repositório.
- Proteja dados privados. Redija segredos e dados pessoais em prompts, logs, capturas e artefatos.
- Pare sem evidência. Peça que o agente liste o que não conseguiu inspecionar em vez de supor.
- Registre a recuperação. Guarde erro, tentativa e nova checagem para começar a próxima execução com fatos.

FAQ sobre prompts para Antigravity
Quais são os melhores prompts para Antigravity?
O melhor prompt informa resultado, contexto, limites e evidência. Comece pelos modelos de mapa, implementação, depuração, teste e revisão desta página.
Como começo um prompt de código?
Informe objetivo, repositório ou arquivo, comportamento atual e esperado, limites e teste. Peça plano antes de escrever quando o código ou risco forem desconhecidos.
Como escrever prompts para depurar Antigravity?
Inclua reprodução mínima, saída observada e esperada e ambiente. Peça hipótese e checagem antes do patch.
Um prompt pode editar vários arquivos?
Pode, se listar caminhos permitidos e motivo. Peça diff por arquivo e guarde qualquer expansão como acompanhamento.
O que incluir em prompts do Antigravity CLI?
Siga a referência oficial para texto multilinha, arquivos e mídia. Diga o que é contexto e o que pode ser editado, sem incluir segredos.
Por que meu prompt gerou resposta vaga?
Geralmente faltou objetivo, contexto ou critério. Reescreva com saída concreta, caminhos ou erro e relatório curto de evidência.
Devo repetir instruções permanentes?
Mantenha regras estáveis em documentação ou configurações revisadas e repita apenas o limite útil para a tarefa atual.
Estes modelos são oficiais?
Não. São exemplos editoriais. A documentação oficial do Antigravity é a fonte para comportamento, controles do CLI e integrações.
Fontes consultadas
- Documentação oficial de prompting do Antigravity CLI — Referência para caixa de prompt, texto multilinha, arquivos, subagentes e mídia.
- Guia do Antigravity CLI — Instalação, comandos, configurações e solução de problemas no terminal.
- Antigravity Workflows — Processos repetíveis, checkpoints, permissões e resultados verificados.
- Repositório comunitário de prompts — Consultado para fases e artefatos; não é tratado como fonte oficial.