Aller au contenu
Mastering Claude

Accueil / Écrire une demande qui marche

Écrire une demande qui marche6 minFondation

Être clair, direct, et donner le pourquoi

Claude se comporte comme un nouvel employé brillant sans contexte implicite sur vos habitudes, donc une demande gagne à préciser le pourquoi et qui va lire ou entendre la réponse, pas seulement la tâche à accomplir.

Claude se comporte comme un nouvel employé brillant qui ne connaît ni vos habitudes ni votre secteur. La documentation de Claude le dit en ces termes : pensez à Claude comme à un employé brillant mais nouveau, qui manque de contexte sur vos normes et vos façons de faire, et plus vous expliquez précisément ce que vous voulez, meilleur est le résultat. Une demande brève peut sembler claire à son auteur tout en reposant sur un contexte que Claude n'a jamais reçu.

Le test du collègue

La même documentation propose un test concret pour vérifier qu'une demande est assez claire : montrez votre demande à un collègue qui n'a presque aucun contexte sur la tâche, et demandez-lui de la suivre à la lettre. S'il est perdu, Claude le sera aussi. Ce test fonctionne parce qu'il déplace le jugement hors de sa propre tête : on comprend en général sa propre demande sans effort, précisément parce qu'on connaît déjà le contexte qui manque à l'écrit.

Donner le pourquoi, pas seulement la tâche

Préciser la tâche ne suffit pas toujours. Fournir le contexte ou la motivation derrière une instruction, en expliquant pourquoi tel comportement compte, aide Claude à mieux comprendre l'objectif et à produire des réponses plus ciblées. La documentation illustre ce point par un exemple concret : une demande qui dit de retirer les points de suspension d'un texte laisse deviner pourquoi. Une demande qui ajoute que le texte sera lu à voix haute par un moteur de synthèse vocale, lequel ne sait pas prononcer ce signe, oriente Claude vers une reformulation qui garde le rythme des phrases plutôt que vers une simple suppression mécanique.

Version faible :
Retirez les points de suspension de ce texte.

Version avec le pourquoi et le destinataire :
Ce texte sera lu à voix haute par un moteur de synthèse vocale qui ne sait pas prononcer les points de suspension. Reformulez les phrases concernées pour garder leur rythme sans ce signe.

La même logique vaut pour qui va lire ou entendre la réponse. Un compte rendu destiné au bureau d'une association n'appelle pas le même niveau de détail qu'un message destiné à un nouvel adhérent qui découvre le sujet. Nommer ce destinataire dans la demande, une phrase suffit souvent, évite à Claude de deviner un niveau de langage à la place de l'écrire noir sur blanc, en s'appuyant sur les trois blocs d'une demande déjà posés.

Une demande claire et une demande qui donne le pourquoi ne sont pas deux étapes séparées à exécuter l'une après l'autre : elles se vérifient ensemble, avec le même test du collègue, en une seule relecture avant d'envoyer le message.

Figure 1

Même tâche, avec et sans le pourquoi

Sans le pourquoi ni le destinataire
Rédigez un message pour annoncer le changement d'horaires de la permanence.
Avec le pourquoi et le destinataire
Rédigez un message pour annoncer le changement d'horaires de la permanence, destiné aux adhérents qui découvrent tout juste le nouveau local ; expliquez que le changement vient d'une contrainte de bail, pour éviter les questions répétées au téléphone.
À gauche, la tâche seule. À droite, la même tâche accompagnée du pourquoi et du destinataire visé, deux précisions qui orientent la réponse produite.
Calibrez vous-même

Une trésorière écrit à Claude une demande de sept mots pour reformuler un paragraphe d'un rapport financier. Claude répond par une reformulation en langage très technique, avec plusieurs termes comptables. Elle relit la réponse, puis réécrit sa demande en précisant que le rapport sera lu par des adhérents bénévoles qui découvrent les comptes chaque année. Claude produit une seconde reformulation qui remplace les termes comptables par des explications courantes.

Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.

Ce qu’il faut retenir
  • Le test du collègue consiste à montrer sa demande à une personne qui ignore presque tout du sujet, puis à vérifier qu'elle saurait la suivre à la lettre.
  • Expliquer pourquoi un comportement compte oriente Claude vers une meilleure solution, comme reformuler une phrase plutôt que simplement supprimer un signe qu'un moteur de synthèse vocale ne sait pas prononcer.
  • Nommer qui lira ou entendra la réponse, en une phrase, évite à Claude de deviner un niveau de langage à la place de l'écrire.
  • Une consigne qui paraît évidente pour son auteur peut rester obscure pour Claude, faute d'un contexte qu'il n'a reçu nulle part ailleurs dans la conversation.
À faire maintenant

Reprenez une demande récente que vous avez adressée à Claude sans préciser qui la lirait, ajoutez en une phrase le destinataire et le pourquoi, reposez la question et comparez les deux réponses obtenues.

Vérifier à la source

Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.