Documentation

Rôles des agents

Quel agent gère chaque étape d'une tâche et quelles sont ses compétences et limites.

Coroid n'utilise pas un seul agent polyvalent. Chaque étape du processus allant de la description à pull request est prise en charge par un agent ayant une mission précise et un ensemble d'outils délibérément restreints.

Ces restrictions sont essentielles : un agent incapable d'écrire du code ne pourra pas accidentellement écrire du code.

Les rôles

RôleÉtapePeut modifier votre code
ArchitecteSpécification et planNon
DéveloppeurConstructionOui
QAVérifierNon
RéviseurRévisionNon
Testeur webVérifier les flux navigateurNon
ExplorateurRecherche, à n'importe quelle étapeNon
Analyseur de dépendancesAnalyseNon

Les quatre premiers constituent le pipeline que vous voyez sur chaque tâche, dans cet ordre :

ArchitecteDéveloppeurQARéviseur

Un seul rôle — le développeur — peut modifier les fichiers de votre dépôt. Tous les autres agents se contentent de lire, d'exécuter, de générer des rapports ou de créer des tâches suivantes.

Architecte

Il transforme votre description en spécification, puis la spécification en plan. Il analyse le code existant pour ancrer le plan dans la réalité, mais n'écrit aucun code.

Son résultat est ce que vous validez avant le début de la construction.

Développeur

Il effectue le travail : il lit le code pertinent, apporte les modifications, écrit ou met à jour les tests, et les exécute localement dans l'espace de travail jusqu'à ce qu'ils passent.

Lorsque le Réviseur renvoie des constatations, Développeur est le rôle qui y réagit.

QA

Il effectue la vérification indépendamment de l'agent ayant écrit le code : votre suite de tests, les seuils de qualité configurés pour le projet et les critères d'acceptation issus de la spécification.

Le QA rend un verdict. Il ne corrige pas ce qu'il trouve ; les échecs sont renvoyés au Développeur pour rectification.

Réviseur

Il lit la différence finale et produit des constatations, en appliquant les règles de révision définies par votre organisation. Les constatations sont soit renvoyées au développeur pour rectification, soit jointes à pull request pour votre examen.

Testeur web

Il utilise un navigateur réel pour tester une prévisualisation de votre application et vérifier les flux utilisateur de bout en bout. Ce rôle est utilisé lorsqu'une affirmation sur le comportement ne peut être établie uniquement à partir du code.

Explorateur

C'est un rôle de recherche en lecture seule. Les autres agents s'en servent pour obtenir des réponses sur un code sans avoir à charger tout le contenu dans leur propre contexte : « où se gère l'authentification ? », « quelle fonction appelle ceci ? ».

Analyseur de dépendances

Il examine les dépendances et la manière dont les modifications se propagent dans le code, y compris entre projets lorsque des dépendances inter-projets sont configurées.

Pourquoi cette séparation est-elle importante ?

Trois propriétés découlent de cette répartition du travail :

  1. La vérification est indépendante. L'agent qui vérifie le travail n'est pas celui qui l'a écrit, il n'a donc aucun intérêt personnel dans le résultat.
  2. Le rayon d'explosion est limité. Seul le rôle de développeur dispose d'outils d'écriture de code ; ainsi, un échec lors de la révision ou de l'analyse ne peut pas corrompre votre dépôt.
  3. Chaque rôle utilise un modèle adapté à sa mission. La planification bénéficie d'une large connaissance du monde ; l'écriture de code compilable requiert d'autres compétences. AI profile utilise un modèle par rôle pour cette raison précise.

Suivant

Retourner à Comment une tâche devient-elle une solution pull request ? pour les étapes auxquelles ces rôles correspondent, ou Qu'est-ce que Coroid ? pour une vue d'ensemble plus concise.