Être spécifique — Construire avec l'API Claude

Deux types de consignes

Être spécifique ne veut pas dire écrire plus — ça veut dire écrire mieux. La nuance est importante, parce qu’un prompt long et vague reste vague : ce qui compte n’est pas le volume mais le nombre de décisions que vous prenez à la place du modèle.

Ces décisions se rangent en deux familles, et elles n’interviennent pas au même moment. Les premières portent sur le résultat — ce qu’il doit contenir, sa longueur, son format. Les secondes portent sur le chemin — comment réfléchir avant de répondre. On les confond souvent, alors qu’elles ne servent pas dans les mêmes situations :

Consignes sur la sortie (output guidelines) — Ce que vous attendez dans le résultat
Étapes de raisonnement (process steps) — Comment Claude doit réfléchir avant de répondre

1. Consignes sur la sortie

Ces consignes définissent les attributs concrets du résultat attendu : longueur, structure, format, contenu obligatoire.

Exemple : plan alimentaire pour athlètes

Prompt sans consignes spécifiques :

Cree un plan alimentaire quotidien pour un coureur de marathon.

Prompt avec consignes sur la sortie :

Cree un plan alimentaire quotidien pour un coureur de marathon.

Consignes :
- Indique les calories totales de chaque repas
- Detaille les macronutriments (proteines, glucides, lipides) en grammes
- Precise le timing de chaque repas par rapport a l'entrainement
- Respecte les restrictions alimentaires specifiees
- Indique les portions en grammes, pas en termes vagues ("un peu de", "une portion de")
- Propose 5 repas : petit-dejeuner, collation matin, dejeuner, collation apres-midi, diner

La différence est immédiate : Claude sait exactement quoi inclure dans sa réponse. Plus besoin de deviner.

Types de consignes sur la sortie

Catégorie	Exemples
Longueur	”Maximum 200 mots”, “3 paragraphes”, “5 bullet points”
Structure	”Tableau avec colonnes X, Y, Z”, “Liste numérotée”, “Format JSON”
Format	”Markdown”, “Code Python uniquement”, “CSV”
Attributs obligatoires	”Inclus les sources”, “Chaque point avec un exemple”, “Ajoute les prix”
Exclusions	”Pas d’introduction”, “Sans jargon technique”, “Ne répète pas la question”

2. Étapes de raisonnement

Pour les problèmes complexes, dire à Claude comment réfléchir avant de répondre améliore significativement la qualité.

Avant de proposer le plan alimentaire :
1. Identifie les besoins caloriques quotidiens en fonction du sport et de l'objectif
2. Determine la repartition optimale des macronutriments pour ce type d'effort
3. Verifie la compatibilite avec les restrictions alimentaires
4. Repartis les apports sur la journee en fonction du timing d'entrainement

Ces étapes forcent Claude à structurer sa réflexion avant de produire le résultat, et c’est exactement ce qui les rend efficaces sur les tâches de jugement : un modèle qui a énoncé ses critères avant de trancher produit un arbitrage bien plus solide que celui qui conclut directement. Le raisonnement devient aussi lisible — vous voyez sur quoi la conclusion repose, donc vous pouvez la contester.

Quand utiliser des étapes de raisonnement ?

Les étapes de raisonnement sont utiles pour les tâches qui demandent un jugement ou une analyse en plusieurs étapes :

Diagnostic / troubleshooting — “D’abord, identifie la cause possible. Ensuite, propose une solution.”
Prise de décision — “Compare les options selon les critères X, Y, Z avant de recommander.”
Analyse de texte — “D’abord, identifie le ton général. Puis, relève les arguments principaux.”
Génération complexe — “Planifie la structure avant de rédiger.”

Pour les tâches simples (traduction, reformulation, extraction), les consignes sur la sortie suffisent. Inutile d’ajouter des étapes de raisonnement si la tâche est directe.

Combiner les deux approches

Les deux familles se cumulent sans se gêner, parce qu’elles agissent à des moments différents : les étapes guident la réflexion, les consignes de sortie cadrent la restitution. C’est cette combinaison qui produit le saut de score mesuré juste après — et c’est aussi elle qui explique pourquoi un prompt bien construit paraît long : chaque phrase y retire une décision au hasard.

PROMPT_SPECIFIQUE = """Cree un plan alimentaire quotidien pour {nom_athlete},
athlete en {sport}, dont l'objectif est {objectif}.
Restrictions alimentaires : {restrictions}.

Avant de rediger le plan :
1. Calcule les besoins caloriques journaliers pour ce profil
2. Determine la repartition ideale proteines/glucides/lipides
3. Adapte le timing des repas au planning d'entrainement

Le plan doit :
- Comporter 5 repas (petit-dejeuner, collation, dejeuner, gouter, diner)
- Indiquer les calories et macros de chaque repas
- Preciser les quantites en grammes
- Respecter strictement les restrictions alimentaires
- Inclure le timing recommande (ex: "2h avant l'entrainement")
"""

L’impact mesurable

En combinant les consignes sur la sortie et les étapes de raisonnement, le score est passé de 3.92 à 7.86 sur 10 — soit presque le double.

Version	Technique	Score
V1 (naïf)	Aucune	2.32
V2 (clair et direct)	Clarté + verbes d’action	3.92
V3 (spécifique)	+ consignes sortie + étapes raisonnement	7.86

Le gain est de presque 4 points. C’est la technique qui a le plus d’impact dans la plupart des cas d’usage.

Points clés

Consignes sur la sortie : définissez longueur, structure, format, attributs obligatoires et exclusions
Étapes de raisonnement : guidez le processus de réflexion de Claude pour les tâches complexes
Utilisez toujours des consignes sur la sortie, quel que soit le prompt
Ajoutez des étapes de raisonnement uniquement pour les tâches complexes (diagnostic, décision, analyse multi-critères)
Combinez les deux pour un impact maximal
Impact mesuré : de 3.92 à 7.86, soit +3.94 points — c’est la technique la plus rentable