/search-first — Rechercher avant de coder
Avant d'écrire une nouvelle fonctionnalité, un outil utilitaire, une intégration ou de choisir une bibliothèque, recherchez d'abord une solution existante. Le meilleur code est celui que vous n'avez pas à écrire.
Cette compétence repose sur la discipline, pas sur le mécanisme. Le comment de la recherche — sous-agents parallèles, documentation en direct, requêtes de registre — appartient à votre harnais d'agent et change constamment. Ce que cette compétence fixe, c'est la partie qui survit à ces changements : articuler avant de chercher, chercher par priorité de source, et terminer par un verdict enregistré. Menez avec la discipline ; déléguez le mécanisme.
Étape 0 — Articuler le besoin (obligatoire, texte visible par l'utilisateur)
Avant tout appel d'outil ou sous-agent, écrivez 2–3 phrases de texte d'assistant en clair (pas enfoui dans les arguments d'un outil) indiquant :
- Quelle fonctionnalité est nécessaire — concrètement, pas « support X »
- Langage / framework que l'implémentation utilisera
- Contraintes — dépendances existantes, limites de performance, exigences de licence
Pourquoi : cela externalise la requête de recherche afin que l'utilisateur puisse rediriger avant que vous dépensiez des efforts, et cela laisse une trace vérifiable. Un appel de sous-agent dont les args portent le besoin ne satisfait pas cette étape — l'utilisateur lit le texte du chat, pas les arguments des outils. Émettez l'articulation d'abord en texte, puis appelez des outils dont les arguments peuvent le refléter.
Étape 1 — Rechercher par priorité de source
Vérifiez ces sources dans l'ordre ; arrêtez-vous tôt lorsque vous trouvez une correspondance solide :
- Ce dépôt —
rg/ grep dans les modules et tests pertinents. La chose existe peut-être déjà ici. - Registres de paquets — npm / PyPI / crates / modules Go pour le langage utilisé.
- Serveurs MCP — d'abord ceux déjà configurés, puis le registre. La capacité est peut-être déjà câblée.
- Compétences / agents / outils installés — votre harnais peut déjà la contenir.
- OSS maintenu / modèles — recherchez sur GitHub avant d'écrire du code neuf.
Interrogez la documentation en direct au moment de la décision (par ex. context7, ou le registre lui-même) plutôt que de vous fier à des informations mémorisées sur des paquets — les recommandations vieillissent.
Étape 2 — Décider et enregistrer un Verdict
Évaluez les candidats holistiquement : adéquation fonctionnelle, maintenance (dernier commit, réactivité aux problèmes), communauté, documentation, licence, empreinte des dépendances. Décrivez les forces et faiblesses en prose. N'attribuez pas de scores numériques (8/10), de notes alphabétiques ou de tableaux de points pondérés — ils fabriquent une fausse précision ; un verdict fondé sur des preuves est le résultat honnête.
| Verdict | Quand | Action |
|---|---|---|
| Adopter | Correspondance exacte, bien maintenu, licence permissive | Installer et utiliser directement |
| Étendre | Bonne base, adéquation partielle | Installer + fine couche / configuration |
| Composer | Plusieurs correspondances faibles | Combiner 2–3 petits paquets |
| Construire | Rien de convenable | Écrire du sur-mesure — mais éclairé par ce qui a été trouvé |
Terminez chaque passe par une ligne de verdict reconnaissable — cette ligne est le livrable :
Verdict: <Adopter|Étendre|Composer|Construire> — <paquet(s) ou "sur-mesure"> — <raison fondée sur des preuves>
Une recherche sans ligne de verdict est une passe incomplète : vous avez fait le travail mais n'avez laissé aucune décision sur laquelle l'utilisateur (ou l'étape suivante) peut agir — c'est l'échec le plus courant de ce flux. Appuyez la raison sur des preuves (étoiles, date du dernier commit, correspondance de fonctionnalité spécifique), jamais sur des adjectifs ("a l'air bien", "populaire").
Mode Rapide vs Mode Complet
- Mode Rapide (en ligne) — pour un besoin unique et évident : exécutez vous-même les étapes 0–2 avec quelques recherches et énoncez le verdict.
- Mode Complet (délégué) — pour des besoins non triviaux : après l'étape 0, confiez la revue à un sous-agent de recherche (selon ce que fournit votre harnais pour la découverte de solutions). Reproduisez l'articulation dans son invite et demandez-lui de renvoyer les candidats ainsi qu'un verdict au format ci-dessus. Réservez les recherches multi-sources lourdes pour les questions vraiment difficiles — trouver une bibliothèque est plus léger qu'un rapport de recherche.
Quand l'utilisateur dit « saute la recherche »
Si l'utilisateur vous demande de sauter la recherche (« implémente juste », « pas le temps », « utilise n'importe quoi »), enregistrez quand même la décision sous forme de ligne de verdict avant d'implémenter — sauter la recherche est lui-même une décision, donc il reçoit un verdict comme toute autre passe (cela garde le choix vérifiable et la fenêtre de correction ouverte) :
Je saute la recherche à votre demande — je n'ai pas vérifié s'il existe une bibliothèque existante pour X.
Verdict: <Adopter|Construire> — <choix provisoire ou "sur-mesure"> — choisi sans recherche à votre demande ; dites le mot pour une analyse de 60 secondes.
Pourquoi : l'utilisateur peut ignorer qu'une solution existe déjà ; un saut silencieux leur enlève la possibilité de corriger le cap. Après la ligne de verdict, procédez sans chercher — ne l'utilisez pas comme une porte dérobée pour faire une recherche complète quand même.
Anti-patrons
- Sauter au code — écrire un utilitaire sans vérifier s'il en existe un.
- Ignorer la capacité MCP / installée — reconstruire ce qui est déjà câblé.
- Sur-personnaliser — envelopper une bibliothèque si lourdement que son bénéfice est perdu.
- Gonflement des dépendances — installer un paquet volumineux pour une petite fonctionnalité.
- Recherche sans verdict — faire le travail mais ne jamais enregistrer de décision.
Exemples (illustratifs — vérifiez les paquets en direct)
Ces exemples montrent à quoi ressemble un verdict ; ce ne sont pas des recommandations de paquets actuelles. Re-cherchez avant de vous fier à un paquet spécifique.
- Vérification de liens morts → une règle de vérification de liens maintenue, sous licence permissive, couvrant tous les types de liens →
Verdict: Adopter — textlint-rule-no-dead-link — maintenance active, MIT, couverture complète - Publication croisée Qiita → seuls des wrappers partiels non maintenus existent →
Verdict: Construire — sur-mesure — aucune solution complète maintenue ; réutiliser l'API de la plateforme via un client HTTP - Cohérence terminologique JP → un vérificateur basé sur un dictionnaire nécessitant une configuration de projet →
Verdict: Étendre — textlint-rule-prh — installer + un dictionnaire de projet