gh-wasabeef-claude-code-cookbook-plugins-pt/commands/role-help.md

Role Help

Guia de seleção e sistema de ajuda para quando não souber qual papel usar.

Uso

/role-help                      # Guia geral de seleção de papéis
/role-help <situação/problema>   # Papel recomendado para situação específica
/role-help compare <papel 1>,<papel 2> # Comparação de papéis

Exemplos básicos

# Orientação geral
/role-help
→ Exibe lista de papéis disponíveis e suas características

# Recomendação por situação
/role-help "Preocupado com a segurança da API"
→ Recomendação do papel security e modo de uso

# Comparação de papéis
/role-help compare frontend,mobile
→ Diferenças entre frontend e mobile e como usar cada um

Guia de seleção de papéis por situação

Relacionado à segurança

Use o papel security quando:
✅ Implementação de login e autenticação
✅ Verificação de vulnerabilidades de segurança da API
✅ Criptografia de dados e proteção de privacidade
✅ Verificação de compliance de segurança
✅ Teste de invasão e penetração

Uso: /role security

🏗️ Arquitetura e design

Use o papel architect quando:
✅ Avaliação do design do sistema geral
✅ Decisão entre microsserviços vs monólito
✅ Design de banco de dados e seleção tecnológica
✅ Considerações de escalabilidade e extensibilidade
✅ Avaliação de dívida técnica e planos de melhoria

Uso: /role architect

⚡ Problemas de performance

Use o papel performance quando:
✅ Aplicação está lenta
✅ Otimização de consultas ao banco de dados
✅ Melhoria da velocidade de carregamento de páginas web
✅ Otimização do uso de memória e CPU
✅ Estratégias de scaling e balanceamento de carga

Uso: /role performance

🔍 Investigação de causas de problemas

Use o papel analyzer quando:
✅ Análise da causa raiz de bugs e erros
✅ Investigação de causas de falhas do sistema
✅ Análise estrutural de problemas complexos
✅ Análise de dados e investigação estatística
✅ Esclarecimento de por que este problema ocorreu

Uso: /role analyzer

🎨 Frontend e UI/UX

Use o papel frontend quando:
✅ Melhoria da interface do usuário
✅ Suporte à acessibilidade
✅ Design responsivo
✅ Melhoria da usabilidade e facilidade de uso
✅ Tecnologias gerais de frontend web

Uso: /role frontend

📱 Desenvolvimento de aplicativos móveis

Use o papel mobile quando:
✅ Otimização de apps iOS e Android
✅ Design de UX específico para mobile
✅ Otimização de interface touch
✅ Suporte offline e funções de sincronização
✅ Suporte para App Store e Google Play

Uso: /role mobile

👀 Code review e qualidade

Use o papel reviewer quando:
✅ Verificação da qualidade do código
✅ Avaliação de legibilidade e manutenibilidade
✅ Verificação de convenções de codificação
✅ Propostas de refatoração
✅ Review de PR e commits

Uso: /role reviewer

🧪 Testes e garantia de qualidade

Use o papel qa quando:
✅ Planejamento de estratégias de teste
✅ Avaliação de cobertura de teste
✅ Política de implementação de testes automatizados
✅ Estratégias de prevenção de bugs e melhoria da qualidade
✅ Automação de testes em CI/CD

Uso: /role qa

Quando múltiplos papéis são necessários

🔄 multi-role (análise paralela)

Use multi-role quando:
✅ Quiser avaliação de múltiplas perspectivas especializadas
✅ Quiser criar plano de melhoria integrado
✅ Quiser comparar avaliações de cada área
✅ Quiser organizar contradições e duplicações

Exemplo: /multi-role security,performance

🗣️ role-debate (debate)

Use role-debate quando:
✅ Há trade-offs entre áreas especializadas
✅ Opiniões se dividem na seleção tecnológica
✅ Quiser decidir diretrizes de design por debate
✅ Quiser ouvir debates de diferentes perspectivas

Exemplo: /role-debate security,performance

🤖 smart-review (sugestão automática)

Use smart-review quando:
✅ Não souber qual papel usar
✅ Quiser conhecer a abordagem ideal para a situação atual
✅ Quiser escolher entre múltiplas opções
✅ For iniciante e estiver em dúvida

Exemplo: /smart-review

Tabela de comparação de papéis

Relacionados à segurança

Papel	Uso principal	Área forte	Área fraca
security	Vulnerabilidades e contramedidas	Análise de ameaças, design de autenticação	UX, performance
analyzer	Análise da causa raiz	Análise lógica, coleta de evidências	Medidas preventivas, planejamento futuro

Relacionados ao design

Papel	Uso principal	Área forte	Área fraca
architect	Design de sistema	Perspectiva de longo prazo, otimização global	Implementação detalhada, soluções de curto prazo
reviewer	Qualidade do código	Nível de implementação, manutenibilidade	Requisitos de negócio, UX

Relacionados à performance

Papel	Uso principal	Área forte	Área fraca
performance	Aceleração e otimização	Medição, gargalos	Segurança, UX
qa	Garantia de qualidade	Teste, automação	Design, arquitetura

Relacionados à experiência do usuário

Papel	Uso principal	Área forte	Área fraca
frontend	Web UI/UX	Browser, acessibilidade	Servidor, DB
mobile	Mobile UX	Touch, suporte offline	Servidor, Web

Fluxograma para quando estiver em dúvida

Qual é a natureza do problema?
├─ Relacionado à segurança → security
├─ Problema de performance → performance
├─ Investigação de bug/falha → analyzer
├─ Melhoria de UI/UX → frontend ou mobile
├─ Design/arquitetura → architect
├─ Qualidade do código → reviewer
├─ Relacionado a testes → qa
└─ Complexo/composto → smart-review para sugestão

Abrange múltiplas áreas?
├─ Quero análise integrada → multi-role
├─ Debate/trade-offs → role-debate
└─ Em dúvida sobre decisão → smart-review

Perguntas frequentes

Q: Qual a diferença entre frontend e mobile?

A:
frontend: Foco em navegador web, HTML/CSS/JavaScript
mobile: Foco em app móvel, nativo iOS/Android, React Native etc.

Para casos relacionados a ambos, recomenda-se multi-role frontend,mobile

Q: Como distinguir security e analyzer?

A:
security: Prevenção de ataques e ameaças, design de segurança
analyzer: Análise de causas de problemas já ocorridos, investigação

Para investigação de incidentes de segurança: multi-role security,analyzer

Q: Qual a diferença entre architect e performance?

A:
architect: Design de longo prazo do sistema geral, extensibilidade
performance: Melhoria específica de velocidade e eficiência

Para design de performance de sistemas de grande escala: multi-role architect,performance

Integração com Claude

# Combinação com explicação da situação
/role-help
"O carregamento da página do app React está lento e usuários estão reclamando"

# Combinação com conteúdo de arquivo
cat problem-description.md
/role-help
"Recomende o papel ideal para este problema"

# Quando estiver em dúvida sobre opções específicas
/role-help compare security,performance
"Qual papel é adequado para o problema de tempo de validade do token JWT?"

Observações

• Problemas complexos são mais eficazes com combinação de múltiplos papéis
• Para casos de alta urgência, responda rapidamente com single role
• Quando estiver em dúvida, recomendamos receber sugestão automática com smart-review
• A decisão final deve ser tomada pelo usuário considerando a natureza do problema