Hilo de Jeffrey Emanuel (@doodlestein)

En realidad, también me gusta el primero que se me ocurrió, voy a incluir ambos en mi AGENTS dot md: --- ### Morph Warp Grep: búsqueda de código impulsada por IA **Utilice `mcp__morph-mcp__warp_grep` para preguntas exploratorias del tipo "¿cómo funciona X?".** Un agente de búsqueda de IA expande automáticamente su consulta en múltiples patrones de búsqueda, busca en el código base, lee archivos relevantes y devuelve rangos de líneas precisos con contexto completo, todo en una sola llamada. **Utilice `ripgrep` (a través de la herramienta Grep) para búsquedas específicas.** Cuando sabe exactamente lo que está buscando (un nombre de función específico, un mensaje de error o una clave de configuración), ripgrep es más rápido y más directo. **Utilice `ast-grep` para patrones de código estructural.** Cuando necesite hacer coincidir/reescribir nodos AST ignorando comentarios/cadenas, o aplicar reglas para toda la base de código. **Cuándo usar qué** | Escenario | Herramienta | Por qué | |----------|------|-----| | "¿Cómo se implementa la autenticación?" | `warp_grep` | Exploratorio; no sé por dónde empezar | | "¿Dónde está el sistema de apelaciones de L3 Guardian?" | `warp_grep` | Necesito comprender la arquitectura y encontrar varios archivos relacionados | | "Buscar todos los usos de `useQuery(`" | `ripgrep` | Búsqueda literal dirigida | | "Buscar archivos con `console.log`" | `ripgrep` | Patrón simple, objetivo conocido | | "Cambiar nombre `getUserById` → `fetchUser`" | `ast-grep` | Refactorización estructural, evitar comentarios/cadenas | | "Reemplazar todos los `var` con `let`" | `ast-grep` | Codemod en toda la base de código | **Fortalezas de warp_grep** * **Reduce la contaminación del contexto**: devuelve solo rangos de líneas relevantes, no archivos completos. * **Expansión inteligente**: Convierte el "sistema de apelaciones" en búsquedas de `apelación`, `Apelaciones`, `tutor`, `L3`, etc. * **Respuestas únicas**: encuentra los 3 a 5 archivos más relevantes con ubicaciones precisas frente a los ciclos manuales de grep→lectura. * **Lenguaje natural**: Funciona bien con preguntas de "cómo", "dónde", "qué". **Uso de warp_grep** ``` mcp__morph-mcp__warp_grep( repoPath: "/data/projects/communitai", Consulta: "¿Cómo se implementa el sistema de apelaciones de L3 Guardian?" ) ``` Devuelve resultados estructurados con rutas de archivos, rangos de líneas y fragmentos de código extraídos. **Regla general** * **No sé dónde buscar** → `warp_grep` (deja que la IA lo encuentre) * **Conoce el patrón** → `ripgrep` (más rápido) * **Necesita precisión AST** → `ast-grep` (más seguro para reescrituras) **Antipatrones** * ❌ Usar `warp_grep` para encontrar un nombre de función específico que ya conoce → usar `ripgrep` * ❌ Usar `ripgrep` para entender "cómo funciona X" → desperdicia tiempo con lecturas manuales de archivos * ❌ Usar `ripgrep` para mods de código → pierde comentarios/cadenas, corre el riesgo de realizar ediciones colaterales