Smokefarmer/multi-agent-delivery-skill

Multi-Agent Delivery

Visão Geral

Use esta habilidade quando a tarefa for grande o suficiente para se beneficiar de planejamento estruturado, implementação paralela, revisão explícita e uma verificação real antes de reportar conclusão.

Não use esta habilidade para pequenas edições de arquivo único onde a sobrecarga de delegação é maior que a tarefa.

Fluxo de Trabalho

1. Inspecione antes de alterar

• Leia os caminhos de código relevantes antes de propor edições.
• Identifique o bloqueador imediato no caminho crítico.
• Distinga trabalho bloqueador de trabalho periférico que pode ser executado em paralelo.

2. Escreva um plano de execução curto

• Para tarefas não triviais, produza um plano conciso antes de edições substanciais.
• Mantenha exatamente uma etapa em andamento por vez.
• Atualize o plano quando o escopo mudar ou ao passar da análise para implementação para verificação.

3. Divida o trabalho em fatias independentes

• Mantenha o thread principal responsável por integração, resolução de conflitos e verificação final.
• Use explorers para perguntas delimitadas sobre a base de código ou descoberta de hotspots.
• Use workers para fatias concretas de implementação com propriedade explícita de arquivos.
• Atribua a cada worker um escopo de escrita sem sobreposição e instrua-o a não reverter alterações não relacionadas no diretório de trabalho.
• Mantenha trabalho urgente no caminho crítico local quando a próxima ação depender dele imediatamente.

4. Delegue com propriedade clara

Cada prompt de worker deve incluir:

• Os arquivos ou módulos exatos que ele possui
• O resultado específico esperado
• Um aviso de que outros agentes também estão editando o repositório
• Instruções para não tocar em arquivos fora de sua propriedade
• Uma solicitação por verificação direcionada e um resumo dos arquivos alterados

5. Revise após a implementação

• Após alterações de código, execute pelo menos uma passagem de revisão no resultado integrado.
• Adicione uma revisão focada em segurança para trabalho de autenticação, manipulação de entrada, RPC, pagamentos ou transações.
• Adicione uma revisão Rust/Anchor para alterações de contratos inteligentes.
• Corrija descobertas de revisão de alta gravidade antes de reportar conclusão.

6. Verifique antes de declarar concluído

Execute a verificação prática mais forte para as camadas tocadas:

• Type-check
• Lint
• Testes
• Build/teste de contrato quando aplicável

Para campanhas amplas de limpeza, execute verificação direcionada por fatia primeiro, depois uma passagem completa em nível de repositório para as camadas afetadas.

Nunca relate "concluído" enquanto a verificação necessária ainda estiver falhando.

7. Relate resultados claramente

O relatório final deve incluir:

• O que mudou em alto nível
• Quais verificações passaram, com contagens quando disponíveis
• Quais dívidas ou riscos residuais permanecem
• O que não foi executado, se houver algo

Regras de Delegação

• Prefira agentes paralelos apenas quando seus escopos de escrita não se sobrepuserem.
• Não duplique trabalho entre o thread principal e os workers.
• Use wait_agent com moderação; continue fazendo trabalho local útil enquanto os agentes executam.
• Feche agentes finalizados quando não forem mais necessários.

Padrão Sugerido

Para uma tarefa não trivial típica:

1. Inspecione e escreva um plano curto.
2. Dispense 1 explorer se análise de hotspot for necessária.
3. Dispense 1-3 workers em fatias independentes.
4. Continue o trabalho de integração local enquanto eles executam.
5. Integre resultados e resolva conflitos localmente.
6. Execute uma ou mais passagens de revisão.
7. Execute verificação completa.
8. Relate resultados e dívidas remanescentes.