Articles / Exigences et spécifications

Exigences et spécifications : comment organiser les décisions et les modifications

Les demandes sont plus faciles à discuter lorsque vous notez ce qui est nécessaire, pourquoi c'est important et comment vous vérifierez le résultat. La gestion des exigences et des spécifications permet de continuer à exploiter ces décisions au fil du travail.

Que gérez-vous en dehors du document ?

Un document n'est qu'un moyen parmi d'autres de consigner une décision. Vous devez aussi savoir quels éléments ont été approuvés, lesquels sont encore des propositions, qui répondra aux questions et ce qui change lorsqu'un élément est révisé. Cela permet d'éviter de travailler à partir d'interprétations différentes d'une même demande.

La même approche peut servir au développement d'applications, aux outils internes, aux conditions liées aux produits et aux règles de fonctionnement. Commencez par une seule fonctionnalité ou un seul processus plutôt que d'essayer de tout documenter d'un coup.

Reliez l'objectif, l'exigence, la spécification et les critères d'acceptation

Les équipes emploient ces termes de différentes façons. Dans cet exemple, une exigence décrit un résultat attendu ou une contrainte, une spécification consigne le comportement convenu, et les critères d'acceptation expliquent comment le vérifier. Mettez-vous d'accord sur ces définitions avec les personnes avec lesquelles vous travaillez.

Objectif : réduire la transcription manuelle

Le processus de reporting mensuel nécessite actuellement de recopier les enregistrements à la main. L'exportation vise à faciliter ce travail.

Exigence : exporter les enregistrements nécessaires au rapport

Un membre du personnel doit exporter les enregistrements d'un mois donné, dans les limites des données auxquelles il est autorisé à accéder.

Spécification : définissez le fichier et son comportement

Mettez-vous d'accord sur les colonnes, leur ordre, l'encodage du texte, le format des dates, le comportement en cas de résultats vides et les erreurs. Il s'agit de choix propres à cet exemple, et non de paramètres par défaut universels.

Critères d'acceptation : rendez le résultat vérifiable

Préparez des enregistrements dont les dates et autorisations sont connues, effectuez l’exportation et comparez le résultat à celui qui a été convenu.

D'un objectif aux critères d'acceptation Ouvrir ReqSpec AI

Notez une seule idée vérifiable par élément

Une formule comme « Rendre l'exportation pratique » laisse des choix importants en suspens. Séparez le choix de la période, la sélection des champs de sortie, la gestion de l'absence de résultats et la vérification des accès lorsque ces éléments peuvent être modifiés ou vérifiés indépendamment.

Utilisez des conditions concrètes plutôt que des mots comme « rapide » ou « facile ». Si un objectif de temps de réponse est important, consignez la charge de travail, l'environnement et la méthode de mesure, en plus de la valeur chiffrée. Signalez clairement comme indéterminées les valeurs qui ne sont pas encore décidées.

Avant : “Autoriser l'exportation CSV.”

Après : « Exportez le mois sélectionné avec les colonnes et l'ordre de tri convenus. Définissez les résultats vides et les contrôles d'accès dans des éléments distincts. »

La formulation révisée précise les choix à convenir et facilite la répartition ainsi que la vérification du travail. Des définitions concrètes des champs restent nécessaires avant la mise en œuvre.

Un petit ensemble de champs pour commencer

ID, titre et description

Attribuez à chaque élément un ID stable, comme REQ-001. Indiquez le sujet, la condition et le résultat attendu. Un ID stable permet d'y faire référence même après la modification du titre.

Raison et source

Notez le problème auquel répond l’élément et son origine, par exemple une conversation, une demande ou un document justificatif.

Priorité et périmètre

Distinguez ce qui est nécessaire pour cette version de ce qui peut attendre. Expliquez la raison de chaque priorité ; n'attribuez pas la priorité maximale à tous les éléments.

Responsable et statut de la décision

Notez qui clarifiera l'élément et s'il s'agit d'un brouillon, s'il est en cours de révision ou s'il a été approuvé. Le responsable de la mise en œuvre et la personne chargée de l'approbation peuvent être différents.

Critères d'acceptation et informations connexes

Reliez l'élément aux spécifications, conceptions, tâches et enregistrements de vérification pertinents. Tenez ces liens à jour lorsque l'exigence change.

Exemple : trois exigences pour une exportation CSV mensuelle

Voici un exemple à titre d'illustration. Les noms des champs et leur comportement doivent être définis d'un commun accord pour le produit que vous développez ; cet exemple ne constitue pas une spécification complète de toutes les fonctions d'exportation.

REQ-001 : enregistrements du mois sélectionné

Exemple de spécification : utilisez le mois sélectionné dans le fuseau horaire professionnel convenu et exportez l’ID, la date d’enregistrement et le titre en UTF-8, triés d’abord par date, puis par ID. Exemple de recette : trois enregistrements correspondants produisent une ligne d’en-tête et exactement ces trois lignes de données, sans aucun enregistrement d’autres mois.

