Pourquoi le prompt est de l'ingénierie, pas de l'art

Le malentendu de départ

Le « prompt engineering » est souvent vendu comme un don, une intuition magique. C'est faux, et ça coûte cher : tant que tu crois que prompter est de l'art, tu ne mesures pas, tu ne reproduis pas, tu ne corriges pas.

La doc officielle d'Anthropic est explicite sur un point que la plupart des gens sautent : avant même d'optimiser un prompt, il faut trois choses.

« This guide assumes that you have: 1. A clear definition of the success criteria for your use case. 2. Some ways to empirically test against those criteria. 3. A first draft prompt you want to improve. »

Traduction opérationnelle :

1. Un critère de succès défini. Pas « une bonne réponse ». Quelque chose de testable : « extrait les 5 risques, format JSON, zéro champ inventé ».
2. Un moyen de tester contre ce critère. Même artisanal : 5 entrées types, le résultat attendu pour chacune.
3. Un premier jet de prompt à améliorer, pas une page blanche.

Si tu n'as pas 1 et 2, tu ne fais pas de prompt engineering. Tu tâtonnes.

La règle d'or d'Anthropic

C'est la phrase la plus utile de toute la doc, et elle tient en une ligne :

« Show your prompt to a colleague with minimal context on the task and ask them to follow it. If they'd be confused, Claude will be too. »

Le bon modèle mental, toujours selon Anthropic : traite Claude comme « un collègue brillant mais nouveau, qui n'a aucun contexte sur tes normes et tes process ». Il est compétent. Il ne lit pas dans tes pensées.

Ce que ce parcours couvre

On suit l'ordre de priorité de la doc officielle, traduit en méthode :

1. Être clair et direct — et cadrer le périmètre
2. Donner le contexte et le pourquoi
3. Piloter par l'exemple (few-shot), sans en abuser
4. Structurer avec des balises XML, et tenir le contexte long
5. Donner un rôle et contrôler la sortie
6. Régler l'effort de raisonnement plutôt que scripter le raisonnement
7. Chaîner quand c'est vraiment utile — et arrêter de demander une vérification finale

Chaque leçon : la technique officielle, des prompts copiables, un ou deux anti-patterns observés, un défi sur ton propre travail.

Ce qui a changé en 2026, et pourquoi ça compte dès maintenant

Ce parcours est à jour au 6 août 2026 pour la gamme actuelle : Claude Fable 5, Claude Opus 5, Claude Sonnet 5 et Claude Haiku 4.5. Le socle n'a pas bougé — clarté, contexte, exemples, balises. En revanche, une partie des conseils de la génération précédente s'est purement et simplement inversée.

Le fait qui résume tout : Anthropic a retiré plus de 80 % du system prompt de Claude Code pour les modèles avancés (Opus 5, Fable 5) sans perte de performance mesurable. Autrement dit, l'essentiel de ce qu'on écrivait « pour être sûr » ne servait déjà plus à rien — et parfois nuisait.

Une phrase de l'article vaut la peine d'être retenue telle quelle : « Une maquette HTML d'un design donnera généralement de meilleurs résultats qu'une description. » Le meilleur prompt est parfois un fichier, pas un paragraphe.

Les trois conseils devenus faux

Tu vas les croiser partout : articles de 2025 jamais mis à jour, threads recopiés, formations concurrentes. Les voici, pour que tu les repères tout de suite.

1. « Ajoute une étape de vérification finale » / « fais vérifier par un sous-agent » / « double-check ta réponse ». La doc Prompting Claude Opus 5 demande explicitement de supprimer ces instructions : le modèle vérifie déjà son travail seul, et la consigne provoque de la sur-vérification — plus lent, plus cher, pas meilleur. C'est le sujet de la leçon 7.
2. « Charge tout le contexte d'avance, répète les instructions, multiplie les exemples ». Inversé : divulgation progressive, descriptions épurées, meilleures interfaces d'outils.
3. « Un fichier d'instructions riche et exhaustif est un atout ». Garde-le léger, et déplace le spécialisé ailleurs (skills, documents de référence appelés au besoin).

Deux détails de plomberie que beaucoup de contenus ratent encore :

• Le prefill de la dernière réponse assistant (forcer le début de la réponse de Claude) n'est plus supporté depuis Claude 4.6 et renvoie une erreur 400. On verra en leçon 6 par quoi le remplacer.
• Les liens de doc ont déménagé : docs.claude.com/en/docs/… redirige désormais vers platform.claude.com/docs/en/….

La bonne posture pour la suite

Ce n'est pas un parcours de recettes à apprendre par cœur. C'est une méthode : tu définis un critère, tu testes, tu changes une chose à la fois. C'est la seule chose qui survit à un changement de modèle — et il y en a eu plusieurs en six mois.

Sources · Doc officielle Anthropic, Prompting best practices : platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices et …/prompt-engineering/overview. Page par modèle Prompting Claude Opus 5 : platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5. Article The new rules of context engineering for Claude 5 generation models (24/07/2026) : claude.com/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models. Nouveautés du modèle : platform.claude.com/docs/en/about-claude/models/whats-new-opus-5. Tutoriel interactif : github.com/anthropics/prompt-eng-interactive-tutorial. Contenu revérifié le 6 août 2026 pour la gamme Claude Fable 5 / Opus 5 / Sonnet 5 / Haiku 4.5.