Module
Module 4 sur 5Leçon 3 sur 3~14 min

Relire le plan d'un agent contre la spec

Un agent de code annonce souvent un plan avant d'écrire la moindre ligne, et c'est une occasion précieuse de vérifier qu'il a compris la spec. Cette leçon vous apprend à confronter ce plan à la spec pour repérer les écarts, puis à contrôler ce qui a réellement été livré, sans avoir besoin d'être développeur.

Objectif de la leçon

À la fin de cette leçon, vous serez capable de relire le plan qu'un agent de code propose avant d'écrire le code, de repérer les écarts avec la spec (critère oublié, hors périmètre touché, supposition non dite) et de vérifier ensuite les preuves de ce qui a été livré.

Thèmes abordés

  • plan d'un agent de code
  • agents de code
  • mode plan
  • revue de code par IA
  • spec et implémentation

Dans quel module

Des specs pour les agents de code

Que faut-il écrire pour qu'un agent de code IA construise la bonne chose, et comment le vérifier avant et après ?

Leçons du module

  1. Ce dont un agent de code a besoin
  2. Le fichier d'intention et les conventions du dépôt
  3. Relire le plan d'un agent contre la spec (cette leçon)

Ce que vous apprendrez dans la formation

Cette leçon fait partie de la formation Écrire des specs que les développeurs et les agents IA comprennent

  • Choisir le niveau de spec adapté à la décision à prendre (PRD, spec de fonctionnalité, ticket) et savoir ce que chacun doit contenir.
  • Formuler l'intention d'une fonctionnalité (problème, résultat visé, contraintes, non-objectifs) séparément de la solution, pour laisser la bonne marge à l'équipe et à l'agent.
  • Écrire des critères d'acceptation Given/When/Then vérifiables, déclaratifs et sans ambiguïté, y compris sous forme de tableaux d'exemples.
  • Identifier les cas limites et les exigences non fonctionnelles (performance, sécurité, accessibilité, données personnelles) et les rendre testables.
  • Rédiger une spec et un fichier d'intention exploitables par un agent de code (contexte, contraintes, fichiers concernés, hors périmètre, définition de terminé vérifiable).
  • Relire le plan d'un agent de code contre la spec, repérer les écarts avant qu'il code, puis vérifier les preuves de ce qui a été livré.
  • Garder une spec vivante (versions, décisions, mises à jour quand le code révèle un cas) et repérer les anti-patterns qui la rendent inutile.