Grok Delegate

Quando Usar

• Você quer delegar uma tarefa de codificação delimitada para um grok implementador separado (Grok Build) e, em seguida, revisar o diff gerado por conta própria.
• O usuário solicitou explicitamente a delegação para este implementador.

Você é o orquestrador. Esta habilidade permite que você entregue uma tarefa de codificação delimitada a um implementador separado — o Grok Build CLI (grok) — depois, revise o que ele produziu e finalize a implementação você mesmo. Você escreve o briefing e assume o julgamento; Grok faz a digitação sob um perfil de autonomia explícito; 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 funciona da mesma forma, seja você Claude Code, Cursor, OpenCode com um modelo selecionado, ou qualquer agente comparável. (Ele é projetado para Claude Code e Cursor; trate outros orquestradores como projetados para, mas ainda não comprovados.)

Quando NÃO Usar

• A tarefa é pequena o suficiente para ser feita inline — a sobrecarga da delegação não vale a pena.
• O CLI grok não está instalado, não está autenticado, ou a conta não tem acesso beta ao Grok Build.
• Você quer escrever o código você mesmo, ou você só precisa de uma revisão sem a execução do implementador.

Pré-requisitos (verificar uma vez)

1. grok version é bem-sucedido. Se não, instale em qualquer plataforma com npm i -g @xai-official/grok (ou use o instalador da documentação oficial do Grok CLI da xAI) e autentique (grok login, ou grok login --device-auth em hosts sem interface gráfica, ou defina XAI_API_KEY).
2. Confirme qual grok está no PATH. command -v grok mostra o binário ativo e grok version sua versão — o relay registra a versão que executou em result.json, então um binário desatualizado fica visível após o fato.
3. Você está no (ou apontará --cd para) o repositório git de destino.

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 briefing

Grok vê apenas o texto que você envia — sem histórico de chat do orquestrador, sem contexto compartilhado. Tudo o que a tarefa precisa vai no briefing: o objetivo, o estado atual, o que mudar, o que não tocar, os comandos de gate reais do projeto (descubra-os no CLAUDE.md/AGENTS.md/Makefile do repositório — não presuma), e um contrato de relatório. Diga ao Grok que ele não fará commit (você fará). Mantenha uma tarefa por briefing. Orientação completa e um modelo: references/writing-the-brief.md.

2. Despacho

Envie o briefing para o Grok com o helper empacotado. Ele envolve grok -p, 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, ou seja, o diretório de onde você carregou a habilidade. Claude Code o imprime como "Base directory for this skill" quando a habilidade carrega; em outros orquestradores, use o mesmo diretório — se tiver dúvidas de onde ele pousou, execute find ~ -name relay.mjs -path '*grok-delegate*' e substitua o diretório acima dele.)

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# read-only (review/diagnosis; best-effort — verify touchedFiles): add --read-only
# continue the previous Grok session:       add --resume-last  (send only the delta brief)
# hard time limit (watchdog):               add --timeout 2h  (default: off; implementation runs routinely need 1-2h)
# see all options:                          node .../relay.mjs --help

O helper usa por padrão um perfil de autonomia capaz de escrever (workspace-write) — --always-approve mais --sandbox workspace — e escreve seus artefatos em um diretório temporário, mantendo o repositório em revisão limpo. Ele nunca faz commit — veja a etapa 5. Mecânicas, flags e o formato result.json: references/dispatch-and-poll.md.

3. Aguarde a conclusão

O helper bloqueia até que o Grok termine, então o suporte 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 puro / outros agentes: execute-o em primeiro plano para tarefas curtas, ou coloque-o em segundo plano e consulte o arquivo de resultado — … & em bash/zsh (incluindo Git Bash/WSL), ou o equivalente do seu shell (Start-Job em PowerShell, start /b em cmd). A execução é concluída quando result.json existe com um status. (Um erro de uso pré-execução — argumentos inválidos ou um briefing vazio — em vez disso, sai com o código 2 e uma mensagem stderr e

…