REQ-002 : aucun enregistrement correspondant

Exemple de spécification : exporter la ligne d'en-tête convenue même si aucun enregistrement ne correspond. Exemple de validation : le jeu de données de test vide produit un fichier contenant cet en-tête, sans aucune ligne de données. Si vous préférez afficher un message plutôt que produire un fichier, convenez de ce comportement différent et documentez-le.

REQ-003 : l'accès est vérifié avant l'exportation

Exemple de spécification : les utilisateurs sans autorisation d'exportation ne peuvent pas générer le fichier et les enregistrements hors du périmètre autorisé ne sont pas inclus. Les exemples de validation doivent couvrir un utilisateur sans autorisation d'exportation et un utilisateur dont l'accès aux enregistrements est limité.

Utilisez une hiérarchie sans perdre les décisions individuelles

Regroupez les éléments par objectif ou fonctionnalité, puis placez les conditions détaillées sous le groupe concerné. Par exemple : Rapports → Export CSV mensuel → Enregistrements ciblés / Format de fichier / Résultats vides / Accès. Placez le contexte et les questions en suspens dans les notes, plutôt que de les mélanger dans une longue exigence.

Si une condition affecte plusieurs fonctionnalités, conservez une référence claire à la version convenue au lieu de copier différentes versions dans chaque section. Avant de la modifier, vérifiez quelles spécifications en aval et quels éléments de vérification en dépendent.

Séparez l'accord, la mise en œuvre et la vérification

« Approuvé » signifie que le contenu a été accepté pour le périmètre prévu. Cela ne signifie pas que la fonctionnalité a été implémentée. « Implémenté » ne prouve ni que les critères d’acceptation convenus ont été satisfaits ni que la fonctionnalité a été publiée. Veillez à rendre ces distinctions visibles, même si vous utilisez une simple liste de statuts.

Examinez le cas normal, les entrées vides ou manquantes, les autorisations et, le cas échéant, les défaillances externes. Décidez quelles preuves conserver, qui les vérifie et qui peut clore une question non résolue.

Consignez une modification et son impact avant de la considérer comme approuvée

Une nouvelle demande reste une proposition tant que les responsables ne se sont pas mis d'accord sur la façon de la traiter. Consignez la raison du changement, les ID concernés et ses répercussions sur le travail, les dates, les spécifications et la vérification. Déterminez également si le changement s'applique aux enregistrements ou aux utilisateurs qui utilisent déjà la fonctionnalité.

Après la décision, mettez à jour la spécification actuelle et informez les personnes concernées. Conservez la version précédemment approuvée ou une note de modification lorsque vous devez expliquer ce qui a changé. Ne supposez pas qu'un outil enregistre automatiquement chaque approbation et chaque révision.

Choisissez un endroit que vous pouvez tenir à jour

Pour une petite liste, un document ou une feuille de calcul partagés peuvent suffire. Lorsque les échanges, l’implémentation et la vérification sont répartis entre plusieurs outils, choisissez une référence principale et reliez-y les documents associés. L’essentiel est que chacun puisse identifier le contenu actuellement convenu.

Utilisez AI pour un brouillon, puis confirmez les décisions

L'IA peut aider à dresser la liste des exigences possibles, à organiser une ébauche et à suggérer les questions manquantes. Dans votre consigne, distinguez les faits confirmés des hypothèses et demandez-lui de laisser les valeurs encore indécises sous forme de questions. Examinez le résultat avec les personnes qui connaissent l'utilisation prévue.

Dans ReqSpec AI, vous pouvez organiser les exigences et les spécifications de manière hiérarchique et utiliser l’IA pour faciliter leur création, leur modification et leur vérification. Posez une question ciblée, par exemple : « Quelles conditions liées aux résultats vides restent indéfinies ? » Considérez toute réponse comme une suggestion à vérifier par rapport au contenu enregistré, et non comme une preuve de validation ou d’exhaustivité.

Commencez par une fonctionnalité et une révision

Choisissez une fonctionnalité, dressez la liste des résultats attendus, attribuez des ID aux éléments et ajoutez des critères d'acceptation ainsi que les questions en suspens. Revoyez l'ensemble une fois avec une personne concernée, puis consignez les décisions et le prochain responsable. Un petit ensemble tenu à jour est plus utile qu'un long document que personne n'actualise.

Pour aller plus loin

NASA : Comment rédiger une bonne exigence

NASA : Gestion des exigences

Organisez les exigences et les spécifications avec ReqSpec AI

ReqSpec AI offre un moyen simple d'organiser les exigences et les spécifications sur mobile et sur le Web. Découvrez ses fonctionnalités sur la page de l'application.