L'intention avant la solution
Les demandes arrivent souvent sous forme de solution toute faite, et la construire telle quelle peut passer à côté du vrai problème. La leçon vous apprend à remonter d'une demande à l'intention qui la motive, et à décider ce que la spec impose ou laisse aux développeurs et aux agents, sans les enfermer dans une solution prématurée.
Objectif de la leçon
À la fin de cette leçon, vous serez capable de réécrire une demande formulée comme une solution en une intention complète (problème, résultat visé, contraintes, non-objectifs), et de décider quelles parties de la solution fixer et lesquelles laisser ouvertes.
Thèmes abordés
- problème avant solution
- intention produit
- non-objectifs
- cadrage de fonctionnalité
- spécifications
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
- L'intention avant la solution (cette leçon)
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
- Concevoir et valider une expérience produit avec l'IAJunior · ~2 h 30 min
- Instrumenter un produit et utiliser les données pour déciderConfirmé · ~3 h 30 min
- Prioriser et construire une roadmap orientée résultatsConfirmé · ~2 h 30 min