Modèle de spécification d’un petit outil

Une page, écrite avant de construire quoi que ce soit (leçon 1). Elle sert ensuite à construire (leçons 2 et 3), à tester (leçon 4) et à entretenir (leçon 8). Rien de la liste « jamais » dedans.

SPÉCIFICATION : [nom de l'outil]
Mise à jour le : [date]

LE PROBLÈME : [ce qui ne va pas aujourd'hui, en 2 ou 3 phrases]
QUI S'EN SERT : [qui, sur quel appareil, à quel moment]
LE PARCOURS : [les étapes, du point de vue de la personne]
1. ...
2. ...
3. ...
LA VERSION MINIMALE : [le plus petit outil qui règle déjà le problème]
HORS SUJET POUR L'INSTANT : [ce qu'on ne fait pas dans cette version]
C'EST RÉUSSI SI : [des critères qu'on peut vérifier, un par ligne]
1. ...
2. ...
LES DONNÉES : [lesquelles, où elles restent, ce qu'on ne garde pas]
CONTRAINTES : [par exemple : un seul fichier, sans compte, sans serveur, sans rien installer, sans rien charger depuis Internet]
À DÉCIDER : [ce qui reste à trancher]

La demande à ton agent

Je veux un petit outil pour [besoin, en deux phrases]. Je ne sais pas coder.
Propose une spécification courte, avec exactement ces parties : [colle les parties du modèle].
Contraintes : [tes contraintes].
Écris [à décider] pour ce que je dois trancher, et pose au plus 3 questions à la fin.
Écris la spécification dans specification.md, puis montre-la-moi. Ne crée aucun autre fichier.

Avant de passer à la construction

☐ Chaque critère de « C’est réussi si » se vérifie par oui ou non
☐ Plus aucun [à décider]
☐ Les données : rien de plus que le nécessaire
☐ La version minimale tient en une phrase