Claude Delegate

Quando Usar

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

Você é o orquestrador. Delegue uma tarefa de codificação delimitada para um implementador separado — uma sessão do Claude Code CLI — depois revise o que ele produziu e aplique as mudanças você mesmo. Você escreve o resumo e assume o julgamento; a sessão separada do Claude edita a árvore de trabalho; você verifica e confirma.

Esta habilidade não é um sinal para o Claude atual implementar diretamente. Use-a apenas depois que o humano pedir explicitamente a delegação para outro processo ou sessão do Claude Code.

Quando não usar isto

• O humano pediu ao agente atual para implementar a tarefa diretamente.
• A tarefa é pequena o suficiente para ser feita inline e o humano não solicitou delegação.
• O CLI claude está ausente ou não autenticado (claude auth status).
• A tarefa precisa de um limite de host mais forte do que as permissões de ferramenta e o sandbox apenas de shell do Claude Code fornecem. Use um contêiner ou VM isolado para esse requisito.

Pré-requisitos

1. claude --version é bem-sucedido.
2. claude auth status relata uma sessão autenticada. No macOS, as credenciais ativas ficam no Keychain de login; quando o sandbox do orquestrador bloqueia o acesso ao Keychain (o sandbox do Codex faz isso), claude volta para um arquivo de credenciais possivelmente desatualizado e relata loggedIn: false mesmo que o login seja válido. Reexecute a verificação — e o próprio despacho — com esse sandbox escalado ou fora dele antes de concluir que o CLI não está autenticado.
3. O repositório de destino é o diretório passado com --cd.
4. No Linux/WSL2, as dependências do sandbox do Claude estão instaladas. O perfil de retransmissão normal é configurado para falhar quando o sandbox não está disponível em vez de executar comandos de shell silenciosamente fora do sandbox. Configurações mescladas existentes ainda podem afetar o limite efetivo.

O loop

1. Escreva o resumo

A sessão separada não tem histórico de chat do orquestrador. Ela recebe o resumo via stdin e pode inspecionar a árvore de trabalho de destino.

O Claude Code descobre automaticamente o CLAUDE.md do projeto de destino e a configuração local normal do Claude porque a retransmissão não usa --bare. Ele não carrega genericamente AGENTS.md. Leia AGENTS.md você mesmo e copie todas as restrições de carga e os comandos de portão reais para o resumo. Diga ao implementador para não confirmar. Mantenha uma tarefa por resumo.

Modelo e detalhes: references/writing-the-brief.md.

2. Despacho

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# review/diagnosis only:                 add --read-only
# continue the latest session:           add --resume-last
# continue the recorded session:         add --session <id>
# choose limits:                         add --max-turns 40 --max-budget-usd 10
# hard relay deadline:                   add --timeout 2h
# inspect every option:                  node .../relay.mjs --help

<skill-dir> é este diretório de habilidade instalado, a pasta contendo este SKILL.md.

A retransmissão executa claude -p --output-format stream-json --verbose, envia o resumo via stdin e escreve artefatos no diretório de sistema temporário por padrão. Ela nunca usa --bg ou --bare, e nunca confirma. Veja references/dispatch-and-poll.md.

3. Aguarde

A retransmissão bloqueia até que o Claude saia. Use a instalação de comando em segundo plano do orquestrador, ou execute-a em primeiro plano e espere. A conclusão significa que o processo saiu e result.json existe.

• Um erro de uso pré-execução sai com código 2 e não escreve result.json.
• Um claude ausente sai com código 127 e escreve status: "claude_unavailable".
• Tempo limite e sinais de retransmissão capturados terminam toda a árvore de processos do implementador e preservam um artefato de resultado.

Leia finalMessage, touchedFiles, resultSubtype e os caminhos brutos dos artefatos de result.json.

4. Revisão

Trate o relatório do implementador e os resultados dos portões como afirmações:

• Revise as edições em testes existentes antes que um portão verde signifique algo.
• Reexecute os portões reais do projeto você mesmo.
• Leia o diff completo em relação ao resumo, começando com touchedFiles.
• Inspecione o conteúdo não rastreado e preparado, bem como o diff comum.
• Execute habilidades de guarda relevantes, se instaladas.

Lista de verificação completa: references/review-and-land.md.

5. Aplicar

…