Fil de Jeffrey Emanuel (@doodlestein)

En fait, j'aime bien la première proposition aussi, je vais inclure les deux dans mon fichier AGENTS.md : --- ### Morph Warp Grep — Recherche de code basée sur l'IA **Utilisez `mcp__morph-mcp__warp_grep` pour les questions exploratoires du type « comment fonctionne X ? ».** Un agent de recherche IA développe automatiquement votre requête en plusieurs modèles de recherche, effectue une recherche dans le code source, lit les fichiers pertinents et renvoie des plages de lignes précises avec un contexte complet, le tout en un seul appel. **Utilisez `ripgrep` (via l'outil Grep) pour des recherches ciblées.** Lorsque vous savez exactement ce que vous recherchez (un nom de fonction spécifique, un message d'erreur ou une clé de configuration), ripgrep est plus rapide et plus direct. **Utilisez `ast-grep` pour les modèles de code structurels.** Lorsque vous devez faire correspondre/réécrire des nœuds AST tout en ignorant les commentaires/chaînes de caractères, ou appliquer des règles à l'échelle du code. **Quand utiliser quoi** | Scénario | Outil | Pourquoi | |----------|------|-----| | « Comment l'authentification est-elle implémentée ? » | `warp_grep` | Exploratoire ; je ne sais pas par où commencer | | « Où se trouve le système d'appel L3 Guardian ? » | `warp_grep` | Besoin de comprendre l'architecture, trouver plusieurs fichiers liés | | "Trouver toutes les occurrences de `useQuery(`" | `ripgrep` | Recherche littérale ciblée | | "Trouver des fichiers avec `console.log`" | `ripgrep` | Modèle simple, cible connue | | "Renommer `getUserById` → `fetchUser`" | `ast-grep` | Refactorisation structurelle, éviter les commentaires/chaînes de caractères | | "Remplacer tous les `var` par `let`" | `ast-grep` | Modification du code source | **Points forts de warp_grep** * **Réduit la pollution du contexte** : ne renvoie que les plages de lignes pertinentes, et non les fichiers entiers. * **Extension intelligente** : Transforme « système d'appel » en recherches pour `appel`, `Appels`, `gardien`, `L3`, etc. * **Réponses instantanées** : Trouve les 3 à 5 fichiers les plus pertinents avec des emplacements précis, contrairement aux cycles manuels grep→lecture. * **Langage naturel** : Fonctionne bien avec les questions commençant par « comment », « où », « quoi ». **Utilisation de warp_grep** ``` mcp__morph-mcp__warp_grep( repoPath: "/data/projects/communitai", Question : « Comment le système d'appel L3 Guardian est-il mis en œuvre ? » ) ``` Renvoie des résultats structurés avec les chemins d'accès aux fichiers, les plages de lignes et les extraits de code. **Règle générale** * **Vous ne savez pas où chercher ?** → `warp_grep` (laisser l'IA trouver) * **Connaître le modèle** → `ripgrep` (le plus rapide) * **Besoin de précision AST** → `ast-grep` (le plus sûr pour les réécritures) **Motifs anti-** * ❌ Utiliser `warp_grep` pour trouver un nom de fonction spécifique que vous connaissez déjà → utilisez `ripgrep` * ❌ Utiliser `ripgrep` pour comprendre « comment fonctionne X » → est une perte de temps due à la lecture manuelle des fichiers * ❌ L'utilisation de `ripgrep` pour les modifications de code → risque de manquer des commentaires/chaînes de caractères et d'entraîner des modifications collatérales