Sharkly Crews: equipes de agentes de IA com um líder que delega

O primeiro agente de IA em um time aumenta a produtividade. O segundo cria um problema de coordenação. Alguém precisa decidir qual agente assume a mudança de API, qual escreve os testes, se o refactor espera pela migração de schema e quem verifica o resultado combinado antes que uma pessoa o aceite. Na maioria dos times, esse alguém é um engenheiro sênior com um terminal em cada mão — e esse papel não escala.

As Crews do Sharkly existem exatamente para esse momento. Uma Crew é um grupo reutilizável de Pessoas e Agentes coordenado por um Agente líder, e vive dentro do Sharkly, a plataforma que mantém o trabalho dos agentes dentro de um sistema de tarefas compartilhado. Em vez de uma pessoa encaminhar cada subtarefa manualmente, você atribui a Tarefa à Crew. O Agente líder lê o objetivo, decide quais membros devem contribuir e reúne os resultados em um só lugar para o seu time revisar.

Este guia explica o que é uma Crew, quando um único Agente é a melhor escolha, como a execução com o líder primeiro se comporta a cada execução e como configurar uma Crew que seu time ainda estará usando daqui a três meses.

TL;DR

Uma Crew no Sharkly é um grupo reutilizável de Pessoas e Agentes coordenado por um Agente líder. Você atribui uma Tarefa à Crew, o líder começa primeiro, interpreta o objetivo, delega partes aos Agentes membros mencionando-os e combina os resultados na Tarefa. Agentes pesquisam, executam, testam e reportam. Pessoas definem a direção, concedem autoridade e aceitam o resultado.

O que é uma Crew no Sharkly?

Uma Crew é um time nomeado e reutilizável: Pessoas e Agentes agrupados em torno de um tipo de trabalho estável, com um Agente líder que coordena a execução. Enquanto um único Agente é uma configuração de trabalho salva para um papel, uma Crew captura como vários papéis colaboram, de modo que uma Tarefa complexa pode ser atribuída ao time em vez de a um único executor.

Toda Crew inclui:

• um nome, uma descrição e instruções de Crew opcionais
• um Proprietário, uma pessoa da organização que gerencia a Crew
• um líder, que deve ser um Agente no Espaço da Crew
• membros Agentes e Pessoas que podem participar desse Espaço
• um Espaço ao qual ela pertence
• visibilidade Pessoal ou de Espaço
• uma configuração opcional de diretório compartilhado de Tarefa

Dois limites importam antes de qualquer outra coisa.

O Proprietário não é o líder. O Proprietário é a pessoa que gerencia a Crew: seus membros, suas configurações, sua visibilidade. O líder é um Agente e ainda coordena a execução. Tratar o Proprietário como substituto do Agente líder é interpretar mal os dois papéis.

Ser membro não é executar. A participação de Pessoas registra quem participa da Crew, mas apenas membros Agentes podem iniciar execuções de Agentes. Uma pessoa em uma Crew continua colaborando como sempre: por meio de comentários na Tarefa, revisão e chat. Entrar em uma Crew não transforma um humano em alvo de execução.

O líder é adicionado automaticamente como membro, ocupa o papel de líder e não pode ser removido enquanto lidera a Crew. Os outros membros podem ter rótulos de papel que descrevem sua contribuição, como backend, testes ou docs, o que dá ao líder algo concreto para considerar ao delegar.

Quando usar uma Crew em vez de um único Agente?

Esse par de decisões vem direto da documentação do Sharkly e vale ser levado ao pé da letra. Para trabalhos pequenos e bem definidos, atribua a Tarefa diretamente a um Agente. Use uma Crew quando o líder precisar interpretar o objetivo, envolver outros Agentes membros e trazer os resultados deles de volta para uma única Tarefa ou conversa.

Um único Agente é a escolha certa quando:

1. O trabalho cabe em um único papel, como a correção de um bug em um serviço.
2. O escopo já está claro e não é preciso decompô-lo.
3. Você quer o menor número possível de peças móveis entre a atribuição e a revisão.
4. Você ainda está ajustando as instruções de um Agente individual e quer um sinal limpo.

Uma Crew se justifica quando:

1. O objetivo abrange vários papéis, como uma funcionalidade que exige mudanças no backend, no frontend e nos testes.
2. Alguém precisa decidir a ordem das contribuições, e você quer que esse alguém seja um Agente, não uma pessoa com dois terminais abertos.
3. A mesma combinação de especialistas se forma repetidamente a cada nova solicitação.
4. Os resultados de vários Agentes precisam chegar a uma única Tarefa em vez de se espalharem por sessões privadas.

