Workflows do Antigravity: tarefas repetíveis

O que são os workflows do Antigravity

Workflows do Antigravity são maneiras repetíveis de sair de uma meta de desenvolvimento e chegar a um resultado conferido. Um workflow pode usar o editor, terminal, controle do navegador, um Skill, um servidor MCP ou várias superfícies juntas. Ele é mais do que um prompt: inclui o estado inicial, as ações permitidas, as pausas e as evidências que provam a conclusão.

Os melhores workflows do Antigravity são estreitos o bastante para serem testados. “Melhore este projeto” não tem linha de chegada. “Leia o teste que falhou, altere apenas o analisador, execute o teste focado, mostre o diff e pare antes do commit” tem uma saída clara e um limite seguro. Use os guias de CLI, Skills e MCP para detalhes de cada superfície.

Prepare o espaço de trabalho antes de executar um workflow

Abra o repositório, confirme a branch e confira os arquivos envolvidos. Execute uma vez o comando necessário para conhecer nome, código de saída e ambiente. Em navegador ou MCP, comece com uma leitura.

Descreva entrada e saída com clareza: alvo, ferramentas, limites e decisão humana. Mantenha senhas, tokens e dados privados fora dos prompts e logs. Use uma branch de teste na primeira execução.

1. 1. Congele o estado inicialRegistre repositório, branch, versão e arquivos ou contas que o workflow pode tocar.
2. 2. Defina uma saídaEscolha um artefato, resultado de teste, estado de página ou relatório para tornar a falha visível.
3. 3. Ensaie em modo somente leituraInspecione e explique o caminho antes de editar arquivos, enviar dados ou mudar uma conta.
4. 4. Inclua um ponto de revisãoPare antes de instalar dependências, escrever na rede, publicar, apagar ou fazer deploy.

Este guia não afirma um formato fixo de arquivo nem flags permanentes. Confira a documentação oficial antes de automatizar uma nova integração.

Prompts e comandos úteis para workflows do Antigravity

Um prompt informa papel, contexto, ações permitidas e evidência. Exemplo: “Inspecione X, planeje a menor mudança, edite apenas Y, execute Z, mostre o resultado e pare antes de W”. Peça o comando ou ferramenta exata.

Separe comandos interativos e de shell. Ajuda da CLI, sessão, teste de terminal e chamada MCP têm escopos distintos. Nomeie a superfície para permitir repetição.

Escopo, permissões e configurações do workflow

A segurança depende principalmente do escopo. Mantenha comandos perto do repositório, preferências separadas e permissões explícitas. Ler não é escrever; testar não é instalar; conferir uma página não altera uma conta.

Um Skill testado deve incluir pré-requisitos, entradas, saídas, falhas e verificação. Não esconda um comando amplo ou escrita de rede atrás de um nome amigável.

workflow:
  objetivo: "atualizar um analisador e provar o teste focado"
  permitido: [read_files, edit_target, run_focused_test]
  revisar_antes: [install_package, network_write, delete, publish]
  saida: [diff_summary, test_result, remaining_risks]

• Escopo do projeto — Use instruções do repositório para que comandos e limites de arquivo sejam reproduzíveis.
• Escopo do usuário — Mantenha preferências pessoais de modelo, terminal e tela fora do comportamento compartilhado.
• Escopo da ferramenta — Nomeie servidor MCP, domínio do navegador ou comando exato em vez de usar curinga.
• Escopo da revisão — Liste ações que sempre precisam de uma pessoa, mesmo após etapas automáticas.

Um workflow do Antigravity repetível em cinco passagens

A primeira passagem descobre: leia arquivos ou testes e repita o objetivo. A segunda planeja a menor mudança e nomeia ferramentas. Pare se o plano não entender o pedido.

A terceira executa; a quarta compara uma checagem focada com a regra de aceitação; a quinta relata caminhos, provas, riscos e a próxima decisão. Serve para conteúdo, CLI, navegador e MCP.

Mantenha os workflows atualizados quando o Antigravity mudar

Produtos de agentes evoluem. Um comando, permissão, modelo ou saída de integração pode mudar depois de uma atualização. Revise um workflow após mudanças no Antigravity, no modelo, no shell ou em um servidor MCP; uma execução bem-sucedida no mês passado não prova que é segura hoje.

Registre a data, o build ou a página de documentação consultada e o passo verificado. Se o comportamento atual não puder ser confirmado, mantenha o workflow somente leitura ou manual até resolver a dúvida.

Regras de segurança para workflows do Antigravity

Trate um workflow como um documento de permissões. Antes de compartilhar, revise arquivos legíveis, comandos, domínios externos e possíveis efeitos colaterais.

Confira argumentos, diretório, rede, scripts, variáveis e caminhos de exclusão ou publicação. Mantenha segredos fora de prompts, use uma conta de teste e revogue permissões depois.

• Deixe senhas, chaves de API, códigos de recuperação e dados de clientes fora do texto e das evidências.
• Revise manualmente instalações, uploads, webhooks e mensagens externas.
• Use um perfil de navegador ou conta de teste em fluxos autenticados.
• Mantenha operações destrutivas de arquivos e Git fora do caminho automático.
• Compartilhe pré-requisitos e plano de reversão com quem executará o workflow.

Solucione um workflow que falha

Reduza a falha à menor passagem. Compare estado inicial, chamada, saída e regra de aceitação antes de mudar permissões.

O agente faz um plano diferente

Repita arquivo-alvo, saída e condição de parada. Peça primeiro só o plano e corrija o limite.

O comando não é encontrado

Execute em um terminal normal, verifique PATH e política do shell e registre a versão instalada.

A ferramenta retorna dados parciais

Salve a resposta, marque campos ausentes e pare. Tente novamente apenas quando o erro transitório estiver claro.

O resultado parece certo, mas está errado

Compare URL, caminho, teste ou estado final com a regra de aceitação. Saída antiga ou parcial é falha.

As permissões continuam aparecendo

Veja se comando, caminho, conta ou ferramenta mudou. Estreite a regra em vez de liberar um curinga.