Morgan Dutemple
← Retour au blog
Delivery

Spécification fonctionnelle et IA : ce qui reste écrit, ce qui peut être montré

Documents imprimés de brief produit et d'objectifs utilisateurs posés sur une table, avec un schéma de parcours dessiné sur une planche blanche
Photo par Kelly Sikkema sur Unsplash
Morgan Dutemple
·Delivery Manager, conduite du changement & IA

Une spécification fonctionnelle n'a jamais été aussi facile à produire, et c'est précisément le problème. En quelques minutes, un assistant IA transforme « je veux un espace client » en douze pages propres, numérotées, convaincantes. Ce qui manque dans ces douze pages, ce sont les décisions : qui a le droit de faire quoi, ce qui se passe quand ça échoue, ce qui est hors périmètre.

Je décris ici ce que l'IA change entre le brief et le prototype : ce qui doit rester écrit, ce qui peut être montré, et comment je l'utilise pour décomposer un besoin sans lui laisser les arbitrages.

Ce qu'une spécification fonctionnelle doit encore écrire

Une spécification fonctionnelle décrit ce qu'un système doit faire et selon quelles règles, du point de vue de ceux qui l'utilisent, sans dire comment il sera construit. Trois éléments n'ont pas d'équivalent visuel et doivent rester écrits : les règles de gestion, les critères d'acceptation et les cas limites. Un prototype peut les illustrer, il ne peut pas les trancher.

Les règles de gestion sont les décisions métier qui s'appliquent quel que soit l'écran : un devis expire au bout de trente jours, une commande annulée après expédition passe par un retour, un compte désactivé conserve son historique. Une maquette montre un état, pas la règle qui y conduit.

Les critères d'acceptation disent à quelle condition une fonctionnalité est terminée. Le format Gherkin, documenté par Cucumber, les rend vérifiables : un contexte initial (« Given »), un événement (« When »), un résultat observable (« Then »). La même documentation prévoit un mot-clé « Rule » qui regroupe les scénarios illustrant une seule règle métier : c'est exactement le lien entre règle de gestion et critère d'acceptation. Bill Wake en faisait déjà une condition dans son critère INVEST de 2003 : une bonne story est testable.

Les cas limites, enfin, sont ce qui fait revenir le projet en recette : le fichier de 200 Mo, le double clic sur « Payer », l'utilisateur dont le nom contient une apostrophe. Personne ne les dessine : quelqu'un doit les écrire, et décider.

Ce que le prototype montre mieux qu'un document

Ce qui a vraiment changé avec l'IA, c'est le coût du prototype fonctionnel. Un parcours cliquable, avec de vrais champs et de faux appels serveur, se construit désormais en quelques heures avec un agent de code.

Je déplace donc vers le prototype tout ce qui relève du parcours et de l'interface : l'enchaînement des écrans, le vocabulaire des boutons, les états vides, de chargement, de succès et d'erreur. Sur ces sujets, dix lignes de spécification produisent dix interprétations ; un écran en produit une seule, que l'utilisateur peut contester. C'est le sens du prototypage avec les futurs utilisateurs, que je ne redétaille pas ici.

Le piège est symétrique. Un prototype qui fonctionne donne l'impression que tout est décidé. Le client voit un formulaire qui s'envoie et le croit fini, alors que personne n'a tranché la durée de conservation des messages. Le prototype montre le parcours heureux ; la spécification écrite porte tout le reste.

Ce qui reste écritCe qui peut être montréCe que l'IA peut préparer
Règles de gestionParcours et enchaînement des écransListe des questions à trancher
Critères d'acceptationÉtats de l'interfaceScénarios Given / When / Then à relire
Cas limites et hors périmètreLibellés et vocabulairePremier prototype jetable

Décomposer un besoin avec l'IA sans lui confier les décisions

Un modèle de langage à qui l'on donne un brief vague ne s'arrête pas pour poser des questions : il comble les trous avec des hypothèses plausibles. Le document produit est cohérent, mais chaque hypothèse silencieuse est une décision prise à la place du métier.

GitHub l'a formalisé dans Spec Kit, sa boîte à outils open source (licence MIT) de « spec-driven development ». Les modèles de spécification y imposent un marqueur explicite, [NEEDS CLARIFICATION: question précise], à poser sur chaque ambiguïté. La raison donnée : éviter que le modèle fasse des hypothèses plausibles mais potentiellement fausses. La spécification doit décrire le quoi et le pourquoi, pas le comment, et la checklist finale vérifie qu'aucun marqueur ne subsiste. GitHub vend par ailleurs Copilot, mais Spec Kit fonctionne avec plusieurs agents de code.

