AP34 · RAG vectoriel par réflexe pour du code

Famille : Contexte et mémoire

Preuve moyenne

Noms d'origine : vector RAG for code

Une base vectorielle pour retrouver du code, là où `grep` et la lecture de fichiers font mieux et plus simplement.

Définition

Pour donner à un agent de code accès à un dépôt, on construit d’emblée un index d’embeddings et une chaîne RAG, alors qu’une recherche exacte pilotée par l’agent suffit.

Symptômes observables

  • Un index d’embeddings à maintenir pour un dépôt de code, là où une recherche exacte suffirait.
  • Des passages renvoyés avant que la question soit comprise, sans possibilité de relancer une recherche manquée.

Pourquoi c'est nuisible

Le code est du texte structuré où des outils simples (`grep`, `ls`, lecture de fichiers) retrouvent exactement ce qu’il faut ; une chaîne RAG fixe ajoute une infrastructure et choisit les passages à la place de l’agent.

Un choix défendable quand…

  • Un grand corpus documentaire non structuré, hors code : le RAG vectoriel reste la base des agents documentaires et de support, que la recherche agentique complète.

Chiffres

  • Boris Cherny, créateur de Claude Code : les premières versions utilisaient du RAG et une base vectorielle locale, mais la recherche agentique s’est vite révélée en général meilleure, et plus simple.
  • L’étude « Harness Engineering » (juillet 2026) a démonté le code de 11 agents de code : aucun ne récupère le code par embeddings, tous reposent sur une recherche déterministe (préprint).

Remèdes du catalogue

  • C6 · Recherche agentique — L’agent cherche lui-même avec des outils exacts (`grep`, `ls`, lecture de fichiers), garde des chemins plutôt que des passages, et relance quand il a manqué sa cible.

Patterns détournés

Anti-patterns voisins

Sources

Contenu relu le 2026-10-05

Catalogue des anti-patterns