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

À quoi sert une spec, et à quel niveau l'écrire

Trop vague, une spec laisse l'équipe et les agents de code combler les trous à leur manière ; trop détaillée, elle se périme avant d'être lue. Cette leçon vous aide à clarifier ce qu'un document de spécification doit apporter et à choisir le bon niveau de détail selon la décision à prendre et le lecteur, humain ou machine.

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 dire ce qu'une spec doit permettre (comprendre, décider, vérifier) et de choisir le bon niveau (PRD, spec de fonctionnalité, ticket) selon la décision à prendre et le lecteur, humain ou agent.

Thèmes abordés

  • écrire des specs
  • PRD ou spec
  • spécification fonctionnelle
  • ticket de développement
  • niveau de détail d'une spec

Dans quel module

Le rôle de la spec

À quoi sert une spec, à quel niveau l'écrire, et comment dire ce qu'on veut sans imposer comment le faire ?

Leçons du module

  1. À quoi sert une spec, et à quel niveau l'écrire (cette leçon)
  2. L'intention avant la solution

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