C'est l'usage de l'IA que je défends sur une spécification : lui demander d'abord ce qu'elle ne sait pas. Je lui donne le brief et je lui demande les questions sans réponse, classées par impact, avant toute rédaction, qui attend les réponses de ceux qui ont l'autorité pour les donner. Une question restée ouverte n'est pas un échec du document ; une question tranchée en silence par le modèle est une dette de cadrage qui ressortira en recette.

Le décomposeur de specs et l'évaluateur de brief, en pratique

Les deux outils gratuits que j'ai construits sur ce site en juin 2026, avec un agent de code, reposent sur la même idée, mais ils ne contiennent pas d'IA. Ce sont des listes déterministes, écrites et relues à la main, pour que la même entrée donne toujours le même résultat.

Le décomposeur de spécifications part de six fonctionnalités que l'on croit simples : formulaire de contact, authentification, liste filtrée, tunnel de commande, upload de fichiers, espace client. Chacune est découpée en cinq à sept rubriques (champs, validation, états de l'interface, sessions, RGPD...) et en 25 à 34 points. Pour chaque point, on indique s'il est couvert, partiel ou à définir, souvent avec des options concrètes (durée de session, comportement en cas de double envoi). Un point couvert compte pour un, un point partiel pour un demi, et le pourcentage obtenu dit surtout ce qui reste à décider.

L'évaluateur de brief travaille un cran plus haut, sur douze dimensions : cas nominal, cas d'erreur, rôles, états de l'interface, intégrations tierces, volume de données, sécurité, RGPD, mobile, contenu éditorial, performance, cas limites. Le score sur douze est volontairement simple : en dessous de quatre, la spécification ne peut pas démarrer ; à partir de dix, le développement peut commencer.

Je m'en sers aussi pour contrôler une spécification générée par l'IA : je la passe dans la grille, et les dimensions absentes ou couvertes par une phrase générique deviennent visibles en quelques minutes.

Du brief au prototype : une méthode en quatre temps

Premier temps, le diagnostic du brief : je mesure ce qui est décidé et ce qui ne l'est pas, avec la grille des douze dimensions, avant d'écrire quoi que ce soit. Deuxième temps, les questions : l'IA décompose le besoin et liste ce qui manque, je trie, et les réponses viennent du métier, en atelier de cadrage dans les deux premières semaines. Troisième temps, l'écrit court : règles de gestion, critères d'acceptation au format Given / When / Then, cas limites et hors périmètre, rien d'autre. Quatrième temps, le prototype : il montre le parcours et les états, il est testé avec les utilisateurs, et chaque écart avec l'écrit est corrigé dans le document, pas seulement dans l'écran.

Le document final est plus court qu'avant. Il ne décrit plus les écrans, il fixe ce qui ne se voit pas. C'est ce que j'attends d'un delivery management outillé par l'IA : moins de pages, plus de décisions explicites.

Sources : GitHub, Spec Kit (dépôt officiel) ; GitHub, « Specification-Driven Development », documentation de Spec Kit ; Cucumber, « Gherkin Reference » ; Bill Wake, « INVEST in Good Stories, and SMART Tasks », 2003

Pour aller plus loin : La dette de cadrage coûte plus cher que la dette technique, Prototyper avec les futurs utilisateurs : l'adoption se joue avant le développement

Questions fréquentes

L'IA peut-elle rédiger une spécification fonctionnelle complète ?

Complète en apparence, oui. Elle ne peut pas trancher les règles de gestion, les priorités ou le périmètre, qui appartiennent au métier. Utilisée pour lister les questions ouvertes puis mettre en forme les réponses, elle fait gagner du temps ; laissée seule face aux trous du brief, elle produit des hypothèses silencieuses.

Un prototype fonctionnel peut-il remplacer la spécification ?

Non. Il remplace avantageusement la description des écrans et des parcours, mais pas les règles qui ne se voient pas : conservation des données, droits, cas d'erreur, cas limites. Je garde les deux, et c'est l'écrit qui fait foi en recette.

Quelle différence entre un brief et une spécification fonctionnelle ?

Le brief exprime un besoin (« je veux un formulaire de contact »). La spécification fonctionnelle contient les décisions qui permettent de le construire et de le tester : champs, validation, comportement après envoi, erreurs, RGPD. Le décomposeur de specs rend visibles les questions qui séparent les deux.

Morgan Dutemple

À propos de l'auteur

Morgan Dutemple

Delivery Manager à Rennes. Je pilote des projets de transformation digitale, SEO/GEO et accessibilité RGAA pour des clients grands comptes. Ce blog est le reflet de ce que je rencontre sur le terrain.