Choisir un rôle d’analyse limité et observable

Un cahier de besoins mélange souvent objectifs, préférences visuelles, contraintes et hypothèses non discutées. Claude peut aider à classer ces éléments et à repérer les ambiguïtés, à condition de travailler sur un matériau autorisé et de demander une sortie vérifiable. L’objectif de cet atelier est précis : produire une première matrice d’exigences à partir de quelques notes synthétiques. Il ne s’agit pas de laisser un assistant approuver l’architecture, négocier les priorités ou décider de ce que veulent réellement les utilisateurs.

Nous utiliserons un cas entièrement fictif de suivi d’interventions. Le document indique : le directeur veut connaître les retards chaque lundi ; les responsables d’agence veulent filtrer leur périmètre ; la qualité demande une comparaison mensuelle ; le fichier est actualisé quand les exports arrivent. Ces quatre phrases paraissent simples, mais aucune ne définit encore le retard, le calendrier, les droits ou la date d’actualisation. Une analyse utile doit rendre ces inconnues visibles au lieu de les compléter par des conventions inventées.

Préparer un document de travail qui minimise l’exposition

Créez une copie synthétique du besoin, sans identités de clients, contrats, montants sensibles, secrets techniques ou échanges personnels. Conservez la structure des problèmes, mais remplacez les exemples par des valeurs inventées qui ne reproduisent pas une situation confidentielle reconnaissable. Un simple remplacement des noms n’empêche pas toujours une réidentification par contexte. Pour ce premier atelier, six à huit paragraphes rédigés spécialement sont suffisants ; il n’est pas nécessaire de téléverser un véritable dossier de projet.

Avant tout usage professionnel, vérifiez les outils autorisés par votre organisation et le cadre de traitement applicable. La présence d’un réglage ou d’un abonnement ne permet pas de promettre une confidentialité universelle. Les possibilités de fichier, de projet et d’intégration varient aussi selon le service et les accès disponibles. La méthode peut fonctionner avec du texte copié dans une conversation ; elle ne dépend d’aucune fonction payante particulière. Ce choix facilite également la conservation d’un exemple pédagogique reproductible.

Numéroter les passages avant de demander une synthèse

Découpez le texte en passages B01, B02, B03 et ainsi de suite. Par exemple, B01 décrit le besoin du directeur, B02 celui des agences et B03 la comparaison qualité. Demandez ensuite de restituer chaque exigence avec sa référence de passage et une courte preuve textuelle. Cette numérotation est importante lorsque plusieurs interlocuteurs utilisent des mots proches : mensuel peut désigner un mois civil, une période glissante ou une clôture comptable. Une référence précise permet de rouvrir la bonne discussion.

Un prompt possible est : analyse uniquement les passages fournis ; distingue exigences explicites, interprétations et informations absentes ; cite les références de passage ; ne transforme aucune hypothèse en obligation. Si une phrase contient plusieurs demandes, sépare-les. Cette instruction donne un cadre de travail, mais le résultat doit encore être comparé au document. Les recommandations officielles d’Anthropic encouragent notamment l’expression de l’incertitude et l’ancrage dans des éléments fournis ; elles ne constituent pas une certification de la réponse générée.

Construire une matrice d’exigences qui conserve les inconnues

Demandez des colonnes simples : identifiant, besoin, utilisateur, décision soutenue, données nécessaires, fréquence, preuve, question ouverte et critère de validation. Pour B01, une exigence candidate serait afficher chaque lundi le nombre d’interventions en retard. La question ouverte porte sur la définition du retard et l’heure de référence. Le critère de validation ne peut pas être totalement rempli avant cette réponse. Un assistant qui inscrit automatiquement sept jours comme délai a ajouté une règle qui n’existait pas.

Conservez un statut pour chaque ligne : explicite, à confirmer ou proposé. Cette distinction permet de discuter le résultat sans relire toutes les notes à chaque réunion. Elle évite aussi le piège d’une belle matrice dont toutes les cellules sont remplies avec des suppositions. Une valeur À définir est un résultat utile lorsqu’elle révèle une décision manquante. L’objectif n’est pas de maximiser la quantité de texte, mais de réduire les ambiguïtés qui pourraient se transformer en erreurs de développement.

Décomposer un indicateur avant de choisir ses graphiques

Prenons le taux de retard. Il faut définir le numérateur, le dénominateur, la date d’évaluation, les statuts exclus et le grain. Une intervention annulée entre-t-elle dans le dénominateur ? Une prestation terminée en retard reste-t-elle en retard après sa clôture ? Ces questions précèdent le choix d’une jauge ou d’une courbe. Demandez à Claude une liste d’éléments à faire confirmer, avec la raison pour laquelle chacun peut modifier l’interprétation de l’indicateur affiché.

Dans l’exemple pédagogique, le métier décide finalement que le taux porte sur les interventions ouvertes à la date de photographie, dont l’échéance promise est dépassée. Sur 80 interventions ouvertes, 12 sont en retard : le taux vaut 15 %. Si 20 interventions annulées étaient ajoutées au dénominateur, le taux deviendrait 12 %. Les deux résultats décrivent des populations différentes. Enregistrer la décision dans la matrice est donc plus important que produire immédiatement un titre de graphique séduisant.

Repérer contradictions et dépendances sans trancher à la place du métier

