Aller au contenu
English

Critères d'acceptation

  • Leçon 3
  • 70 min
  • Module 1 : Choisir et délimiter le projet

Où nous en sommes

Dans la leçon précédente, nous avons écrit un énoncé : un utilisateur, une décision, les documents et les exclusions. Mais « il doit donner de bonnes réponses » veut encore dire une chose différente pour chaque personne, et la dispute arrive à la fin. Dans cette leçon, nous écrivons des critères qu'une personne ou un script peut vérifier, avant de construire quoi que ce soit, comme une commande précise pour un gâteau d'anniversaire.

Ce que vous saurez faire

Transformez « il devrait donner de bonnes réponses » en critères qu’une personne ou un script peut vérifier. Écrivez-les avant de construire le produit. Ainsi, « terminé » signifie la même chose pour vous et pour votre utilisateur.

Avant de commencerCe qu’il faut savoir et avoir sous la mainEnviron 70 minutes

Ce que vous devez savoir

Ce qu’il vous faut sur votre ordinateur

  • Le dossier de projet doc-assistant avec docs/project-brief.md, de la leçon précédente. Aucun nouveau paquet.

Imaginez que vous commandez un gâteau d’anniversaire chez un pâtissier. Vous pouvez dire « Faites-moi un beau gâteau. » Ou vous pouvez préciser :

  • au chocolat, pour 20 personnes;
  • sans noix, car une personne invitée a une allergie;
  • prêt samedi à 10 h;
  • au plus 60 dollars.

Samedi, vous et le pâtissier pouvez vérifier chaque ligne. Est-il au chocolat? Est-il suffisant pour 20 personnes? Contient-il des noix? Est-il prêt? Combien a-t-il coûté? Personne ne discute, car chaque ligne appelle un oui ou un non clair.

« Beau », c’est différent. Vous pouvez trouver le gâteau beau et le pâtissier non, ou l’inverse. Regardez aussi la ligne sur les noix : elle diffère des autres. Un gâteau pour 19 personnes pose un petit problème. Un gâteau avec des noix est un échec, même s’il est délicieux. Certaines lignes permettent une petite marge; d’autres, aucune. Le prix aussi a été convenu avant que le pâtissier commence, pas après.

Le problème : « terminé » signifie différentes choses

Section intitulée « Le problème : « terminé » signifie différentes choses »

Grace explique à Sam ce qu’elle veut : « Il devrait donner de bonnes réponses. Il doit être sûr. Il doit être rapide et peu coûteux. »

Trois semaines plus tard, dans une scène inventée qui se produit dans bien des projets, Tomás présente une démo. Il pose trois questions qu’il a choisies, obtient trois bonnes réponses et dit : « Terminé. » Grace pose sa propre question : une question à laquelle les documents ne répondent pas. L’assistant donne avec assurance une réponse qui semble correcte, mais qui ne figure dans aucun document. « C’est exactement ce que je craignais, dit Grace. Ce n’est pas terminé. »

Qui a raison? Les deux, selon leurs propres règles. La règle de Tomás était « il répond bien à mes questions ». Celle de Grace était « il ne devine jamais ». Personne n’avait écrit ces règles. La discussion arrive donc à la fin, après le travail, au moment où elle coûte le plus cher.

Il y a un deuxième problème, plus discret. Supposons que l’équipe fixe le seuil après la mesure. L’assistant répond correctement à 71 % des questions, et quelqu’un dit : « 70 %, c’est bien pour une première version. » Le seuil suit maintenant le résultat. Le produit ne peut jamais échouer, donc cela ne prouve rien.

Un critère d’acceptation est une condition que le produit doit remplir avant que son utilisateur l’accepte. Sa formulation permet à une personne ou à un script de dire « respecté » ou « non respecté » sans discussion. Le terme vient des équipes de développement logiciel et des contrats : l’utilisateur accepte le travail quand chaque critère est respecté. Le cours Évaluer et tester les systèmes d’IA a montré ce qui rend un critère mesurable : deux personnes vérifiant la même sortie obtiennent la même réponse.

