Protocolos de Comunicação da Equipe

Protocolos para comunicação eficaz entre colegas de equipe agentes, incluindo seleção de tipo de mensagem, fluxos de trabalho de aprovação de plano, procedimentos de desligamento e anti-padrões comuns a serem evitados.

Quando Usar Esta Habilidade

• Estabelecer normas de comunicação para uma nova equipe
• Escolher entre tipos de mensagem (mensagem, broadcast, shutdown_request)
• Lidar com fluxos de trabalho de aprovação de plano
• Gerenciar o desligamento gracioso da equipe
• Descobrir identidades e capacidades dos colegas de equipe

Seleção de Tipo de Mensagem

message (Mensagem Direta) — Escolha Padrão

Envie para um único colega de equipe específico:

{
  "type": "message",
  "recipient": "implementer-1",
  "content": "Your API endpoint is ready. You can now build the frontend form.",
  "summary": "API endpoint ready for frontend"
}

Use para: Atualizações de tarefas, coordenação, perguntas, notificações de integração.

broadcast — Use com Moderação

Envie para TODOS os colegas de equipe simultaneamente:

{
  "type": "broadcast",
  "content": "Critical: shared types file has been updated. Pull latest before continuing.",
  "summary": "Shared types updated"
}

Use APENAS para: Bloqueios críticos que afetam a todos, grandes alterações em recursos compartilhados.

Por que com moderação?: Cada broadcast envia N mensagens separadas (uma por colega de equipe), consumindo recursos da API proporcionais ao tamanho da equipe.

shutdown_request — Encerramento Gracioso

Solicite a um colega de equipe que se desligue:

{
  "type": "shutdown_request",
  "recipient": "reviewer-1",
  "content": "Review complete, shutting down team."
}

O colega de equipe responde com shutdown_response (aprovar ou rejeitar com motivo).

Anti-Padrões de Comunicação

Fluxo de Trabalho de Aprovação de Plano

Quando um colega de equipe é gerado com plan_mode_required:

1. O colega de equipe cria um plano usando ferramentas de exploração somente leitura
2. O colega de equipe chama ExitPlanMode, que envia um plan_approval_request para o líder
3. O líder revisa o plano
4. O líder responde com plan_approval_response:

Aprovar:

{
  "type": "plan_approval_response",
  "request_id": "abc-123",
  "recipient": "implementer-1",
  "approve": true
}

Rejeitar com feedback:

{
  "type": "plan_approval_response",
  "request_id": "abc-123",
  "recipient": "implementer-1",
  "approve": false,
  "content": "Please add error handling for the API calls"
}

Protocolo de Desligamento

Sequência de Desligamento Gracioso

1. O líder envia shutdown_request para cada colega de equipe
2. O colega de equipe recebe a solicitação como uma mensagem JSON com type: "shutdown_request"
3. O colega de equipe responde com shutdown_response:
   • approve: true — O colega de equipe salva o estado e sai
   • approve: false + motivo — O colega de equipe continua trabalhando
4. O líder lida com rejeições — Aguarda o colega de equipe terminar, então tenta novamente
5. Após todos os colegas de equipe se desligarem — Chame TeamDelete para remover os recursos da equipe

Lidando com Rejeições

Se um colega de equipe rejeitar o desligamento:

• Verifique o motivo (geralmente "ainda trabalhando na tarefa")
• Aguarde a conclusão da tarefa atual
• Tente novamente a solicitação de desligamento
• Se urgente, o usuário pode forçar o desligamento

Descoberta de Colegas de Equipe

Encontre membros da equipe lendo o arquivo de configuração:

Localização: ~/.claude/teams/{team-name}/config.json

Estrutura:

{
  "members": [
    {
      "name": "security-reviewer",
      "agentId": "uuid-here",
      "agentType": "team-reviewer"
    },
    {
      "name": "perf-reviewer",
      "agentId": "uuid-here",
      "agentType": "team-reviewer"
    }
  ]
}