/search-first — Pesquise Antes de Codificar
Sistematiza o fluxo de trabalho "pesquisar soluções existentes antes de implementar".
Gatilho
Use esta skill quando:
- Iniciar uma nova funcionalidade que provavelmente tem soluções existentes
- Adicionar uma dependência ou integração
- O usuário pedir "adicione a funcionalidade X" e você estiver prestes a escrever código
- Antes de criar uma nova utilidade, helper ou abstração
Fluxo de Trabalho
┌─────────────────────────────────────────────┐
│ 0. VERIFICAÇÃO PRÉVIA DE DISPONIBILIDADE │
│ DE FERRAMENTAS │
│ Verifique canais de busca antes de │
│ confiar neles; relate canais ignorados │
│ honestamente │
├─────────────────────────────────────────────┤
│ 1. ANÁLISE DE NECESSIDADES │
│ Defina qual funcionalidade é necessária │
│ Identifique restrições de lingua/framework │
├─────────────────────────────────────────────┤
│ 2. BUSCA PARALELA (agente pesquisador) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ npm / │ │ MCP / │ │ GitHub / │ │
│ │ PyPI │ │ Skills │ │ Web │ │
│ └──────────┘ └──────────┘ └──────────┘ │
├─────────────────────────────────────────────┤
│ 3. AVALIAR │
│ Pontue candidatos (funcionalidade, │
│ manutenção, comunidade, docs, licença, │
│ dependências) │
├─────────────────────────────────────────────┤
│ 4. DECIDIR │
│ ┌─────────┐ ┌──────────┐ ┌─────────┐ │
│ │ Adotar │ │ Estender │ │ Construir│
│ │ tal qual│ │ /Wrap │ │ Custom │ │
│ └─────────┘ └──────────┘ └─────────┘ │
├─────────────────────────────────────────────┤
│ 5. IMPLEMENTAR │
│ Instale pacote / Configure MCP / │
│ Escreva código customizado mínimo │
└─────────────────────────────────────────────┘
Matriz de Decisão
| Sinal | Ação |
|---|---|
| Correspondência exata, bem mantido, MIT/Apache | Adotar — instalar e usar diretamente |
| Correspondência parcial, boa base | Estender — instalar + escrever wrapper fino |
| Várias correspondências fracas | Compor — combinar 2-3 pacotes pequenos |
| Nada adequado encontrado | Construir — escrever customizado, mas informado pela pesquisa |
Como Usar
Etapa 0: Verificação Prévia de Disponibilidade de Ferramentas
Isso é orientação para o agente, não um script de configuração executável. Verifique apenas os canais que são relevantes para a tarefa e o projeto à sua frente.
| Canal | Verificação | Se ausente |
|---|---|---|
| Pesquisa no repositório | rg --files e consultas rg direcionadas | Informe que apenas os arquivos visíveis foram inspecionados |
| Registro de pacotes | npm --version, python -m pip --version, ou gerenciador de pacotes do projeto | Use busca na web/documentação e evite afirmar cobertura do registro |
| GitHub CLI | gh auth status | Use apenas web pública ou histórico git local |
| Ferramentas MCP/docs | Lista de ferramentas disponíveis ou configuração MCP local | Recorra a docs oficiais/pesquisa web |
| Diretório de skills | ls ~/.claude/skills ~/.codex/skills quando aplicável | Informe que nenhum catálogo local de skills estava disponível |
Modo Rápido (inline)
Antes de escrever uma utilidade ou adicionar funcionalidade, percorra mentalmente:
- Isso já existe no repositório? →
rgpelos módulos/testes relevantes primeiro - Isso é um problema comum? → Busque no npm/PyPI
- Existe um MCP para isso? → Verifique
~/.claude/settings.jsone busque - Existe uma skill para isso? → Verifique
~/.claude/skills/ - Existe uma implementação/template no GitHub? → Execute busca de código no GitHub por OSS mantido antes de escrever código novo
Modo Completo (agente)
Para funcionalidades não triviais, inicie o agente pesquisador:
Agent(subagent_type="general-purpose", prompt="
Pesquise ferramentas existentes para: [DESCRIÇÃO]
Linguagem/framework: [LINGUA]
Restrições: [QUALQUER]
Busque: npm/PyPI, servidores MCP, skills Claude Code, GitHub
Retorne: Comparação estruturada com recomendação
")
Documentação mais antiga do Claude Code pode chamar isso de Task(...); use o nome da ferramenta
agent/subagent atual exposta pelo harness ativo.
Atalhos de Busca por Categoria
Ferramentas de Desenvolvimento
- Linting →
eslint,ruff,textlint,markdownlint - Formatação →
prettier,black,gofmt - Testes →
jest,pytest,go test - Pré-commit →
husky,lint-staged,pre-commit
Integração com IA/LLM
- SDK Claude → Context7 para docs mais recentes
- Gerenciamento de prompts → Verifique servidores MCP
- Processamento de documentos →
unstructured,pdfplumber,mammoth
Dados & APIs
- Clientes HTTP →
httpx(Python),ky/undici(Node) - Validação →
zod(TS),pydantic(Python) - Banco de dados → Verifique servidores MCP primeiro
Conteúdo e Publicação
- Processamento Markdown →
remark,unified,markdown-it - Otimização de imagens →
sharp,imagemin
Pontos de Integração
Com agente planejador
O planejador deve invocar o pesquisador antes da Fase 1 (Revisão de Arquitetura):
- Pesquisador identifica ferramentas disponíveis
- Planejador as incorpora no plano de implementação
- Evita "reinventar a roda" no plano
Com agente arquiteto
O arquiteto deve consultar o pesquisador para:
- Decisões sobre pilha tecnológica
- Descoberta de padrões de integração
- Arquiteturas de referência existentes
Com skill iterative-retrieval
Combine para descoberta progressiva:
- Ciclo 1: Busca ampla (npm, PyPI, MCP)
- Ciclo 2: Avalie os principais candidatos em detalhes
- Ciclo 3: Teste compatibilidade com restrições do projeto
Exemplos
Exemplo 1: "Adicionar verificação de links quebrados"
Necessidade: Verificar arquivos markdown para links quebrados
Busca: npm "markdown dead link checker"
Encontrado: textlint-rule-no-dead-link (pontuação: 9/10)
Ação: ADOTAR — npm install textlint-rule-no-dead-link
Resultado: Zero código customizado, solução testada em batalha
Exemplo 2: "Adicionar wrapper de cliente HTTP"
Necessidade: Cliente HTTP resiliente com retentativas e gerenciamento de timeout
Busca: npm "http client retry", PyPI "httpx retry"
Encontrado: got (Node) com plugin de retry, httpx (Python) com retry embutido
Ação: ADOTAR — usar got/httpx diretamente com configuração de retry
Resultado: Zero código customizado, bibliotecas testadas em produção
Exemplo 3: "Adicionar linter de arquivos de configuração"
Necessidade: Validar arquivos de configuração do projeto contra um esquema
Busca: npm "config linter schema", "json schema validator cli"
Encontrado: ajv-cli (pontuação: 8/10)
Ação: ADOTAR + ESTENDER — instalar ajv-cli, escrever esquema específico do projeto
Resultado: 1 pacote + 1 arquivo de esquema, nenhuma lógica de validação customizada
Anti-Padrões
- Pular para o código: Escrever uma utilidade sem verificar se uma existe
- Ignorar MCP: Não verificar se um servidor MCP já fornece a capacidade
- Ignorar silenciosamente: Relatar "nada encontrado" quando um canal de busca estava indisponível
- Superpersonalizar: Envolver uma biblioteca tão fortemente que perde seus benefícios
- Inchaço de dependências: Instalar um pacote enorme para um recurso pequeno