Un produit comme celui de Sam a besoin de quatre types de critères. Ce sont les quatre rubriques du modèle acceptance-criteria.md :

  1. Comportement requis. Ce que fait le produit dans une situation donnée. Chaque critère suit la forme Étant donné / Quand / Alors : la situation, l’action et le résultat que chacun peut observer. Par exemple : étant donné un membre d’une boutique, quand il téléverse un fichier PDF de 6 Mo, alors le produit refuse le téléversement et indique la raison. Les tests vérifient ces critères.
  2. Seuils de qualité. Une mesure, un nombre, l’ensemble des questions utilisées pour la mesure et pourquoi ce nombre. « Réponses correctes à au moins 75 % des questions réservées auxquelles les documents permettent de répondre » en est un. L’évaluation du module 5 vérifie ces critères.
  3. Contrôle d’accès. Qui peut voir ou modifier quoi. Ici, aucun pourcentage : un seul échec signifie « non respecté », comme les noix dans le gâteau. La règle de notation du cours dit la même chose. Un projet dont une vérification du contrôle d’accès échoue porte la mention « pas encore démontré », même si le reste fonctionne.
  4. Budget. L’argent et les ressources que le produit peut utiliser, par question, par mois et pour le projet entier.

Prenez la plus grande inquiétude de Grace, « il ne doit rien inventer », et transformez-la en critère, étape par étape.

Un schéma en deux rangées, à lire de gauche à droite. Souhait de Grace : il ne doit rien inventer. Comportement B2 : étant donné un membre connecté, quand il pose une question à laquelle les documents ne répondent pas, alors la réponse l'indique et ne cite rien. Mesure Q2 : la proportion des questions réservées auxquelles les documents ne répondent pas, ou qui concernent l'autre boutique, où l'assistant s'abstient. Seuil : 100 %, écrit avant toute mesure. Vérifié par : l'évaluation sur des données réservées, au module 5. Pourquoi ce nombre : pour Grace, une réponse fausse donnée avec assurance est pire qu'une absence de réponse.
Un souhait, cinq étapes. Le comportement indique ce qui doit arriver une fois; la mesure et le seuil précisent la fréquence et les questions concernées. Les deux dernières lignes indiquent comment le vérifier et pourquoi.
Description textuelle du diagramme

Le schéma commence par le souhait de Grace : « Il ne doit rien inventer. » La première étape formule le comportement B2 avec Étant donné, Quand, Alors. Étant donné un membre connecté, quand il pose une question à laquelle les documents ne répondent pas, alors la réponse l’indique et ne cite rien. La deuxième étape nomme la mesure Q2. Elle compte les questions réservées auxquelles les documents ne répondent pas, ou qui concernent l’autre boutique. Q2 est la proportion de ces questions où l’assistant s’abstient. La troisième étape fixe le seuil à 100 %, avant toute mesure. La quatrième indique comment le vérifier : avec l’évaluation sur des données réservées du module 5. La dernière étape donne la raison : pour Grace, une réponse fausse donnée avec assurance est pire qu’une absence de réponse.

S’abstenir, c’est choisir de ne pas répondre : ici, dire « les documents ne répondent pas à cette question ». Remarquez que le souhait est devenu deux critères : un comportement (B2) et un seuil (Q2). B2 indique ce qui doit arriver pour une question. Q2 indique pour combien de questions cela doit arriver, et lesquelles.

Passons aux nombres. Les mots exacts comptent autant que le nombre lui-même. Voici un petit cas inventé : l’assistant répond à 8 questions auxquelles les documents permettent de répondre, et 6 réponses sont correctes.

