AI CodeOps

Agent Researcher

L'agent Researcher étudie votre code, vos bibliothèques et vos références avant le début du travail, et résume l'existant et les contraintes. Il ouvre Discovery & Spec.

L'agent Researcher fait le tour de la question avant que quoi que ce soit soit décidé. Il étudie le code existant, les bibliothèques qu'utilise le projet et les références pertinentes, puis résume l'existant et les contraintes qui comptent pour la tâche.

Où il intervient

WorkflowÉtape
Discovery & SpecPrior art

Discovery & Spec est un workflow de planification destiné au début d'un chantier : une recherche, puis les exigences du Product Analyst, puis un plan par phases du Project Planner. Le Researcher passe en premier.

Entrées

  • La tâche de la session.
  • Un instantané en lecture seule des fichiers pertinents du dépôt du projet, choisis pour la tâche et maintenus dans un budget de taille. Lorsque le projet n'a pas de dépôt, il travaille à partir de la seule tâche.
  • Les outils des serveurs MCP connectés, si la politique de votre espace de travail les autorise. C'est le seul moyen pour lui d'atteindre des sources extérieures au dépôt.

Sorties

Un résumé rédigé :

  • Ce qui, dans la base de code, fait déjà quelque chose de similaire, et où cela se trouve.
  • Les bibliothèques déjà utilisées qui pourraient être réutilisées, et celles qui seraient de nouvelles dépendances.
  • Les contraintes que le travail doit respecter, comme un modèle de données existant ou un schéma d'authentification.
  • Les questions ouvertes pour les personnes à qui revient la décision.

Les deux étapes suivantes le lisent. Avec le niveau Auto, son étape va d'abord au niveau Premium.

Exemple d'exécution

Exemple illustratif, pas une session enregistrée. Matt lance Discovery & Spec avec la tâche « ajouter une synchronisation bidirectionnelle avec notre gestionnaire de tickets ». Le Researcher indique que le projet dispose déjà d'un émetteur de webhooks sortants et d'une file de nouvelles tentatives qui pourraient transporter les événements de synchronisation, qu'il n'existe pas encore de point de terminaison pour les webhooks entrants, et que le client HTTP existant ne gère pas les limites de débit. Il nomme une contrainte : les identifiants de tickets sont stockés sous forme d'entiers alors que le gestionnaire de tickets utilise des chaînes, et il demande si la synchronisation doit se faire par projet ou par espace de travail. Le Product Analyst rédige ensuite les exigences en tenant compte de ces faits.

Limites

  • Il ne navigue pas sur le Web et ne lit pas de documentation tierce, sauf si un outil MCP la lui fournit.
  • Il voit une sélection de fichiers, pas l'ensemble du dépôt. Dans une grande base de code, il peut passer à côté d'un module pertinent.
  • Sa connaissance des bibliothèques extérieures à votre code est celle du modèle, avec la date limite d'entraînement de ce modèle.

Questions fréquentes

L'agent Researcher fait-il des recherches sur le Web ?

Non. Il lit le code du projet et s'appuie sur les connaissances générales du modèle. Il ne peut atteindre d'autres sources que par des outils MCP que votre espace de travail a connectés et autorisés.

Pourquoi faire une recherche avant les exigences ?

Pour que les exigences réutilisent ce qui existe déjà. Savoir qu'il existe déjà un exécuteur de tâches ou un module d'export change ce qu'il faut construire.