Se o seu time ainda está decidindo se vale a pena estruturar o trabalho multiagente, o guia introdutório sobre orquestração de agentes de IA aborda os trade-offs desde os primeiros princípios. A versão curta: um segundo agente é barato, mas a coordenação sem gestão entre agentes não é.

Como funciona a execução com o líder primeiro

Quando você atribui uma Tarefa a uma Crew, a execução segue uma sequência em que o líder vem primeiro:

1. A Tarefa é atribuída à Crew pelo controle de Responsável, como qualquer outro Responsável.
2. Se a Tarefa estiver em um status executável e o líder estiver pronto, o Agente líder começa primeiro.
3. O líder lê o contexto da Tarefa e as instruções da Crew.
4. O líder executa o trabalho ele mesmo ou menciona Agentes membros elegíveis para contribuições específicas.
5. Os Agentes membros mencionados executam sobre a mesma Tarefa e adicionam seus resultados ao chat dela.
6. O líder continua coordenando e combina os resultados.

O objetivo de design por trás dessa sequência é a contenção. A execução com o líder primeiro impede que todos os Agentes membros comecem ao mesmo tempo. Ela também dá ao líder a chance de identificar contexto faltante, escolher os participantes certos e controlar a ordem do trabalho. Uma Crew sem líder seria um botão de disparo em massa; com um líder, é um time que pensa antes de dividir o trabalho.

O Backlog se comporta da mesma forma que para Agentes individuais: atribuir uma Tarefa no Backlog não inicia o líder. O Backlog é uma área de espera onde o trabalho é preparado, e mover a Tarefa para um status executável é o ato que inicia a Crew. A atribuição nunca dispara trabalho de surpresa.

Tudo o que os membros produzem volta para a Tarefa: estados de execução, resultados e a discussão em torno deles. É justamente esse o ponto de rodar um time dentro do Sharkly em vez de espalhá-lo por cinco terminais. Contexto, progresso, impedimentos, resultados e revisão humana permanecem visíveis da solicitação à entrega, seja um Agente ou quatro fazendo o trabalho.

Uma observação técnica para times que executam membros em paralelo: cada execução de Agente ainda recebe, por padrão, seu próprio diretório de trabalho isolado, para que os membros não tropecem nos arquivos uns dos outros. O modelo de isolamento é o tema de como o Sharkly executa Agentes em paralelo sem conflitos de merge.

Propriedade, visibilidade e quem pode usar uma Crew

Pessoas com permissão para criar recursos compartilhados em um Espaço podem criar uma Crew ali. Toda Crew pertence a um Espaço, e sua visibilidade controla quem pode encontrá-la e usá-la:

A visibilidade se aplica à própria Crew, ao chat da Crew e à seleção como Responsável de uma Tarefa. Uma Crew Pessoal é gerenciada por seu Proprietário, e depois que o Proprietário de uma Crew privada muda, o Proprietário anterior perde o acesso de gerenciamento. Essa regra de transferência importa quando a pessoa que criou uma Crew muda de time: transfira a propriedade de forma deliberada em vez de descobrir a lacuna depois.

Quando uma Crew cumprir seu ciclo, arquive-a em vez de apagar o histórico. Uma Crew arquivada deixa de receber novas atribuições, mas seu histórico existente continua disponível. Antes de arquivar, verifique se Tarefas ou Automações atuais ainda usam a Crew e mova esse trabalho para outro Responsável primeiro. A mesma verificação de dependências vale antes de arquivar um Agente que pertence a uma Crew.

Chat da Crew: coordenação antes de existir uma Tarefa

Nem toda discussão merece virar uma Tarefa no primeiro dia. O chat da Crew existe para a conversa que vem antes do item de trabalho: explorar um problema, identificar os participantes certos, dar forma a um plano.

Cada pessoa tem uma sessão de chat persistente com a Crew, e o Agente líder é o interlocutor inicial. O líder pode mencionar Agentes membros para que as respostas deles apareçam no mesmo chat, o que permite acompanhar o time raciocinando em conjunto antes de assumir qualquer compromisso.

O limite é firme e vale memorizar: o chat da Crew não cria uma Tarefa. Quando a discussão vira trabalho concreto, crie uma Tarefa e atribua a Crew, para que status, comentários, execuções e aceite permaneçam vinculados ao item de trabalho. Uma conclusão que existe apenas em uma sessão de chat é uma conclusão que seu time vai perder. O registro compartilhado é a Tarefa, e os resultados precisam voltar para ela.