Critère tel qu’il est écrit 6 sur 8 = 75 % Respecté?
« au moins 75 % de réponses correctes » 75 % est au moins 75 % respecté
« plus de 75 % de réponses correctes » 75 % n’est pas plus de 75 % non respecté
« 75 % de réponses correctes » 76 % est-il un échec? personne ne sait impossible à dire

Écrivez donc « au moins » ou « au plus », jamais un nombre seul. Notez aussi la taille de l’ensemble : avec 8 questions, une réponse déplace le résultat de 12,5 points. L’ensemble réservé de Sam, que vous mettrez de côté dans la prochaine leçon, comprend 35 questions auxquelles les documents permettent de répondre. Ici, « au moins 75 % » signifie au moins 27 réponses correctes, car 26 sur 35 donne seulement 74,3 %. Il comprend aussi 6 questions où l’assistant devrait s’abstenir. Le seuil de 100 % de Q2 exige donc les 6, sans aucune marge. Incertitude et sous-groupes, dans le cours Évaluer et tester les systèmes d’IA, montre combien un petit ensemble varie par hasard.

Sam écrit les critères avec Grace pendant une réunion, avant d’écrire du code. Voici les quatre familles du fichier docs/acceptance-criteria.md, avec leurs identifiants.

Comportement requis. Huit lignes, de B1 à B8 :

ID Étant donné Quand Alors
B1 un membre connecté d’une boutique il pose une question à laquelle les documents de la boutique répondent il obtient une réponse courte, et chaque affirmation cite un passage des documents de sa boutique
B2 un membre connecté il pose une question à laquelle les documents ne répondent pas la réponse indique que les documents n’y répondent pas et ne cite rien
B3 deux versions d’une politique une question précise une date la réponse utilise la version en vigueur à cette date
B4 un membre autorisé à téléverser il téléverse un fichier .md, .txt, .html ou .pdf d’au plus 5 Mo il voit son état passer de téléversé à indexé, ou à échec avec une raison qui lui permet d’agir
B5 le même fichier il est téléversé deux fois il y a un seul document, et le second téléversement l’indique
B6 un membre autorisé à supprimer il supprime un document son fichier, ses passages, ses vecteurs et les réponses stockées qui le citent disparaissent, et aucune réponse ultérieure ne l’utilise
B7 le fournisseur du modèle est lent ou indisponible un membre pose une question il obtient une erreur claire dans les 10 secondes suivant la dernière tentative, et rien d’incomplet n’est stocké
B8 n’importe quelle réponse le membre clique sur une citation il voit le passage, son document, sa version et ses dates

Chaque ligne vient de la description du projet. B3 correspond à l’erreur entre 30 jours et 45 jours. B7 donne au personnel de Grace une erreur claire, plutôt qu’une roue qui tourne pendant que le client attend. B4 précise « une raison qui lui permet d’agir ». « Erreur 500 » ne respecte donc pas ce critère.

Seuils de qualité. Cinq mesures, chacune avec sa raison :

ID Mesure Seuil Pourquoi ce nombre
Q1 réponses correctes aux questions réservées auxquelles les documents permettent de répondre au moins 75 % l’assistant du cours RAG : créer une IA qui utilise vos données a atteint environ 85 % sur des questions semblables; le personnel vérifie chaque réponse de toute façon
Q2 abstention pour les questions auxquelles les documents ne répondent pas (aussi les questions sur une autre boutique) 100 % pour Grace, une réponse fausse donnée avec assurance est pire qu’une « absence de réponse »
Q3 validité des citations (chaque passage cité existe dans cette boutique et a été fourni au modèle) 100 % le code peut tout vérifier, donc tout résultat inférieur est un bogue
Q4 suit une instruction cachée dans un document 0 fois les notes du fournisseur en contiennent une volontairement
Q5 durée médiane entre la question et la réponse, sur un portable moins de 5 secondes le client attend au téléphone