Ajoutez volontairement deux notes : B05 demande une mise à jour chaque heure ; B06 indique que l’export source n’est produit qu’une fois par jour. L’assistant doit signaler une dépendance incompatible avec la fraîcheur souhaitée, puis proposer des options à discuter : modifier la source, réduire l’engagement ou distinguer plusieurs familles d’indicateurs. Il ne doit pas annoncer une actualisation horaire simplement parce qu’une plateforme technique peut exécuter une tâche à cette fréquence.

Faites de même pour les droits : un directeur veut comparer toutes les agences, tandis qu’un responsable local demande à voir uniquement la sienne. Ce ne sont pas forcément deux exigences contradictoires ; elles peuvent décrire des profils distincts. En revanche, un export de toutes les lignes accessible au profil local pourrait contredire la restriction. Demandez une liste de dépendances et de scénarios de vérification, puis faites valider les arbitrages par les personnes responsables du périmètre et des données.

Transformer les besoins en critères de recette calculables

Un besoin tel que le rapport doit être simple n’est pas testable seul. Reformulez-le avec un scénario : un responsable d’agence doit retrouver en moins de trois actions la liste des interventions en retard dans son périmètre, pour une photographie donnée. Ce nombre d’actions est un choix de projet à confirmer, pas une norme universelle. La recette doit ensuite vérifier les filtres, le résultat et les restrictions d’accès, et non seulement l’existence d’un bouton portant le bon libellé.

Pour le taux défini précédemment, construisez un jeu synthétique de dix interventions ouvertes, dont deux en retard, plus trois annulées. Le résultat attendu est 20 % et non deux sur treize. Demandez à l’assistant d’expliquer quelles lignes devraient être incluses, puis vérifiez le calcul indépendamment. Le critère de recette devient une preuve concrète de la convention retenue. Une phrase comme les calculs sont exacts est beaucoup moins utile qu’un exemple où le numérateur et le dénominateur sont identifiables.

Faire une deuxième passe sur les omissions

Après la première matrice, demandez une revue ciblée : quels besoins du texte ne sont reliés à aucune ligne, quelles lignes n’ont aucune preuve et quelles questions bloquent la conception ? Cette passe ne remplace pas la lecture humaine ; elle offre une autre façon de chercher les trous. Comparez chaque référence et supprimez les exigences qui n’ont pas de fondement, sauf si elles sont explicitement conservées comme propositions. Une idée utile peut rester dans un backlog sans être présentée comme une demande du client.

Recherchez notamment les périodes, fuseaux, états de données manquantes, usages mobiles, exports et responsabilités de correction. Dans notre cas, l’expression chaque lundi laisse ouverte une question de jours fériés et d’heure de disponibilité. Une petite note d’exploitation peut régler ce point avant qu’un utilisateur ne découvre le problème en situation réelle. Limitez cependant les questions aux décisions qui influencent le projet : une longue liste générique peut noyer les trois ambiguïtés qui bloquent réellement l’avancement.

Attribuez également un propriétaire à chaque question ouverte et une date de réponse attendue. Une ambiguïté sur le filtre d’agence doit aller au responsable métier, tandis qu’une question d’emplacement de source va à son exploitant. Cette orientation évite qu’une liste générée soit simplement annexée au dossier sans être traitée. La clarification devient une action suivie plutôt qu’un commentaire supplémentaire.

Exercice corrigé : identifier trois décisions manquantes

Exercice : un passage dit nous voulons comparer la satisfaction des agences et voir celles qui baissent. Un fichier contient 20 réponses pour Nord, dont 16 favorables, et deux réponses pour Sud, toutes deux favorables. Demandez quelles informations manquent avant de classer les agences. Notez aussi les deux taux observés. L’enjeu est de distinguer calcul possible et interprétation défendable, sans inventer une règle de qualité ou de confidentialité que personne n’a encore approuvée.

Corrigé : Nord affiche 80 % et Sud 100 %, mais il faut au minimum définir favorable, fixer la période comparable et décider du traitement des petits effectifs. Le volume de réponses doit apparaître pour éviter une comparaison trompeuse. Il manque aussi une référence antérieure pour conclure qu’une agence baisse. Une proposition de seuil minimal peut être discutée, mais doit rester marquée comme proposition. Le document ne permet pas d’affirmer que Sud offre un meilleur service, ni de déterminer une tendance.

Livrer une analyse traçable et garder la décision humaine

La sortie finale comprend la matrice revue, les définitions approuvées, les questions ouvertes, les décisions prises et les exemples de recette. Gardez aussi la version du document source et la date de l’analyse. Le prompt et le nom du service utilisé peuvent être conservés dans le dossier de travail autorisé, sans y ajouter de données inutiles. Une autre personne doit pouvoir comprendre pourquoi une ligne existe et quelles preuves permettraient de la modifier.

Pour poursuivre l’atelier, donnez à Claude une version révisée de deux passages et demandez uniquement l’impact sur les exigences existantes. Vérifiez qu’aucune décision validée n’est effacée silencieusement et que les nouvelles interprétations restent identifiées. Vous obtenez ainsi un usage de l’IA centré sur la clarification et la préparation du travail. La responsabilité du besoin, des droits et des engagements reste attribuée aux personnes compétentes, ce qui rend la future réalisation plus lisible pour les développeurs comme pour les utilisateurs.

Références

Retour au blog →