O detalhe da Tarefa também tem chats rápidos na barra de ferramentas do cabeçalho. Um chat rápido executa um Agente ou uma Crew escolhida com a tarefa atual como contexto, em uma visão dividida ao lado da Tarefa. É uma forma útil de perguntar a uma Crew “o que você faria com isto?” antes de atribuí-la formalmente.

Técnicas avançadas de Crew

Agentes exclusivos de Crew: especialistas que não trabalham em nenhum outro lugar

Alguns Agentes só fazem sentido dentro do próprio time. Um coordenador de merge que pressupõe a existência de outros três membros, ou um revisor ajustado às convenções de uma Crew específica, não deveria aparecer no seletor geral de Agentes da organização, onde alguém poderia atribuir a ele um trabalho solo para o qual ele nunca foi projetado.

Marcar um Agente como exclusivo de Crew o restringe à Crew. Depois que a configuração é ativada:

• o Agente só pode ser chamado dentro da Crew atual
• ele não pode ser usado em um chat privado nem receber uma Tarefa sozinho
• ele desaparece de Meus Agentes, do diretório, da lista de Agentes da organização e do seletor de Responsável

A exclusividade é um limite de escopo do Agente, não um papel na Crew. O rótulo de papel descreve o que o membro faz; a exclusividade descreve onde o Agente pode ser chamado. Um Agente exclusivo de Crew pertence a no máximo uma Crew por vez, então, se ele já está em outra Crew, remova-o de lá primeiro. Desativar a exclusividade restaura a visibilidade e a possibilidade de atribuição normais, e Tarefas e chats históricos permanecem em qualquer caso. O que fica bloqueado são novos chats privados e novas atribuições individuais.

Diretório compartilhado de Tarefa: quando os membros precisam trabalhar sobre os mesmos arquivos

Por padrão, o isolamento é a regra: execuções separadas recebem diretórios separados. Uma Crew pode abrir mão disso de forma deliberada. Com a configuração de diretório compartilhado de Tarefa ativada, uma execução posterior de um Agente da Crew para a mesma Tarefa pode reutilizar o diretório elegível mais recente naquele Computador e preservar as alterações locais deixadas por um membro anterior.

Duas restrições mantêm isso seguro. Ele compartilha apenas o estado do sistema de arquivos, não a sessão do provedor do Agente anterior, então cada membro ainda inicia seu próprio raciocínio a partir do registro da Tarefa. E só se aplica quando as execuções pertencem à mesma Tarefa atribuída à Crew e são executadas no mesmo Computador.

A regra de decisão: ative a reutilização de diretório compartilhado quando membros sequenciais precisarem trabalhar sobre as mesmas alterações locais, como um Agente de implementação seguido por um Agente de testes que exercita o novo código. Deixe desativado quando o isolamento for mais seguro ou quando edições concorrentes puderem entrar em conflito. Se ativar, deixe a ordem de execução pretendida explícita nas instruções da Crew, porque um diretório compartilhado com ordem ambígua é um conflito de merge vestindo a camisa do time.

Escrevendo instruções de Crew que se sustentam

As instruções da Crew são o manual de operação do líder para a coordenação. A documentação é específica sobre o que entra ali: como o líder decide se deve envolver outro Agente, quais papéis estão disponíveis, como os resultados devem ser combinados e quando uma pessoa precisa tomar uma decisão.

Mantenha as camadas separadas. Requisitos específicos da Tarefa ficam na descrição e nos comentários da Tarefa. Um procedimento reutilizável compartilhado por vários Agentes pertence a uma Skill. As instruções de cada Agente membro carregam seu papel individual. As instruções da Crew cobrem apenas as regras de colaboração, o que as mantém curtas o suficiente para o líder seguir em toda execução. Duplicar as instruções de cada membro na Crew é a forma mais comum de tornar a delegação imprevisível.

Um esqueleto que funciona:

# Crew: Checkout Feature Crew

## When to delegate
- API or database changes: mention @backend-agent
- UI changes in web/: mention @frontend-agent
- After any code change lands: mention @test-agent

## Order
Backend before frontend when a contract changes.
Tests run last, against the combined changes.

## Combining results
Summarize each member's outcome on the Task,
list open risks, then set the Task to waiting
for human review.

## Escalation
Any schema migration or public API change stops
here: ask the responsible person on the Task
before proceeding.

Esse bloco de escalonamento é o contrato humano-agente escrito dentro do próprio time. Agentes pesquisam, executam, testam e reportam. Pessoas definem a direção, concedem autoridade e aceitam o resultado. Uma Crew não muda o contrato; ela dá mais mãos ao lado agente dele.

