Thread de Jeffrey Emanuel (@doodlestein)

Na verdade, eu também gostei da primeira que apareceu, vou incluir as duas no meu AGENTS dot md: --- ### Morph Warp Grep — Busca de código com inteligência artificial **Use `mcp__morph-mcp__warp_grep` para perguntas exploratórias do tipo "como X funciona?".** Um agente de busca com IA expande automaticamente sua consulta em múltiplos padrões de busca, examina o código-fonte, lê arquivos relevantes e retorna intervalos de linhas precisos com contexto completo — tudo em uma única chamada. **Use o `ripgrep` (através da ferramenta Grep) para pesquisas direcionadas.** Quando você sabe exatamente o que está procurando — um nome de função específico, uma mensagem de erro ou uma chave de configuração — o ripgrep é mais rápido e direto. **Use `ast-grep` para padrões de código estrutural.** Quando você precisar encontrar/reescrever nós da AST ignorando comentários/strings, ou aplicar regras em toda a base de código. **Quando usar cada item** | Cenário | Ferramenta | Porquê | |----------|------|-----| | "Como a autenticação é implementada?" | `warp_grep` | Exploratório; não sei por onde começar | | "Onde está o sistema de apelações do L3 Guardian?" | `warp_grep` | Preciso entender a arquitetura, encontrar vários arquivos relacionados | | "Encontrar todos os usos de `useQuery(`" | `ripgrep` | Busca literal direcionada | | "Encontre arquivos com `console.log`" | `ripgrep` | Padrão simples, alvo conhecido | | "Renomear `getUserById` → `fetchUser`" | `ast-grep` | Refatoração estrutural, evitar comentários/strings | | "Substituir todos os `var` por `let`" | `ast-grep` | Modificação de código em toda a base de código | **forças do warp_grep** * **Reduz a poluição contextual**: Retorna apenas intervalos de linhas relevantes, não arquivos inteiros. * **Expansão inteligente**: Transforma "sistema de apelações" em buscas por `apelação`, `Apelações`, `tutor`, `L3`, etc. * **Respostas instantâneas**: Encontra de 3 a 5 arquivos mais relevantes com localizações precisas, em vez de ciclos manuais de grep → leitura. * **Linguagem natural**: Funciona bem com perguntas do tipo "como", "onde" e "o quê". **Uso do warp_grep** ``` mcp__morph-mcp__warp_grep( repoPath: "/data/projects/communitai", Pergunta: "Como é implementado o sistema de apelações do L3 Guardian?" ) ``` Retorna resultados estruturados com caminhos de arquivos, intervalos de linhas e trechos de código extraídos. **Regra geral** * **Não sabe onde procurar** → `warp_grep` (deixe a IA encontrar) * **Conheça o padrão** → `ripgrep` (mais rápido) * **Necessita de precisão da AST** → `ast-grep` (mais seguro para reescritas) **Antipadrões** * ❌ Usando `warp_grep` para encontrar um nome de função específico que você já conhece → use `ripgrep` * ❌ Usar `ripgrep` para entender "como X funciona" → desperdiça tempo com leituras manuais de arquivos * ❌ Usar `ripgrep` para modificações de código → ignora comentários/strings, aumentando o risco de edições colaterais