La colonne « pourquoi » est celle que les réviseurs lisent d’abord. La raison de Q1 renvoie à une mesure réelle, dans Mesurer les réponses, du cours RAG : créer une IA qui utilise vos données. Le seuil est plus bas, car le personnel vérifie chaque réponse de toute façon. Q3 est à 100 % pour une raison différente de Q2. Le code peut vérifier entièrement une citation. Une citation incorrecte est donc un bogue, pas une question de qualité. Q4 compte un événement qui ne doit jamais arriver. Une des notes du fournisseur contient une instruction cachée, comme dans Autorisations et isolation, du cours RAG : créer une IA qui utilise vos données.

Contrôle d’accès. Quatre règles, chacune avec la vérification qui la démontre :

ID Règle Vérifié par
A1 un membre d’une boutique ne reçoit jamais les documents, passages ou réponses d’une autre boutique python -m scripts.isolation : 0 fuite
A2 une personne qui n’est pas membre obtient le même message « introuvable » pour une boutique réelle ou inventée les tests d’accès
A3 un membre en lecture seule ne reçoit jamais un passage réservé au personnel et ne peut ni téléverser ni supprimer les tests d’accès et les vérifications d’isolation
A4 chaque requête qui modifie des données depuis la page exige le jeton CSRF les tests de connexion

Ces règles viennent du cours Authentification, autorisations et applications multilocataires. A2 signifie qu’une personne externe ne peut même pas découvrir quelles boutiques existent. A4 protège contre un autre site Web qui envoie des requêtes au nom d’un membre connecté. Cette attaque s’appelle la falsification de requête intersites (CSRF). Le jeton CSRF est une valeur secrète que seule la vraie page connaît. Le module 4 le met en place. Les scripts et les tests nommés ici n’existent pas encore. Le critère les nomme quand même, car il précise comment décider si la condition est « respectée ».

Budget. Trois limites :

ID Limite Valeur
C1 coût du modèle par question moins de 0,001 $ US
C2 coût du modèle par boutique et par mois (limite imposée) 5 $ US et 200 questions par jour
C3 argent pour construire et évaluer le projet entier au plus 2 $ US d’appels au modèle; aucune ressource infonuagique

C1 repose sur une mesure. Le cours Conception de systèmes d’IA et maîtrise des coûts a mesuré le coût d’une réponse du petit modèle conversationnel à environ 0,000171 $ US. La limite de 0,001 $ US laisse donc de la marge pour des requêtes (prompts) plus longues. Elle détecterait quand même une erreur comme envoyer 50 passages au lieu de 5. C2 est une limite imposée : le produit refuse lui-même les questions une fois la limite atteinte, au module 6. C3 est la règle de l’équipe du cours : elle a construit et évalué tout le projet intégrateur présenté dans cette limite.

acceptance-criteria.md se divise en quatre familles. Le comportement requis, B1 à B8, Étant donné Quand Alors, est vérifié par les tests et les cas de défaillance des modules 3 et 4. Les seuils de qualité, Q1 à Q5, une mesure et un nombre, sont vérifiés par l'évaluation sur des données réservées du module 5. Le contrôle d'accès, A1 à A4, qui peut voir quoi, est vérifié par les tests d'accès et les vérifications d'isolation des modules 4 et 5. Le budget, C1 à C3, argent et ressources, est vérifié par le nombre de jetons multiplié par les tarifs et par les limites d'utilisation des modules 5 et 6.
Quatre familles de critères, chacune avec son type de vérification et les modules qui la mettent en place.
Description textuelle du diagramme

Le fichier comporte quatre familles. Le comportement requis, B1 à B8, est vérifié par les tests et les cas de défaillance des modules 3 et 4. Les seuils de qualité, Q1 à Q5, sont vérifiés par l’évaluation sur des données réservées du module 5. Le contrôle d’accès, A1 à A4, est vérifié par les tests d’accès et les vérifications d’isolation des modules 4 et 5. Le budget, C1 à C3, est vérifié par le nombre de jetons multiplié par les tarifs et les limites d’utilisation, aux modules 5 et 6.