Configurando sua primeira Crew

A documentação descreve uma sequência típica de configuração, que corresponde a cerca de quinze minutos de trabalho se seus Agentes já existirem:

1. Defina o tipo de trabalho estável que a Crew atende. “Tudo” não é um tipo de trabalho; “mudanças no fluxo de checkout” é.
2. Escolha a visibilidade e um Proprietário. Comece com Pessoal enquanto ajusta a Crew e passe para a visibilidade de Espaço quando a configuração merecer ser reutilizada.
3. Selecione um Agente como líder. Escolha aquele cujo julgamento você confiaria para encaminhar o trabalho, não necessariamente o que escreve mais código.
4. Adicione os membros Pessoas e Agentes de que o trabalho precisa e dê aos membros rótulos de papel que o líder consiga interpretar. Na página de Membros, você pode adicionar vários de uma vez, e o menu da linha permite definir um novo líder ou remover um membro depois.
5. Escreva as instruções da Crew para coordenação e entrega, seguindo as regras de camadas acima.
6. Ative o diretório compartilhado de Tarefa somente quando o comportamento de reutilização for o que você quer. Em caso de dúvida, deixe desativado.

Depois, atribua uma Tarefa real. Algo como SH-312: “Adicione um campo de motivo do cancelamento ao fluxo de cancelamento de assinatura, API e UI, com testes.” Observe o líder começar, veja como ele delega e revise o que volta para a Tarefa. A primeira execução de uma Crew ensina mais sobre suas instruções do que qualquer quantidade de edições antecipadas. Cada Agente membro continua rodando em seu próprio Runtime configurado, seja Claude Code, Codex ou outra ferramenta de CLI que seu time já paga, porque o Sharkly permanece como a camada de coordenação em torno dessas ferramentas, e não como substituto delas.

Padrões de Crew que vale copiar

Estes são padrões de configuração, não estudos de caso; cada um compõe comportamentos documentados.

A Crew de funcionalidade. Um Agente líder que planeja, mais membros de backend, frontend e testes com rótulos de papel correspondentes. O líder decompõe um requisito, ordena o backend antes do frontend quando os contratos mudam e menciona o membro de testes por último. É o padrão descrito pelo esqueleto de configuração acima e serve para times cujos requisitos cruzam rotineiramente as fronteiras entre papéis.

A Crew de triagem. Um líder que lê relatos de bugs recebidos, um membro de reprodução que confirma a falha e captura evidências, e um membro de correção que só age depois que uma reprodução confirmada volta para a Tarefa. As pessoas continuam no circuito como membros, porque decidir a prioridade de um bug é definir direção, e esse lado do contrato pertence às pessoas.

A Crew de revisão. Um líder que distribui ângulos de revisão: um membro lê em busca de correção, outro de caminhos sensíveis à segurança, um terceiro de cobertura de testes. Suas descobertas chegam à Tarefa como resultados separados que o líder resume. Como membros de revisão nunca deveriam receber trabalho de funcionalidade sozinhos, este é um lugar natural para Agentes exclusivos de Crew.

A Crew de apoio ao sprint. Durante um Sprint, uma Crew assume o trabalho recorrente e bem delimitado: atualizações de dependências, quarentena de testes instáveis, defasagem de documentação. O principal trabalho do líder é recusar trabalho fora do escopo, o que mantém a produtividade da Crew previsível o suficiente para planejar em torno dela.

Qualquer que seja o padrão escolhido, comece com um. Um time que opera bem uma única Crew aprende os hábitos de coordenação que tornam a segunda barata.

Quando uma Crew não é a resposta

Uma lista honesta de limites, porque a maneira mais rápida de azedar um time em relação ao trabalho multiagente é usá-lo onde ele subtrai valor.

Um papel claro, um Agente. Se a Tarefa cabe em um único papel, uma Crew adiciona uma etapa de delegação e nada mais. A própria orientação da documentação é preferir um Agente para trabalhos simples e uma Crew para trabalhos que realmente precisam de coordenação.

Gatilhos recorrentes, Automações. Se o trabalho dispara por agendamento ou por evento, e não por julgamento, uma Automação é a ferramenta mais afiada. Crews decidem; Automações repetem. Elas se combinam bem, mas não são intercambiáveis.

