/search-first — Pesquise Antes de Codificar

Sistematiza o fluxo de trabalho "pesquisar soluções existentes antes de implementar".

Gatilho

Use esta habilidade quando:

• Iniciar um novo recurso que provavelmente tenha soluções existentes
• Adicionar uma dependência ou integração
• O usuário perguntar "adicione funcionalidade X" e você estiver prestes a escrever código
• Antes de criar uma nova utilidade, helper ou abstração

Fluxo de Trabalho

┌─────────────────────────────────────────────┐
│  0. TOOL AVAILABILITY PREFLIGHT             │
│     Check search channels before relying on │
│     them; report skipped channels honestly   │
├─────────────────────────────────────────────┤
│  1. NEED ANALYSIS                           │
│     Define what functionality is needed      │
│     Identify language/framework constraints  │
├─────────────────────────────────────────────┤
│  2. PARALLEL SEARCH (researcher agent)      │
│     ┌──────────┐ ┌──────────┐ ┌──────────┐  │
│     │  npm /   │ │  MCP /   │ │  GitHub / │  │
│     │  PyPI    │ │  Skills  │ │  Web      │  │
│     └──────────┘ └──────────┘ └──────────┘  │
├─────────────────────────────────────────────┤
│  3. EVALUATE                                │
│     Score candidates (functionality, maint, │
│     community, docs, license, deps)         │
├─────────────────────────────────────────────┤
│  4. DECIDE                                  │
│     ┌─────────┐  ┌──────────┐  ┌─────────┐  │
│     │  Adopt  │  │  Extend  │  │  Build   │  │
│     │ as-is   │  │  /Wrap   │  │  Custom  │  │
│     └─────────┘  └──────────┘  └─────────┘  │
├─────────────────────────────────────────────┤
│  5. IMPLEMENT                               │
│     Install package / Configure MCP /       │
│     Write minimal custom code               │
└─────────────────────────────────────────────┘

Matriz de Decisão

Como Usar

Etapa 0: Verificação Prévia de Disponibilidade de Ferramentas

Este é um guia para o agente, não um script de configuração executável. Verifique apenas os canais relevantes para a tarefa e o projeto em questão.

Modo Rápido (inline)

Antes de escrever uma utilidade ou adicionar funcionalidade, pense mentalmente:

0. Isso já existe no repositório? → Pesquise rg em módulos/testes relevantes primeiro
1. Este é um problema comum? → Pesquise npm/PyPI
2. Existe um MCP para isso? → Verifique ~/.claude/settings.json e pesquise
3. Existe uma habilidade para isso? → Verifique ~/.claude/skills/
4. Existe uma implementação/template no GitHub? → Execute a pesquisa de código do GitHub para OSS mantido antes de escrever código totalmente novo

Modo Completo (agente)

Para funcionalidades não triviais, inicie o agente pesquisador:

Agent(subagent_type="general-purpose", prompt="
  Research existing tools for: [DESCRIPTION]
  Language/framework: [LANG]
  Constraints: [ANY]

  Search: npm/PyPI, MCP servers, Claude Code skills, GitHub
  Return: Structured comparison with recommendation
")

Documentos mais antigos do Claude Code podem chamar isso de Task(...); use o nome da ferramenta de agente/subagente atual exposto pelo harness ativo.

Atalhos de Pesquisa por Categoria

Ferramentas de Desenvolvimento

• Linting → eslint, ruff, textlint, markdownlint
• Formatação → prettier, black, gofmt
• Testes → jest, pytest, go test
• Pre-commit → husky, lint-staged, pre-commit

Integração AI/LLM

• Claude SDK → Context7 para a documentação mais recente
• Gerenciamento de prompts → Verifique os servidores MCP
• Processamento de documentos → unstructured, pdfplumber, mammoth

Dados e APIs

• Clientes HTTP → httpx (Python), ky/undici (Node)
• Validação → zod (TS), pydantic (Python)

…