Delegação Paralela de Agentes

O que Delegação Paralela de Agentes faz?

Use ao distribuir trabalho para vários subagentes em uma única chamada delegate_task, especialmente quando eles criam ou editam arquivos. A maioria dos estouros de custo e árvores corrompidas aqui vêm de dois agentes acreditarem que são donos do mesmo arquivo.

Quando Usar

Qualquer divisão multiagente onde as tarefas tocam o mesmo repositório, diretório ou projeto — criação de arquivos, refatorações divididas por área, ou divisões de construção e teste.

Procedimento

1. Divida antes de despachar, por caminho. Dê a cada tarefa propriedade exclusiva de arquivos ou diretórios nomeados. Dois agentes não podem escrever o mesmo arquivo, e nenhum arquivo pode ficar sem atribuição. Prefira fatias menores e claramente maiores em vez de muitas sobrepostas.

2. Indique caminhos absolutos em cada brief de tarefa. Caminhos relativos são resolvidos em um diretório de trabalho diferente dentro de alguns agentes, e é assim que o trabalho acaba em ~/fixture em vez de ~/Projects/app/fixture. Inclua uma linha explícita "não crie nada fora desta árvore".

3. Atribua um proprietário por arquivo compartilhado. Arquivos de configuração, manifestos e registros de lista são reivindicados por uma única tarefa pelo nome; diga aos outros que eles não devem editá-lo, apenas relatar o que ele deve conter.

4. Proíba efeitos colaterais que você não deseja. Diga explicitamente se instalações, construções, execuções de teste e commits git são permitidos. Instalações não supervisionadas espalham node_modules em diretórios não relacionados.

5. Solicite um relatório verificável por máquina: caminhos absolutos exatos criados, o que foi verificado e como foi verificado (analisado, renderizado, construído, testado por unidade). Sucesso auto-relatado sem um método de verificação é ruído.

6. Verifique você mesmo o resultado mesclado antes de fazer commit ou reportar: construa, execute a suíte de testes e leia os arquivos críticos de volta. Não confie que N relatórios independentes compõem uma árvore funcional.

7. Varra em busca de arquivos perdidos. Pesquise fora da árvore alvo por diretórios que os agentes possam ter criado (raiz home, diretórios de projetos irmãos, rascunho). Reconcilie qualquer coisa encontrada antes do fim da sessão.

Regras permanentes

• Arquivos deletados são um sintoma: quando dois agentes podam caminhos "não utilizados", cada um remove o que o outro acabou de escrever. Atribua direitos de exclusão explicitamente.
• Não bloqueie sua própria vez esperando por agentes irmãos; continue o trabalho independente e aja quando os resultados deles chegarem.
• Quando os resultados chegarem depois que você já terminou e fez commit, verifique o estado da árvore de trabalho e arquivos perdidos, então decida o que ainda precisa ser feito — não presuma que a árvore está limpa, e não presuma que o trabalho deles conflita.
• Mantenha o número de agentes escrevendo em um artefato o mais baixo possível; distribua livremente análises somente leitura, com moderação as escritas.

Armadilhas

• Colisões de nomes compartilhados. Dois briefs descrevendo "os arquivos CSS" ou "a configuração" levam a caminhos diferentes por agente; nomeie caminhos absolutos exatos.
• Deriva de convenções. Agentes vendo uma árvore parcialmente construída adotam o layout de outro durante o voo, deixando duas convenções em um projeto; fixe o layout no brief.
• Confiar em verificação não executada. Relatórios alegando que uma construção ou renderização passou sem evidência geralmente significam que foi julgada estruturalmente; reproduza-a.
• Colisões de limpeza. Um agente deletando seus próprios arquivos "agora-mortos" pode deletar a entrega de um irmão — veja a regra permanente acima.

Arquivos de suporte

• templates/delegation-brief.md — brief de tarefa copiável e preenchível que impõe propriedade de caminho, efeitos colaterais proibidos e um formato de relatório verificável.