michaelwinczuk/swarm-orchestrator

O que swarm-orchestrator faz?

Habilidade do Agente para Claude: Projetar, construir e depurar enxames multiagente. 8 arquétipos, 5 padrões, cascata determinística primeiro, protocolo de quadro-negro.

Visão Geral

Esta habilidade fornece uma estrutura para projetar e executar enxames de agentes de forma determinística. Em vez de depender de comportamentos emergentes imprevisíveis, ela usa uma cascata de etapas bem definidas, onde cada agente tem um papel específico e segue um protocolo claro.

Arquétipos

Os 8 arquétipos de agentes disponíveis são:

1. Especialista - Agente focado em um domínio específico.
2. Orquestrador - Coordena o fluxo de trabalho entre agentes.
3. Crítico - Avalia e fornece feedback sobre saídas de outros agentes.
4. Sintetizador - Combina múltiplas saídas em uma resposta coesa.
5. Gerador - Produz conteúdo ou ideias iniciais.
6. Verificador - Valida resultados contra critérios predefinidos.
7. Tradutor - Converte entre linguagens, formatos ou representações.
8. Observador - Monitora o processo e registra eventos para depuração.

Padrões

Os 5 padrões de interação:

1. Cascata - Agentes são executados em sequência, cada um recebendo a saída do anterior.
2. Debate - Múltiplos agentes discutem um tópico até chegar a um consenso.
3. Votação - Agentes votam entre opções, com a maioria vencendo.
4. Pesquisa - Agentes exploram um espaço de soluções de forma paralela ou hierárquica.
5. Fluxo Livre - Agentes se comunicam sem uma ordem predefinida, mas dentro das regras do protocolo.

Protocolo de Quadro-Negro

O protocolo de quadro-negro (chalkboard) é um mecanismo de memória compartilhada onde agentes podem:

• Escrever mensagens em um espaço público.
• Ler mensagens de outros agentes.
• Reagir a eventos ou mudanças de estado.

Cada mensagem no quadro-negro possui um carimbo de data/hora, remetente e tipo, permitindo rastreamento completo do histórico de interações.

Uso

# Exemplo de inicialização do enxame via CLI
swarm-orchestrator init --archetype specialist --pattern cascade

from swarm_orchestrator import Swarm

swarm = Swarm(
    archetypes=["specialist", "critic", "synthesizer"],
    pattern="cascade",
    chalkboard=True
)
swarm.run(input="Projetar um sistema de recomendação")

Configuração

Variáveis de ambiente:

• SWARM_API_KEY - Chave de API para serviços externos.
• SWARM_LOG_LEVEL - Nível de logging (DEBUG, INFO, WARN, ERROR).
• SWARM_TIMEOUT - Tempo limite para cada etapa da cascata (em segundos).

Suporte

Plataformas: Claude Code, Cursor, Codex.

Licença

MIT