brmdias/investigate

Skill de Fluxo de Investigação

Automatiza o processo completo de investigação TAM para problemas de clientes.

Uso

/investigate <nome-do-cliente> <descrição-do-problema>

Exemplos:

• /investigate LSEG "erro de timeout no webhook"
• /investigate "Network International" "autenticação do plugin BeyondTrust"
• /investigate Roche "scheduler não dispara jobs"

O que Este Skill Faz

Executa o fluxo completo de investigação descrito no CLAUDE.md:

1. Encontrar perfil do cliente - Localizar e ler detalhes do ambiente do cliente
2. Pesquisar base de conhecimento - Encontrar investigações similares e melhores práticas
3. Verificar documentação - Confirmar se o comportamento está documentado
4. Verificar no código - Pesquisar o código-fonte do produto para comportamento real
5. Verificar rastreadores externos - Pesquisar issues no GitHub e Jira para bugs/desenvolvimento conhecidos
6. Recomendar ambiente de teste - Sugerir sandbox apropriado com base no tipo de problema
7. Resumir descobertas - Fornecer resumo estruturado com referências
8. Documentar investigação - Criar novo arquivo de investigação em investigations/ usando template

Instruções

Quando este skill for invocado, siga estas etapas:

Etapa 1: Extrair Parâmetros

A partir dos argumentos, identifique:

• customer_name: O nome do cliente/empresa
• issue_keywords: Termos-chave que descrevem o problema (mensagens de erro, funcionalidades, componentes)

Etapa 2: Encontrar Perfil do Cliente

Grep pattern="<customer_name>" path="customers/" output_mode="files_with_matches"

Se encontrado:

• Read o arquivo de perfil do cliente
• Anote: ambiente (cloud/on-prem), versão do Rundeck, escala, problemas passados
• Armazene o contexto do cliente para uso posterior

Se não encontrado:

• Anote: "Perfil do cliente não encontrado - pode ser prospect ou primeiro atendimento"
• Continue a investigação

Etapa 3: Pesquisar Base de Conhecimento

Investigações similares:

Grep pattern="<issue_keywords>" glob="investigations/**/*.md" output_mode="content" -C 3

Melhores práticas relacionadas:

Grep pattern="<issue_keywords>" glob="best-practices/**/*.md" output_mode="content" -C 2

Para cada resultado:

• Anote o caminho do arquivo, data (do nome do arquivo, se for investigação) e descobertas principais
• Identifique se é correspondência exata ou padrão similar
• Extraia soluções ou workarounds

Etapa 4: Verificar Documentação

Grep pattern="<issue_keywords>" path="repositories/docs/" output_mode="content" -C 2

Determine:

• Esse comportamento é documentado?
• Existem opções de configuração ou limitações conhecidas?
• A documentação corresponde à expectativa do cliente?

Etapa 5: Verificar no Código do Produto

Grep pattern="<relevant_class_or_method>" path="repositories/rundeckpro/" output_mode="content" head_limit=50

Procure por:

• Comportamento real da implementação
• Valores padrão ou constantes
• Fontes de mensagens de erro
• Lógica específica de versão

Etapa 6: Verificar Rastreadores Externos

Issues da comunidade GitHub (via conector Runlayer):

Consulte o GitHub através do conector Runlayer. Chame search_tools para localizar a ferramenta de busca de issues no GitHub, depois execute_tool para pesquisar em rundeck/rundeck e rundeckpro/rundeckpro por <issue_keywords> em issues abertas e fechadas (limite ~10 cada). Não use shell com gh.

Rastreamento de desenvolvimento Jira (via conector Runlayer):

Consulte o Jira através do conector Runlayer. Chame search_tools para localizar a ferramenta de busca de issues no Jira, depois execute_tool com o nome exato da ferramenta e argumentos retornados para pesquisar o projeto RUN por <issue_keywords> ordenado por data de atualização (JQL equivalente: project=RUN AND text~"<issue_keywords>" ORDER BY updated DESC). Não chame ferramentas mcp__atlassian__* diretamente.

Para cada resultado relevante:

• Anote o número da issue, status e resumo
• Verifique se foi corrigido em uma versão específica
• Anote quaisquer workarounds mencionados

Etapa 7: Recomendar Ambiente de Teste

Faça isso apenas se ambientes sandbox estiverem disponíveis. Caso contrário, anote: "Nenhum ambiente sandbox disponível - recomende WAR local para reprodução rápida". Com base nas características do problema, recomende sandbox:

Lógica de decisão: Analise os ambientes sandbox disponíveis e sugira o mais apropriado. Referência: Read .claude/memory/sandbox-environments.md para detalhes de conexão, se necessário Não se conecte ao sandbox dentro deste skill - apenas forneça a recomendação.

Etapa 8: Gerar Resumo Estruturado

Forneça as descobertas neste formato:

# Resumo da Investigação: <customer_name> - <issue_description>

## Contexto do Cliente
- **Perfil:** [encontrado/não encontrado]
- **Ambiente:** [cloud/on-prem, versão, escala]
- **Problemas Passados:** [histórico relevante, se houver]

## Descobertas da Base de Conhecimento

