À 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
Guide sur ce thème
- Écrire une spec pour agent IA
Les sections d’une spec qu’un agent de code exécute sans deviner, avec un modèle SPEC.md.
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
- À quoi sert une spec, et à quel niveau l'écrire (cette leçon)
- 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.
Formations liées
- IA & DéveloppementConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Travailler avec Claude Code sur un vrai projet : contexte, plan, revue
3 h
- IA & ProductivitéConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Créer des Claude Skills fiables pour votre travail produit
2 h 30 min
- Product ManagementJuniorQuelques bases utiles : notions de contexte ou du domaine.
Concevoir et valider une expérience produit avec l'IA
2 h 30 min