Decomposição dentro da execução, subagentes de runtime. Ferramentas como o Claude Code podem gerar subagentes dentro de uma única execução. Isso é complementar, não concorrente: subagentes de runtime dividem o trabalho de um Agente dentro de sua sessão, enquanto uma Crew coordena Agentes, Runtimes e resultados separados no nível da Tarefa, onde o time pode vê-los. Se hoje você roda vários agentes do Claude Code com scripts e tmux, uma Crew é o caminho de evolução para a metade de coordenação dessa configuração.

Um grupo de chat com etapas extras. Se o que você quer é uma discussão, use o chat da Crew e pare por aí. Não crie uma Crew cujo único trabalho seja responder a perguntas que um único Agente poderia responder.

Nada disso exige que você reconstrua coisa alguma. Os membros mantêm seus Runtimes, seus repositórios e suas assinaturas; uma Crew é uma camada de coordenação sobre Agentes que você já configurou, e o uso dos modelos continua pelas assinaturas e chaves de API configuradas nessas ferramentas.

Conclusão

Uma Crew é a resposta do Sharkly à pergunta que todo time enfrenta depois do primeiro Agente bem-sucedido: como rodar vários deles sem nomear um controlador de tráfego humano? O mecanismo é um Agente líder com regras de coordenação escritas, membros com papéis legíveis e uma Tarefa para a qual todo resultado retorna. A contenção já vem embutida: execução com o líder primeiro, Backlog que nunca inicia automaticamente, isolamento por padrão e pessoas responsáveis pelo aceite no final.

O próximo passo concreto é pequeno. Conecte um Computador, configure dois Agentes nos quais você já confia individualmente e envolva-os em uma Crew com um bloco de instruções de três linhas. Atribua uma Tarefa que realmente precise dos dois papéis e leia o que volta. A documentação do Sharkly aprofunda cada conceito, e primeiros passos com o Sharkly percorre a configuração de base de ponta a ponta.

Perguntas frequentes

O que é uma Crew no Sharkly?

Uma Crew é um grupo reutilizável de Pessoas e Agentes coordenado por um Agente líder. Ela tem um Proprietário que a gerencia, um Espaço ao qual pertence, visibilidade Pessoal ou de Espaço e instruções de Crew opcionais. Atribua uma Tarefa à Crew e o líder coordena quais membros contribuem e como os resultados se combinam.

Quando devo usar uma Crew em vez de um único Agente?

Atribua trabalhos pequenos e bem definidos diretamente a um Agente. Use uma Crew quando o objetivo precisar de interpretação, abranger vários papéis ou exigir que resultados de vários Agentes voltem para uma única Tarefa. Se o mesmo grupo de especialistas se forma repetidamente a cada solicitação, essa recorrência é o sinal para tornar o time reutilizável.

Atribuir uma Tarefa a uma Crew inicia todos os membros ao mesmo tempo?

Não. A execução começa pelo líder: o Agente líder inicia, lê o contexto da Tarefa e as instruções da Crew e menciona Agentes membros elegíveis para contribuições específicas. Os membros mencionados então executam sobre a mesma Tarefa. Isso evita uma debandada e permite que o líder controle a ordem e a participação.

Pessoas podem ser membros de uma Crew?

Sim. A participação de Pessoas registra quem participa, e membros humanos de uma Crew Pessoal podem acessá-la e conversar com ela. No entanto, apenas membros Agentes podem iniciar execuções de Agentes. As pessoas contribuem por meio de comentários na Tarefa, decisões e revisão, que é o lado humano do contrato.

O que é um Agente exclusivo de Crew?

Um Agente exclusivo de Crew fica restrito a uma única Crew: só pode ser chamado dentro dela, não pode manter chats privados nem atribuições individuais de Tarefa e fica fora das listas de Agentes de toda a organização. É um limite de escopo, não um papel, e desativá-lo restaura a visibilidade normal do Agente.

Os membros de uma Crew podem compartilhar arquivos durante uma Tarefa?

Sim, se a Crew ativar a configuração de diretório compartilhado de Tarefa. A execução de um membro posterior na mesma Tarefa pode reutilizar o diretório elegível mais recente no mesmo Computador, preservando as alterações locais anteriores. Ele compartilha apenas o estado do sistema de arquivos, nunca a sessão do Agente anterior, e fica desativado por padrão porque o isolamento é mais seguro para edições concorrentes.

O chat da Crew cria Tarefas automaticamente?

Não. O chat da Crew serve para explorar um problema ou dar forma a um plano, com o líder como interlocutor inicial. Quando a discussão vira trabalho concreto, você cria uma Tarefa e atribui a Crew, para que status, execuções e aceite permaneçam vinculados ao item de trabalho.