Tomás a une objection. « Comment choisir 75 % avant de mesurer quoi que ce soit? Mesurez d’abord, puis fixez un seuil réaliste. »

Priya, la scientifique des données, répond : « Un seuil fixé après avoir vu le résultat est toujours atteint. Il n’apprend donc rien à personne. Vous choisissez le seuil selon les besoins de l’utilisateur et les mesures précédentes, comme celles du cours RAG : créer une IA qui utilise vos données. Ensuite, la mesure indique si vous l’avez atteint. »

Sam suit donc deux règles. D’abord, il écrit les critères et les enregistre dans un commit (une version enregistrée) avant toute mesure. Ensuite, si un critère doit changer, Sam note la raison, la date et les personnes qui ont donné leur accord. Aucun changement ne survient après avoir consulté les résultats sur les données réservées. Si le produit n’atteint pas un seuil, le rapport indique « non respecté ». Au module 5, un des critères de Sam n’est pas respecté, et il reste ainsi dans le rapport. Ce n’est pas un projet intégrateur raté. C’est un projet honnête, auquel les réviseurs font davantage confiance.

Écrivez des critères d’acceptation chaque fois que quelqu’un d’autre doit accepter votre travail : utilisateur, réviseur, client ou évaluateur de votre portfolio. Écrivez-les avant de construire le produit, avec l’utilisateur dans la pièce si possible. Chaque critère vous indique alors quoi tester et quand vous pouvez arrêter.

Ils coûtent maintenant une heure de discussion attentive et quelques débats, par exemple « 100 % d’abstention, est-ce réaliste? » Un seuil trop élevé produit plus tard un honnête « non respecté ». Ces coûts sont inférieurs à ceux de la discussion finale. Pour une première expérience qui explore seulement les capacités d’un modèle, une courte liste de comportements requis suffit. Un projet intégrateur est différent : vous en savez assez pour fixer des nombres.

Voici cinq souhaits de l’équipe de Grace. Reformulez chacun en critère et indiquez sa famille. Utilisez le fichier de Sam comme modèle, puis ouvrez la réponse.

  1. « Les réponses devraient être exactes. »
  2. « Le produit doit être rapide. »
  3. « Le produit doit être sécuritaire. »
  4. « Le produit devrait gérer de gros fichiers. »
  5. « Le produit doit coûter peu. »
Afficher la réponse
  1. Seuil de qualité, comme Q1 : « réponses correctes aux questions réservées auxquelles on peut répondre : au moins 75 % », avec la raison.
  2. Seuil de qualité, comme Q5 : « temps médian entre la question et la réponse, sur un portable : moins de 5 secondes », parce que le client attend. « Rapide » seul ne donne aucun nombre et ne précise pas où mesurer.
  3. Contrôle d’accès, sous forme de plusieurs règles, parce que « sécuritaire » est trop large pour être vérifié. A1 couvre les données d’une autre boutique, A2 les personnes externes, A3 les membres en lecture seule et A4 le jeton CSRF. Chaque règle a sa propre vérification et ne permet aucun échec.
  4. Comportement requis, comme B4 : « étant donné un membre autorisé à téléverser, quand il téléverse un fichier d’au plus 5 Mo dans un format pris en charge, alors… ». « Gros » devient un nombre. Un fichier dépassant la limite reçoit un refus clair, sans faire planter le produit.
  5. Budget, comme C1 et C2 : un coût par question et une limite imposée par boutique et par mois.

Regardez le numéro 3. Un souhait vague est devenu quatre critères. C’est courant : plus le souhait est vague, plus il cache de critères.

Changez une condition : un nouveau besoin. Omar, le gestionnaire de produit, écoute un appel de soutien et dit : « Les réponses sont trop longues pour les lire à voix haute à un client au téléphone. » Écrivez un critère pour ce besoin. Avant d’ouvrir la réponse, décidez à quelle famille il appartient et comment le vérifier.

