Formations · Module 05 · Praticien

Rédiger une spécification exécutable par un agent de code

On a longtemps écrit des spécifications pour des humains, qui comblent les trous tout seuls. Un agent ne comble pas : il invente, et il le fait de façon convaincante.

Le problème

Un humain comble les trous. Un agent invente.

Une spécification écrite pour un développeur humain repose sur un immense implicite : la connaissance du produit, les conventions de l’équipe, le bon sens métier, et le réflexe de venir poser une question quand quelque chose manque.

Un agent n’a rien de tout cela. Ce qui n’est pas écrit, il le décide. Et comme il décide bien la plupart du temps, on ne s’en aperçoit qu’au moment où il a décidé mal — souvent tard, souvent sur le détail qui comptait.

Une spécification exécutable dit trois choses qu’une spécification ordinaire omet : ce qui est dans le périmètre, ce qui n’y est explicitement pas, et à quoi précisément on reconnaîtra que c’est fini.

Objectifs pédagogiques

Ce que vous saurez faire à l’issue.

Quatre objectifs formulés de façon observable, et chacun produit une pièce du livrable. Rien n’est laissé à l’impression.

Programme

Ce qui est travaillé.

01

Le découpage

Une tâche est bien découpée quand elle peut être exécutée et vérifiée sans attendre le résultat d’une autre. C’est aussi ce qui rendra plus tard l’exécution parallèle possible.

02

Les critères d’acceptation

« La page doit être rapide » ne se vérifie pas. « La page répond en moins de 400 ms sur le jeu de test fourni » se vérifie. La différence tient en une phrase et change tout.

03

Le périmètre exclu

La moitié la plus utile de la spécification, et celle qu’on n’écrit jamais. Sans elle, l’agent élargit — poliment, silencieusement, et souvent bien au-delà de la demande.

04

Le gabarit

Ce qui distingue une méthode d’un coup de chance : pouvoir dire ce qui a changé entre deux demandes, et réutiliser ce qui a marché.

Public et prérequis

Pour qui ce module est fait.

Développeurs, tech leads, product owners.

Prérequis : Utiliser déjà un agent de code, même occasionnellement.

Chaque participant est positionné avant la session, par un questionnaire et un échange avec le commanditaire. Le programme est adapté à ce que ce positionnement révèle. Si le module n’est pas le bon, je le dis avant l’inscription.

Méthodes mobilisées

Formation-action, sur vos cas réels.

Plus de 60 % du temps est consacré à la production. Les apports théoriques ne dépassent jamais quinze minutes consécutives, et chaque atelier produit une pièce du livrable final.

Méthodes employées : ateliers individuels et en sous-groupes, revue croisée entre participants, travail sur grille, argumentation devant le groupe. Un kit d’outils réutilisables est remis et rempli en séance sur vos propres cas.

Vous ne repartez pas avec un classeur. Vous repartez avec ce que vous avez produit.

Évaluation et suivi

Une boucle sans angle mort.

Avant la session

Questionnaire de positionnement : vérification des prérequis, mesure du niveau de départ sur les quatre objectifs, et adaptation du programme au contexte réel.

Pendant

Évaluation formative continue : mise en commun, revue croisée entre participants, challenge sur les faits. On régule en continu plutôt qu’on ne sanctionne à la fin.

Fin de session

Évaluation des acquis sur le livrable produit, au moyen d’une grille critériée remise dès l’ouverture. Attestation de fin de formation mentionnant les objectifs et les résultats.

À chaud

Questionnaire de satisfaction, consolidé et analysé après chaque session.

60 jours après

Questionnaire de transfert : ce qui a été décidé en salle a-t-il réellement été engagé, et l’indicateur a-t-il bougé.

Ce sur quoi je m’appuie

Je n’enseigne que ce que j’ai fait.

Pratique quotidienne du développement piloté par spécification avec Claude Code et Codex, et conception d’Open Free Max, un IDE desktop qui orchestre plusieurs agents de développement en parallèle.

Informations pratiques

Accès, tarif et accessibilité.

Délais d’accès

3 à 6 semaines entre la demande et le démarrage, selon le temps nécessaire à l’analyse du besoin, au positionnement des participants et à l’instruction éventuelle d’un dossier de financement.

Tarif

Sur devis, établi après l’entretien d’analyse du besoin. Le suivi à 60 jours est inclus.

Accessibilité

Chaque participant est interrogé sur ses besoins d’aménagement dans le questionnaire de positionnement. Les adaptations portent sur les supports, le rythme, l’organisation de la salle et les modalités d’évaluation. Si un besoin ne peut être satisfait en interne, nous orientons vers les ressources compétentes. Aucune demande n’est laissée sans réponse.

Indicateurs de résultats

Module créé en 2026. Les indicateurs de satisfaction, d’atteinte des objectifs et de transfert seront publiés à l’issue des premières sessions.

Avant toute inscription

On vérifie d’abord que c’est la bonne formation.

Trente minutes pour comprendre votre situation, votre niveau de départ et ce que vous devez pouvoir faire à la fin. Si le besoin est ailleurs, je le dirai.

Réserver un échange

Voir les douze modules du catalogue