### Investigações Similares
- [investigation-file.md](path) - <breve resumo>
- [Status: resolvido/workaround/aberto]

### Melhores Práticas Relevantes
- [best-practice-file.md](path) - <breve resumo>

## Status da Documentação
- **Documentado:** [Sim/Não/Parcial]
- **Referências:** [caminhos dos arquivos com números de linha]
- **Detalhes Principais:** [configuração relevante, limitações ou orientação]

## Análise de Código
- **Componente:** [nomes de classe/método]
- **Comportamento:** [comportamento real da implementação]
- **Fonte:** [caminho_do_arquivo:número_da_linha]

## Status dos Rastreadores Externos

### Issues GitHub
- rundeck/rundeck#<número> - <resumo> [status]
- rundeckpro/rundeckpro#<número> - <resumo> [status]

### Issues Jira
- RUN-<número> - <resumo> [status, versão da correção, se aplicável]

## Ambiente de Teste Recomendado
**Ambiente:** [AWS EKS / AWS EC2 / WAR Local / PDT-RDTAM]
**Motivo:** [tipo de banco de dados / especificidades do problema / necessidades de teste]
**Conexão:** Veja .claude/memory/sandbox-environments.md

## Próximos Passos
1. [Ação imediata]
2. [Recomendação de teste]
3. [Orientação de comunicação com o cliente]

## Recursos Relacionados
- Perfil do cliente: [caminho, se existir]
- Investigações: [lista de arquivos relacionados]
- Melhores práticas: [lista de guias aplicáveis]
- Documentação: [páginas-chave da documentação]

Diretrizes de Qualidade

Seja completo, mas conciso:

• Não inclua todos os resultados de pesquisa — priorize descobertas relevantes
• Cite caminhos de arquivos para todas as referências (ex.: investigations/2026-03-15-issue.md:45)
• Marque claramente o que é desconhecido ("Nenhum caso similar encontrado" em vez de afirmações vagas)

Forneça insights acionáveis:

• Não apenas liste as descobertas — sintetize padrões
• Se várias investigações mostram a mesma solução, destaque isso
• Se a documentação conflitar com o código, sinalize explicitamente

Considere o contexto do cliente:

• Adapte as recomendações ao ambiente do cliente (cloud vs on-prem, versão)
• Faça referência a problemas passados se houver padrões relevantes
• Ajuste a recomendação de ambiente de teste para corresponder à configuração deles

Tratamento de Erros

Se o cliente não for encontrado:

• Continue a investigação sem contexto do cliente
• Anote: "Recomende criar perfil do cliente se for um atendimento recorrente"

Se não houver resultados na base de conhecimento:

• Tente termos de busca mais amplos
• Anote: "Problema novo — considere documentar como investigação após a resolução"

Se os rastreadores externos estiverem indisponíveis:

• Anote a falha da ferramenta
• Continue com as informações disponíveis
• Sugira verificação manual: "Falha na pesquisa do GitHub — verifique manualmente as issues de rundeck/rundeck"

Se a descrição do problema for ambígua:

• Faça o melhor esforço com as palavras-chave disponíveis
• Anote: "Descrição do problema ambígua — a busca cobriu: [lista de termos usados]"
• Sugira: "Refine a busca com mensagens de erro específicas ou nomes de componentes"

Etapa 9: Documentar a Investigação

Após concluir a investigação e apresentar o resumo, crie um novo arquivo de investigação para documentar as descobertas:

Criação do arquivo:

investigations/YYYY-MM-DD-descrição-breve-em-kebab-case.md

Use o template: Read investigations/TEMPLATE.md para a estrutura

Preencha com:

• Título: Breve descrição do problema
• Data: Data de hoje (formato AAAA-MM-DD)
• Cliente: Nome do cliente da investigação
• Área do Produto: Componente relevante (webhooks, jobs, nodes, etc.)
• Tags: Descobertas de investigações similares, mais tags específicas do problema
• Declaração do Problema: Descrição do problema fornecida pelo usuário
• Detalhes do Ambiente: Do perfil do cliente (se encontrado)
• Etapas da Investigação: Resumo das etapas de busca realizadas
• Causa Raiz: Se identificada durante a investigação
• Solução/Resolução: Se encontrada na base de conhecimento ou documentação
• Documentação Relacionada: Referências descobertas durante a busca
• Referências de Código/Documentação: Caminhos dos arquivos com números de linha dos resultados da busca
• Notas/Aprendizados: Quaisquer padrões ou insights da investigação

Após criar o arquivo:

1. Atualize investigations/INDEX.md com a nova entrada:
   • Adicione à seção de categoria apropriada
   • Adicione à tabela cronológica
   • Adicione tags à seção "Pesquisa Rápida por Tag"
   • Atualize a data de "Última Atualização"

Notas

• A investigação cria um registro permanente na base de conhecimento
• Tempo médio de execução: 30-60 segundos para busca + 2-3 minutos para documentação
• Todas as descobertas são pesquisa — testes reais ainda são necessários no ambiente recomendado
• Para aconselhamento de posicionamento estratégico, invoque separadamente Read .claude/memory/tam-advisory-philosophy.md
• A documentação garante que o conhecimento seja capturado e pesquisável para investigações futuras