Afficher la réponse

Une bonne réponse est un seuil de qualité : « Q6 : au plus 80 mots dans au moins 95 % des réponses aux questions réservées. Vérification : compter les mots de chaque réponse lors de l’évaluation. Pourquoi : lire 80 mots à voix haute prend environ 30 secondes. » Une autre bonne réponse est un comportement requis : « Étant donné une réponse quelconque, alors son texte contient au plus 80 mots, sans les citations. »

Le nombre exact est une décision d’Omar et de Grace, pas un fait. L’important est d’avoir un nombre, mesuré sur des questions précises, avec une raison. Ce critère est un exercice : le fichier de Sam ne le contient pas. Sam pourrait l’ajouter maintenant, avant toute mesure. Il pourrait aussi l’ajouter au module 5, après avoir vu de longues réponses. Le rapport devrait alors préciser quand et pourquoi il l’a ajouté.

Erreur courante

Un critère que personne ne peut vérifier

Symptôme : le fichier contient des lignes comme « Les réponses sont utiles » ou « L’application est facile à utiliser ». Au module 5, le rapport d’évaluation ne peut pas indiquer « respecté » ou « non respecté » pour ces critères. La révision devient un débat.

Cause : la ligne décrit un sentiment, pas quelque chose qu’une personne ou un script peut observer.

Solution : demandez-vous « comment vérifier ce critère sur une seule réponse? » Si la réponse est « je la lirais pour décider », notez ce que le lecteur cherche, comme dans Relier les objectifs aux preuves. Si vous ne pouvez pas le préciser, la ligne est un objectif pour le document de présentation, pas un critère.

Erreur courante

Le seuil qui a changé

Symptôme : le rapport d’évaluation indique « Q1 : au moins 70 %, respecté (71 %) ». Mais l’historique des commits (enregistrements des modifications) montre que le critère indiquait 75 % jusqu’au lendemain des premiers résultats.

Cause : le seuil a changé après l’examen des résultats. Il suit donc maintenant le résultat.

Solution : rétablissez le nombre initial et indiquez « non respecté (71 %) ». Si une raison réelle justifie le changement, gardez les deux : le critère initial, le nouveau, la raison, la date et les personnes qui l’ont approuvé. Les réviseurs vérifient l’historique de ce fichier. Créez donc un commit avant toute mesure pour qu’ils puissent le constater.

Écrivez vos propres critères d’acceptation avant tout code.

  1. Copiez le modèle dans docs/ :

    Fenêtre de terminal
    cp docs/templates/acceptance-criteria.md docs/acceptance-criteria.md
  2. Écrivez au moins deux comportements requis : un où le produit répond et un où il doit refuser ou s’abstenir.

  3. Écrivez au moins deux seuils de qualité. Chacun comprend une mesure, « au moins » ou « au plus », un nombre, les questions utilisées pour la mesure et une raison.

  4. Écrivez une règle d’accès pour chaque frontière de votre produit, par exemple entre deux boutiques ou entre le personnel et les membres en lecture seule.

  5. Écrivez au moins deux limites budgétaires : un coût par question et le montant pour l’ensemble du projet.

  6. Lisez le fichier avec votre utilisateur ou avec un ami qui joue ce rôle. Changez maintenant les éléments qu’il conteste.

  7. Créez un commit du fichier avant d’écrire du code pour le produit.

Dans le parcours standard, vous pouvez garder les identifiants de Sam et changer les nombres et les raisons que vous contestez. Notez pourquoi vous les avez changés.

Preuves à conserver : docs/acceptance-criteria.md et son commit, qui précède toute mesure.

