/multi-role

Multi Role

Comando que realiza análise paralela do mesmo objeto com múltiplos roles e gera relatório integrado.

Como usar

/multi-role <role1>,<role2> [--agent|-a] [objeto de análise]
/multi-role <role1>,<role2>,<role3> [--agent|-a] [objeto de análise]

Roles Disponíveis

Roles de Análise Especializada

• security : Especialista em auditoria de segurança
• performance : Especialista em otimização de performance
• analyzer : Especialista em análise de causa raiz
• frontend : Especialista em Frontend/UI/UX
• mobile : Especialista em desenvolvimento mobile
• backend : Especialista em backend e servidor

Roles de Suporte ao Desenvolvimento

• reviewer : Especialista em revisão de código
• architect : Arquiteto de sistemas
• qa : Engenheiro de testes

Importante:

• A opção --agent deve ser colocada imediatamente após a especificação dos roles
• A mensagem deve ser escrita após --agent
• Exemplo correto: /multi-role qa,architect --agent avalie o plano
• Exemplo incorreto: /multi-role qa,architect avalie o plano --agent

Opções

• --agent ou -a : Executa cada role como subagente em paralelo (recomendado para análises em larga escala)
  • Quando esta opção é usada, se a descrição de cada role contém frases de promoção de delegação automática (como "use PROACTIVELY"), uma delegação automática mais agressiva será habilitada

Exemplos Básicos

# Análise de segurança e performance (normal)
/multi-role security,performance
"Avalie este endpoint de API"

# Análise paralela de sistema em larga escala (subagente)
/multi-role security,performance --agent
"Analise comprehensivamente a segurança e performance de todo o sistema"

# Análise integrada de frontend, mobile e performance
/multi-role frontend,mobile,performance
"Considere propostas de otimização desta tela"

# Avaliação multifacetada de design arquitetural (subagente)
/multi-role architect,security,performance --agent
"Avalie o design de migração para microsserviços"

Processo de Análise

Phase 1: Análise Paralela

Cada role analisa independentemente o mesmo objeto

• Execução de avaliação do ponto de vista especializado
• Julgamento com critérios específicos do role
• Geração de recomendações independentes

Phase 2: Análise de Integração

Estrutura e integra os resultados

• Organização dos resultados de avaliação de cada role
• Identificação de sobreposições e pontos contraditórios
• Clarificação de relacionamentos complementares

Phase 3: Relatório Integrado

Geração de recomendações finais

• Plano de ação com prioridades
• Explicitação de trade-offs
• Apresentação de roadmap de implementação

Exemplo de Formato de Saída

Caso de análise com 2 roles

Análise Multi-Role: Security + Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Objeto de análise: Endpoint API /api/users

Resultado da análise Security:
Autenticação: Verificação JWT implementada adequadamente
Autorização: Controle de acesso baseado em roles incompleto
Criptografia: Chave API sendo outputada em texto plano nos logs

Score de avaliação: 65/100
Importância: Alta (devido ao acesso a dados confidenciais)

Resultado da análise Performance:
Tempo de resposta: Média 180ms (meta: dentro de 200ms)
Query de banco de dados: Problema N+1 detectado
Cache: Cache Redis não implementado

Score de avaliação: 70/100
Importância: Média (dentro do range aceitável atualmente)

Análise de correlação:
Oportunidades sinérgicas:
- Considerar criptografia simultaneamente na implementação do cache Redis
- Melhoria na saída de logs beneficia segurança + performance

Pontos de trade-off:
- Reforço da verificação de autorização ↔ Impacto no tempo de resposta
- Criptografia de logs ↔ Redução da eficiência de debug

Prioridade integrada:
Critical: Correção da saída de chave API em texto plano
High: Resolução de query N+1
Medium: Implementação de cache Redis + criptografia
Low: Detalhamento do controle de autorização

Roadmap de implementação:
Semana 1: Implementação de mascaramento de chave API
Semana 2: Otimização de query de banco de dados
Semana 3-4: Design e implementação de camada de cache
Mês 2: Reforço gradual do controle de autorização

Caso de análise com 3 roles

Análise Multi-Role: Frontend + Mobile + Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Objeto de análise: Tela de perfil do usuário

Resultado da análise Frontend:
Usabilidade: Layout intuitivo
Acessibilidade: Taxa de conformidade WCAG 2.1: 85%
Responsivo: Problemas na exibição em tablet

