Pesquisa fontes tecnicas, evidencia e alternativas antes de implementar. Trigger em: "pesquisa tecnica", "levanta informacao", "coleta docs", "busca referencias", "preciso de fontes", "research antes de escrever", "levanta o que existe sobre", "benchmark de solucoes", "o que existe sobre X", "quero entender o estado da arte", "compara abordagens", "levanta referencias", "faz um research de", "coleta fontes sobre", "pesquisa sobre", "quero saber o que existe de", "monta um dossie tecnico", "background tecnico", "due diligence tecnica", "levantamento de alternativas".
79%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
Fix and improve this skill with Tessl
tessl review fix ./skills/48-research-prep/SKILL.mdPrincípio: Escrever sem pesquisar é opinar sem evidência. Esta skill coleta, ranqueia e estrutura fontes antes que qualquer skill de produção (docs, PRD, blog, prompt) comece a redigir. Baseada em padrões de addozhang/openclaw-forge (MIT). O ledger de evidências/claims e o gate de verificação de citação (Fase 3.5) foram adaptados de 199-biotechnologies/claude-deep-research-skill. O Pre-Flight de qualidade de query (Fase 1.5) e o modo de scoring por engajamento (Fase 3) foram adaptados de mvanhorn/last30days-skill.
memory/research/<slug>.md com menos de 7 dias (verificar cache)| Skill | Foco | Output |
|---|---|---|
| 18 (repo-auditor) | Stack e frameworks do projeto atual | docs/repo-audit/current.md |
| 29 (design-intelligence) | Benchmark competitivo de produto/UX | Dossier estratégico |
| 33 (detective-spec) | Regras de negócio em código legado | _detective_sdd/ |
| 48 (research-prep) | Fontes técnicas externas ranqueadas | memory/research/<slug>.md |
Esta skill segue GLOBAL.md, policies/token-efficiency.md, policies/source-driven.md,
policies/persistence.md, policies/handoffs.md.
# Verificar se pesquisa recente já existe
ls memory/research/ 2>/dev/null
# Se existir <slug>.md com menos de 7 dias → reportar ao usuário e perguntar se quer re-pesquisarSe cache válido (<7 dias), pular para Fase 4 diretamente.
Antes de pesquisar, definir:
--depth quick (padrão): 30-45 min — docs oficiais + 2-3 repos + top SO threads--depth deep: 60-90 min — fontes primárias + comparativos + papers + blogs de referênciamemory/research/ (ex: opentelemetry-node, pgvector-vs-pinecone)Se o usuário não especificou profundidade, assumir quick.
Antes de gastar tempo de busca, checar se o tópico tem risco alto de research raso:
low de antemão, e priorizar fonte oficial e changelog.site:github.com, nome de API específica).Se qualquer sinal acima disparar, ajustar a query ou o escopo antes da Fase 2, não depois de já ter gasto o orçamento de busca.
Executar em paralelo quando possível. Adaptar as queries ao tópico.
Buscar usando operador site: para garantir fontes primárias:
site:docs.<tecnologia>.io <tópico>
site:developer.<tecnologia>.com <tópico>
site:github.com/<org>/<repo> <tópico>Ler páginas de:
# Repos com mais stars sobre o tópico
gh search repos "<topico>" --sort stars --limit 10 --json name,description,stargazerCount,url
# Issues abertas relevantes (bugs conhecidos, limitações)
gh search issues "<topico> <problema>" --limit 5 --json title,url,bodyVerificar:
bug ou limitation (problemas reais de produção)Buscar threads com alto score sobre o tópico:
site:stackoverflow.com "<topico>" <aspecto-especifico>Filtros úteis: is:answer score:10 para respostas consolidadas pela comunidade.
Focar em:
--depth deep)Fontes adicionais:
site:arxiv.org <topico> para tecnologias com base acadêmicasite:news.ycombinator.com <topico> para discussões técnicas densasPara cada fonte coletada, calcular score de autoridade (0-10):
| Dimensão | Peso | Critérios |
|---|---|---|
| Fonte oficial | 40% | Docs do mantenedor, repo oficial, RFC/spec = 10; blog terceiro = 5; anônimo = 0 |
| Recência | 30% | <3 meses = 10; <1 ano = 7; <3 anos = 4; >3 anos = 1 |
| Profundidade | 20% | Exemplo completo + explicação = 10; só conceito = 5; superficial = 2 |
| Comunidade | 10% | >1000 stars/votos = 10; >100 = 7; >10 = 4; <10 = 1 |
Score final = (oficial×0.4) + (recência×0.3) + (profundidade×0.2) + (comunidade×0.1)
Descartar fontes com score < 4.0. Ranquear as demais.
Checkpoint: se restarem menos de 3 fontes acima de 4.0, isso é sinal de que a Fase 2 coletou pouco ou de baixa qualidade — voltar e ampliar a busca (mais termos, mais site:) antes de aceitar um research raso. Não afrouxar o threshold de 4.0 pra "ter fonte suficiente" — a régua existe pra filtrar ruído, não pra ser contornada quando incomoda.
O Authority Scoring acima ranqueia por autoridade oficial — o eixo certo para "qual é a forma correta de usar essa API". Para perguntas sobre percepção recente ou sentimento da comunidade ("o que devs estão achando de X", "essa lib está sendo abandonada?", "qual a reação ao release Y"), autoridade oficial é o eixo errado — o fabricante nunca vai dizer que o próprio produto está com problema.
Usar este modo alternativo quando o tópico pedir sentimento/recência em vez de correção técnica:
| Dimensão | Peso | Critérios |
|---|---|---|
| Engajamento recente | 50% | Discussão com atividade nos últimos 30 dias = 10; últimos 6 meses = 5; mais antigo = 1 |
| Volume de reação | 30% | Muitos upvotes/comentários/reações = 10; moderado = 5; isolado = 1 |
| Diversidade de fonte | 20% | Mesmo ponto aparece em 3+ threads/plataformas independentes = 10; só 1 fonte = 2 |
Não misturar os dois scores no mesmo relatório — declarar no frontmatter do output qual modo foi usado (scoring_mode: authority|engagement), porque mudam o que "fonte boa" significa.
Antes de escrever o output final, montar um ledger que separa claim de evidência de fonte — isso é o que permite auditar depois se uma afirmação do research realmente veio de algum lugar, em vez de ter sido sintetizada com confiança excessiva.
Persistir em memory/research/<slug>.evidence.jsonl (uma linha por entrada, append-only):
{"type": "source", "id": "s1", "url": "https://docs.exemplo.com/api", "title": "...", "score": 8.5}
{"type": "evidence", "id": "e1", "source_id": "s1", "quote": "trecho exato citado", "locator": "seção 'Rate Limits'"}
{"type": "claim", "id": "c1", "text": "a API limita 100 req/min por padrão", "evidence_ids": ["e1"], "status": "supported"}Gate de verificação antes de aceitar uma claim como supported:
quote) existe literalmente na fonte, não é paráfrase apresentada como citação diretaevidence_ids correspondente não pode ir para o output final como afirmação categórica — vira status: unsupported e entra em "Gaps Identificados", não em "Recomendação"Esse ledger é o que sustenta a seção ## Fontes Ranqueadas do output — cada trecho citado ali deve rastrear de volta a uma entrada evidence real neste arquivo.
Salvar em memory/research/<slug>.md:
---
topic: <tópico>
slug: <slug>
researched_at: YYYY-MM-DD
depth: quick|deep
scoring_mode: authority|engagement
confidence: high|medium|low
sources_collected: N
sources_kept: M (score >= 4.0)
evidence_ledger: memory/research/<slug>.evidence.jsonl
---
# Research: <Tópico>
> Gerado por skill 48 (research-prep). Re-pesquisar com `--update` após 7 dias.
## TL;DR (3-5 bullets)
- <achado mais importante>
- <segundo mais importante>
- <terceiro>
- <limitação principal>
- <recomendação de abordagem>
## Fontes Ranqueadas
### [Score: X.X] <Título da Fonte>
**URL:** <url>
**Tipo:** Documentação oficial | GitHub repo | SO thread | Blog | Paper
**Data:** <data ou estimativa>
**Resumo:** <2-3 frases do que esta fonte cobre>
**Trecho relevante:**
> "<citação direta ou parafraseada do ponto mais importante>"
**Gotchas / Limitações mencionados:**
- <se houver>
---
### [Score: X.X] <Segunda fonte>
... (repetir para top 5-8 fontes)
## Comparativo de Abordagens (se aplicável)
| Abordagem | Prós | Contras | Quando usar |
|-----------|------|---------|-------------|
| <A> | | | |
| <B> | | | |
## Gaps Identificados
Temas relevantes que não encontraram fontes de qualidade:
- <gap 1 — marcar como confidence: low>
## Recomendação
<1 parágrafo com recomendação baseada nas fontes. Sempre ancorada em evidência — citar fonte específica.>Nível de confiança:
high: fontes primárias recentes, consenso claro entre fontesmedium: fontes mistas, alguma contradição ou desatualizaçãolow: poucas fontes, tópico muito novo ou muito nichoAo final, reportar:
Research Prep — <tópico>
Fontes coletadas: N | Fontes mantidas (score ≥4.0): M
Profundidade: quick|deep
Confiança: high|medium|low
Salvo em: memory/research/<slug>.md
Top 3 achados:
1. <mais importante>
2. <segundo>
3. <terceiro>
Próximo passo sugerido: skill 10 (documenter) | skill 01 (po-feature-spec) | skill 41 (blog-publisher)memory/research/<slug>.md como fonte de verdade para documentação técnicasource-driven.md)supported sem checar o quote contra o texto real da fonte — paráfrase apresentada como citação direta é o erro mais comum do ledgerfelvieira/claude-skills-fv
449fb53
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.