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

Mis à jour le 29 septembre 2026.

En bref

Une spec sert à ce que chacun comprenne ce qu'on construit et pourquoi, à prendre les décisions au bon moment et à vérifier ensuite que le résultat est conforme. Son niveau de détail dépend de la décision à éclairer et du lecteur. Pour un PM, choisir ce niveau évite à la fois les trous comblés au hasard et les documents périmés.

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.

Les questions auxquelles cette leçon répond

  • À quoi sert une spec produit ?

    Elle aligne l'équipe sur le problème, le résultat attendu et les limites du périmètre, puis sert de référence pour contrôler que la livraison tient ses promesses.

  • Quelle différence entre PRD, spec de fonctionnalité et ticket ?

    Le PRD cadre un produit ou une initiative et son pourquoi ; la spec de fonctionnalité décrit le comportement attendu ; le ticket découpe un morceau de travail précis à réaliser.

  • Quel niveau de détail donner à une spécification ?

    Assez pour qu'un lecteur ne devine pas ce qui compte, pas au point de décrire l'implémentation. Un lecteur machine, comme un agent de code, demande en général plus d'explicite qu'un humain.

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 le glossaire

Tout le glossaire

Guide sur ce thème

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 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.