Module
Module 5 sur 5Leçon 1 sur 2~14 min

Garder la spec vivante, éviter les anti-patterns

Une spec figée au lancement ne décrit bientôt plus ce que fait vraiment le produit, et l'équipe comme les agents de code cessent de s'y fier. La leçon vous aide à entretenir la spec au fil des décisions, à repérer quand elle s'écarte du produit, et à reconnaître les travers qui rendent un document de spécification inutile.

Suivre cette leçon : première formation offerteVoir le programme complet

Objectif de la leçon

À la fin de cette leçon, vous serez capable de tenir une spec à jour pendant et après la construction (versions, journal des décisions, mise à jour quand le code révèle un cas), de repérer la dérive entre spec et produit, et de reconnaître les anti-patterns qui rendent une spec inutile.

Thèmes abordés

  • spec vivante
  • journal des décisions
  • dérive entre spec et code
  • anti-patterns de spécification
  • documentation produit

Dans quel module

Faire vivre la spec

Comment garder la spec juste pendant et après la construction, et livrer la vôtre ?

Leçons du module

  1. Garder la spec vivante, éviter les anti-patterns (cette leçon)
  2. Atelier final : votre spec et votre fichier d'intention

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.

Formations liées