Aller au contenu
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.

Mis à jour le 29 septembre 2026.

En bref

Une spec vivante est mise à jour pendant et après la construction, à chaque décision ou découverte qui change le comportement attendu. Une spec figée au lancement s'écarte vite du produit réel, et plus personne ne s'y fie. Pour un PM, l'entretenir garde une référence fiable pour l'équipe et pour les agents de code qui la relisent.

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.

Les questions auxquelles cette leçon répond

  • Comment garder une spec à jour après le développement ?

    En la modifiant à chaque décision qui change le comportement, en gardant une trace des versions et en vérifiant régulièrement qu'elle décrit toujours ce que fait vraiment le produit.

  • Quelles erreurs rendent une spécification produit inutile ?

    Décrire la solution au lieu du problème, viser une exhaustivité que personne ne lit, laisser des critères invérifiables ou ne plus la mettre à jour après le lancement.

  • Faut-il tenir un journal des décisions dans une spec ?

    Oui, c'est utile. Noter brièvement chaque décision, sa date et sa raison évite de rouvrir les mêmes débats et explique aux nouveaux arrivants, humains ou agents, pourquoi la spec dit ce qu'elle dit.

Thèmes abordés

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

Dans le glossaire

Tout le glossaire

Guide sur ce thème

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 ce module

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.