Delegado Antigravidade

Quando Usar

• Você quer delegar uma tarefa de codificação limitada a um agy implementador separado (Google Antigravity) e depois revisar o diff dele.
• O usuário pediu explicitamente a delegação para este implementador.

Você é o orquestrador. Essa habilidade permite que você entregue uma tarefa de codificação limitada a um implementador separado - o Google Antigravity CLI (agy) - depois revise o que ele produziu e finalize a alteração você mesmo. Você escreve o resumo e é responsável pelo julgamento; Antigravity faz a digitação em sua própria conversa; você verifica e confirma.

Nada aqui é específico para um agente orquestrador. O loop precisa apenas da capacidade de executar um comando shell e ler um arquivo, então qualquer agente comparável pode controlá-lo. Ele é projetado para e executado no Claude Code; trate outros orquestradores como projetados para isso, ainda não comprovados.

Quando NÃO usar isso

• A tarefa é pequena o suficiente para ser feita inline - a sobrecarga da delegação não vale a pena.
• O CLI agy não está instalado ou não está autenticado. Instale-o a partir da documentação do CLI do Antigravity e execute a configuração de primeira inicialização.
• Você quer escrever o código você mesmo, ou você só precisa da opinião do Antigravity sobre o código que você escreveu (um dispatch --read-only cobre a revisão sem edições, mas uma revisão simples pode não precisar de delegação alguma).

Pré-requisitos (verificar uma vez)

1. agy help é bem-sucedido. Se não, instale o Antigravity CLI e complete a configuração de primeira inicialização.
2. agy models é bem-sucedido. Isso prova que o CLI pode autenticar e listar os rótulos de modelo disponíveis.
3. Você está no (ou apontará --cd para) o repositório git de destino.

Essas verificações não provam que uma escrita sem supervisão será aprovada. No modo --print, o Antigravity não pode solicitar permissão de escrita e pode negá-la automaticamente. O relé detecta essa negação em vez de relatar a conclusão.

Escolha o modelo implementador

agy tem um modelo padrão configurado, então --model é opcional. Use-o quando o humano tiver um rótulo de modelo Antigravity preferido para a tarefa. Caso contrário, deixe o Antigravity usar seu próprio padrão atual em vez de adivinhar.

O loop

Execute estas cinco etapas por tarefa. As etapas 1, 4 e 5 são seu julgamento; 2 e 3 são mecânicas.

1. Escreva o resumo

O Antigravity vê apenas o texto que você envia, mais o que ele pode inspecionar no espaço de trabalho - sem histórico de chat, sem contexto compartilhado. Tudo o que a tarefa precisa vai no resumo: o objetivo, o estado atual, o que mudar, o que deixar intocado, os comandos de gate atuais do projeto e um contrato de relatório. Diga ao Antigravity que ele não fará o commit (você fará). Mantenha uma tarefa por resumo. Orientação completa e um modelo: references/writing-the-brief.md.

2. Dispatch

Envie o resumo para o Antigravity com o helper empacotado. Ele envolve agy --print, captura a execução e escreve um result.json estruturado - então seu único trabalho é "executar um comando, ler um arquivo". (<skill-dir> abaixo é o diretório instalado desta habilidade - a pasta contendo este SKILL.md.)

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# choose a model label:                 add --model "<label from agy models>"
# reasoning effort (low, medium, high): add --effort high
# read-only (plan mode — no edits):     add --read-only
# enable Antigravity terminal sandbox:  add --sandbox
# resume the most recent conversation:  add --resume-last  (delta brief only)
# see all options:                      node .../relay.mjs --help

O helper inicia um novo projeto Antigravity por padrão e passa --add-dir <repo> (o caminho --cd, absoluto) para que agy tenha um espaço de trabalho explícito. Ele não passa --dangerously-skip-permissions por padrão. Mecânicas, flags e o formato result.json: references/dispatch-and-poll.md.

3. Aguarde a conclusão

O helper bloqueia até que o Antigravity termine, então o apoie com o que seu orquestrador oferece e retome quando ele retornar:

• Claude Code: execute a chamada Bash com run_in_background: true; você é notificado na conclusão.
• Shell simples / outros agentes: execute-o em primeiro plano para tarefas curtas, ou coloque-o em segundo plano e consulte o arquivo de resultado.

Não confie em rastreadores de progresso em vez da realidade: uma execução está concluída quando result.json é escrito e o processo foi encerrado. Leia a árvore de trabalho, não uma linha de status. O relatório completo do implementador é o campo finalMessage em result.json (também impresso por completo no stdout entre os marcadores de relatório).

4. Revisão - não confie no auto-relato

…