Module
Module 4 sur 5Leçon 1 sur 3~16 min

Ce dont un agent de code a besoin

Un agent de code produit vite un résultat plausible, mais il comble les manques d'une consigne par ses propres suppositions. Cette leçon vous apprend à transformer une spec en consigne complète pour un agent, et à savoir quoi exiger de lui pour juger que le travail est vraiment terminé avant de le valider.

Objectif de la leçon

À la fin de cette leçon, vous serez capable de transformer une spec en consigne autonome pour un agent de code : contexte, fichiers et interfaces concernés, contraintes, hors périmètre et définition de terminé avec une étape de vérification qu'il peut exécuter.

Thèmes abordés

  • agents de code
  • consigne pour agent de code
  • définition de terminé
  • développement assisté par IA
  • spec pour agent IA

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 (cette leçon)
  2. Le fichier d'intention et les conventions du dépôt
  3. Relire le plan d'un agent contre la spec

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.