Resultado da análise Mobile:
Touch target: Mais de 44pt garantido
Operação com uma mão: Botões importantes posicionados na parte superior
Suporte offline: Não implementado

Resultado da análise Performance:
Exibição inicial: LCP 2.1 segundos (bom)
Otimização de imagens: WebP não suportado
Carregamento tardio: Não implementado

Recomendações integradas:
1. Otimização mobile (operação com uma mão + suporte offline)
2. Otimização de imagens (WebP + carregamento tardio)
3. Melhoria da UI para tablet

Prioridade: Mobile > Performance > Frontend
Período de implementação: 3-4 semanas

Padrões de Combinação Eficazes

Foco em Segurança

/multi-role security,architect
"Design do sistema de autenticação"

/multi-role security,frontend
"Segurança da tela de login"

/multi-role security,mobile
"Proteção de dados do app mobile"

Foco em Performance

/multi-role performance,architect
"Design de escalabilidade"

/multi-role performance,frontend
"Aceleração de páginas web"

/multi-role performance,mobile
"Otimização de operação do app"

Foco na Experiência do Usuário

/multi-role frontend,mobile
"UI multiplataforma"

/multi-role frontend,performance
"Equilíbrio entre UX e performance"

/multi-role mobile,performance
"Otimização de UX mobile"

Análise Abrangente

/multi-role architect,security,performance
"Avaliação de todo o sistema"

/multi-role frontend,mobile,performance
"Avaliação geral da experiência do usuário"

/multi-role security,performance,mobile
"Diagnóstico geral do app mobile"

Integração com Claude

# Combinação com análise de arquivos
cat src/components/UserProfile.tsx
/multi-role frontend,mobile
"Avalie este componente de múltiplas perspectivas"

# Avaliação de documento de design
cat architecture-design.md
/multi-role architect,security,performance
"Avalie este design em múltiplas áreas especializadas"

# Análise de erros
cat performance-issues.log
/multi-role performance,analyzer
"Analise problemas de performance de múltiplos ângulos"

Diferenciação entre multi-role vs role-debate

Quando usar multi-role

• Quer avaliação independente de cada área especializada
• Quer elaborar plano de melhorias integrado
• Quer organizar contradições e sobreposições
• Quer decidir prioridade de implementação

Quando usar role-debate

• Há trade-offs entre áreas especializadas
• Opiniões podem se dividir na seleção técnica
• Quer decidir política de design através de discussão
• Quer ouvir discussão de diferentes perspectivas

Execução Paralela de Subagentes (--agent)

Usando a opção --agent, cada role é executado em paralelo como subagente independente.

Promoção de Delegação Automática

Quando o campo description dos arquivos de role contém frases como as seguintes, uma delegação automática mais agressiva é habilitada no uso de --agent:

• "use PROACTIVELY"
• "MUST BE USED"
• Outras expressões de ênfase

Fluxo de Execução

Execução normal:
Role 1 → Role 2 → Role 3 → Integração
(Execução sequencial, cerca de 3-5 minutos)

Execução --agent:
Role 1 ─┐
Role 2 ─┼→ Integração
Role 3 ─┘
(Execução paralela, cerca de 1-2 minutos)

Exemplos de Uso Eficaz

# Avaliação geral de sistema em larga escala
/multi-role architect,security,performance,qa --agent
"Avaliação abrangente do novo sistema"

# Análise detalhada de múltiplas perspectivas
/multi-role frontend,mobile,performance --agent
"Análise de otimização UX de todas as telas"

Comparação de Performance

Número de Roles	Execução Normal	Execução --agent	Taxa de Redução
2 roles	2-3 min	1 min	50%
3 roles	3-5 min	1-2 min	60%
4 roles	5-8 min	2-3 min	65%

Observações

• Execução simultânea de 3 ou mais roles pode resultar em saída longa
• Análises complexas podem levar mais tempo de execução
• Se surgirem recomendações mutuamente contraditórias, considere também role-debate
• A decisão final deve ser tomada pelo usuário com base nos resultados integrados
• Ao usar --agent: Usa mais recursos, mas é eficiente para análises em larga escala

Detalhes de Configuração dos Roles

• As configurações detalhadas, o conhecimento especializado e as características de discussão de cada role são definidos em .claude/agents/roles/
• Inclui práticas Evidence-First e contramedidas contra vieses cognitivos
• Frases gatilho específicas de cada role ativam automaticamente o modo especializado