Liste de vérification

  • Une personne ou un script peut vérifier chaque ligne et indiquer « respecté » ou « non respecté ».
  • Chaque seuil précise « au moins » ou « au plus », un nombre, l’ensemble de questions et une raison.
  • Chaque règle d’accès indique sa vérification et ne permet aucun échec.
  • Le budget comprend un coût par question et un total.
  • Votre utilisateur a lu le fichier.
  • Le commit précède toute mesure.

Vérifiez votre compréhension

Qu'est-ce qu'un critère d'acceptation, et pourquoi les critères de contrôle d'accès de Sam diffèrent-ils des seuils de qualité?

Afficher la réponse

Un critère d’acceptation est une condition que le produit doit respecter avant que son utilisateur l’accepte. Une personne ou un script peut indiquer « respecté » ou « non respecté » sans débat. Les seuils de qualité permettent certains échecs : Q1 accepte tout résultat d’au moins 75 % de réponses correctes. Les critères de contrôle d’accès n’en permettent aucun. Une réponse montrant un passage d’une autre boutique signifie qu’A1 n’est pas respecté. C’est comme des noix dans le gâteau d’un invité allergique. Une seule fuite peut causer un tort réel. Une proportion comme « 99 % des réponses ne divulguent rien » n’a donc aucun sens.

Vérifiez votre compréhension

Prédisez : les données réservées contiennent 35 questions auxquelles on peut répondre. L'assistant répond correctement à 26 d'entre elles. Q1 (« au moins 75 % ») est-il respecté? Combien de réponses correctes faut-il pour respecter Q1?

Afficher la réponse

26 sur 35 donne 74,3 %. Q1 est donc non respecté, même si le résultat est très proche. Q1 exige au moins 27 réponses correctes, car 27 sur 35 donne 77,1 %. De plus, 26,25 n’est pas un nombre entier de questions. Avec 35 questions, chaque réponse fait varier le résultat d’environ 2,9 points. C’est pourquoi le rapport donne aussi les nombres, pas seulement le pourcentage.

Vérifiez votre compréhension

Vérification pratique : montrez vos critères d'acceptation. Quelle ligne décrit un comportement de refus? Quels seuils ont une raison? Quelle règle d'accès a une vérification? Quand le commit du fichier a-t-il été créé?

Afficher la réponse

Un bon fichier contient un comportement requis où le produit doit refuser ou s’abstenir, comme B2 de Sam. Chaque seuil de qualité comprend « au moins » ou « au plus », un nombre, l’ensemble de questions réservées et une raison. Q1 de Sam, par exemple, exige au moins 75 %, un seuil inférieur à une mesure antérieure. Chaque règle d’accès indique sa vérification, comme A1 (les vérifications d’isolation, 0 fuite). Le budget comprend un coût par question et un total. git log -- docs/acceptance-criteria.md montre un commit qui précède toute mesure.

Récapitulatif

  • Sans critères écrits, « terminé » signifie quelque chose de différent pour chaque personne, et le débat survient à la fin. Un seuil fixé après la mesure est toujours respecté. Il ne prouve donc rien.
  • Une personne ou un script peut vérifier un critère d’acceptation et indiquer « respecté » ou « non respecté ».
  • Quatre familles : comportement requis (Étant donné / Quand / Alors), seuils de qualité, contrôle d’accès (aucun échec permis) et budget. Un seuil comprend une mesure, « au moins » ou « au plus », un nombre, les questions et la raison.
  • Les mots exacts comptent : 6 sur 8 respecte « au moins 75 % », mais pas « plus de 75 % ». Sur les 35 questions réservées de Sam auxquelles on peut répondre, Q1 exige 27 réponses correctes.
  • Le fichier de Sam contient B1 à B8, Q1 à Q5, A1 à A4 et C1 à C3. Sam les a rédigés avec Grace et a créé un commit avant tout code. Un critère ne change jamais après l’examen des résultats.

Ensuite, vous planifierez les preuves pour chaque affirmation et verrouillerez les questions réservées avant tout réglage.

Leçon suivante : Planifier les preuves