Agent skill

Pesquisa

Fase 1 - Research Protocol. Busca autonoma no codebase, consulta MCPs, mapeia arquivos e gera PRD.md. Aplica S.A.I.S (Solicitar + Analisar) e S.D.A inicial. NUNCA pergunta onde estao arquivos, sempre busca automaticamente.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/pesquisa

SKILL.md

FASE 1: PESQUISA (RESEARCH PROTOCOL)

Objetivo

Entender completamente o contexto da tarefa atraves de busca autonoma, sem perguntas sobre localizacao de arquivos.

REGRA DE OURO: AUTONOMIA TOTAL

NUNCA PERGUNTE:

  • "Onde esta o modulo X?"
  • "Em qual pasta fica o controller Y?"
  • "Pode me mostrar a estrutura de Z?"
  • "Qual arquivo contem a funcao W?"

SEMPRE BUSQUE:

bash
# Mapear estrutura geral
ls -la /home/runner/workspace

# Encontrar arquivos por nome
find . -name "*mataMata*" -type f

# Buscar por conteudo
grep -r "calcularSaldo" controllers/ routes/ services/

# Localizar padroes
grep -rn "app.post.*acerto" routes/

# Listar controllers
ls -la controllers/

# Ver imports de um modulo
grep -n "require\|import" public/js/fluxo-financeiro/core.js

PROTOCOLO DE EXECUCAO

PASSO 1: Compreender Requisito

Input do usuario: [descricao da funcionalidade]

Perguntas validas (APENAS NEGOCIO):

  • "Quais regras de negocio especificas?"
  • "Isso se aplica a todas as ligas ou e configuravel?"
  • "Qual comportamento esperado em caso de erro?"

Perguntas PROIBIDAS:

  • Localizacao de arquivos
  • Estrutura de pastas
  • Onde encontrar codigo

PASSO 2: Mapear Contexto Automaticamente

2.1 Identificar Modulo/Feature

bash
# Buscar por palavras-chave da funcionalidade
grep -ri "[palavra-chave]" . --include="*.js" --include="*.html" | head -20

2.2 Localizar Arquivos Backend

bash
# Controllers relacionados
find controllers/ -name "*[palavra-chave]*"

# Models envolvidos
find models/ -name "*[palavra-chave]*"

# Routes afetadas
grep -rn "router\." routes/ | grep -i "[palavra-chave]"

# Services externos
find services/ -name "*.js" -exec grep -l "[palavra-chave]" {} \;

2.3 Localizar Arquivos Frontend

bash
# Modulos JS
find public/js -name "*[palavra-chave]*"
find public/participante/js/modules -name "*.js"

# Fragmentos HTML
find public/participante/fronts -name "*.html"

# CSS relacionado
grep -rn "[palavra-chave]" public/css/ public/participante/css/

PASSO 3: Consultar Documentacao (MCP)

Quando Usar Context7 MCP

  • Frameworks/libs oficiais (Express, Mongoose, Socket.io)
  • Documentacao tecnica atualizada

Quando Usar Perplexity MCP

  • APIs nao-documentadas (API Cartola FC)
  • Bibliotecas brasileiras/nicho
  • Noticias/eventos recentes

PASSO 4: Ler Principios do Projeto

bash
# OBRIGATORIO: Ler CLAUDE.md para contexto geral
cat CLAUDE.md

PASSO 5: Aplicar S.A.I.S (Solicitar + Analisar)

5.1 SOLICITAR arquivos identificados

  • Ver arquivos completos (nao apenas snippets)
  • Priorizar: Controllers > Routes > Models > Frontend

5.2 ANALISAR linha por linha

  • Entender fluxo de dados
  • Identificar funcoes principais
  • Mapear dependencias entre arquivos
  • Verificar padroes de codigo

PASSO 6: Mapear Dependencias (S.D.A Inicial)

bash
# Quem importa este arquivo?
grep -r "require.*[nome-arquivo]" . --include="*.js"
grep -r "import.*[nome-arquivo]" . --include="*.js"

# Quais IDs/classes sao usados?
grep -r "#[id-elemento]\|.[classe-css]" . --include="*.html" --include="*.js"

GERAR PRD.md

Estrutura Obrigatoria

markdown
# PRD - [Nome da Funcionalidade]

**Data:** [data atual]
**Autor:** Claude (Pesquisa Protocol)
**Status:** Draft

---

## Resumo Executivo
[1-2 paragrafos explicando O QUE precisa ser feito e POR QUE]

---

## Contexto e Analise

### Modulos Identificados
- **Backend:**
  - `controllers/[arquivo].js` - [Descricao]
  - `models/[arquivo].js` - [Estrutura de dados]
  - `routes/[arquivo].js` - [Endpoints]

- **Frontend:**
  - `public/js/[modulo]/[arquivo].js` - [Logica cliente]
  - `public/participante/fronts/[arquivo].html` - [Template]

### Dependencias Mapeadas
- [Arquivo A] importa [Arquivo B]
- [Funcao X] e usada por [Arquivo C, D]

### Padroes Existentes
- Similar a: [feature existente]
- Pode reutilizar: [componente/funcao]

---

## Solucao Proposta

### Abordagem Escolhida
[Explicar COMO resolver]

### Arquivos a Criar
1. `[path/novo-arquivo.js]` - [Proposito]

### Arquivos a Modificar
1. `[path/arquivo-existente.js]` - [O que mudar]

### Regras de Negocio
- [Regra 1]: [Descricao]
- [Regra 2]: [Descricao]

---

## Riscos e Consideracoes

### Impactos Previstos
- Positivo: [Beneficio]
- Atencao: [Ponto de cuidado]
- Risco: [Possivel problema]

### Multi-Tenant
- [ ] Validado isolamento liga_id

---

## Testes Necessarios

### Cenarios de Teste
1. [Cenario positivo]
2. [Cenario negativo]
3. [Edge case]

---

## Proximos Passos

1. Validar PRD
2. Gerar Spec: Executar `/spec` com este PRD
3. Implementar: Executar `/code` com Spec gerado

---

**Gerado por:** Pesquisa Protocol v1.0

Onde Salvar

bash
# Sempre em .claude/docs/
path=".claude/docs/PRD-[nome-tarefa-kebab-case].md"

# Exemplo:
# .claude/docs/PRD-notificacoes-push.md
# .claude/docs/PRD-export-pdf-extrato.md

Checklist Final (Antes de Gerar PRD)

Pesquisa Completa

  • Busquei automaticamente todos os arquivos relacionados
  • Li arquivos principais completamente
  • Mapeei dependencias iniciais
  • Consultei MCPs quando necessario
  • Li CLAUDE.md do projeto

Solucao Clara

  • Entendi completamente o requisito
  • Proposta baseada em codigo existente
  • Reuso de patterns identificados
  • Riscos mapeados

PRD Estruturado

  • Todas as secoes preenchidas
  • Listas de arquivos precisas
  • Regras de negocio documentadas
  • Testes planejados

Proxima Acao

PRD gerado com sucesso!

LIMPAR CONTEXTO:
1. Feche esta conversa
2. Abra nova conversa
3. Execute: /spec .claude/docs/PRD-[nome].md

STATUS: PESQUISA PROTOCOL - AUTONOMOUS & THOROUGH Versao: 1.0 (High Senior Edition)

Didn't find tool you were looking for?

Be as detailed as possible for better results