Rédigé par Robin

Anatomie d’un bon prompt

Le contexte qu’on a appris à construire dans la section précédente ? C’est le composant CONTEXTE de ce qu’on va voir ici. L’anatomie d’un prompt, c’est la formalisation de tout ce qu’on a vu jusqu’ici.

Un prompt efficace n’est pas une question bien formulée — c’est un brief.

Les 5 composants

┌─────────────────────────────────────────┐
│  1. RÔLE        Qui doit-il être ?      │
│  2. CONTEXTE    Quelle est la situation │
│  3. TÂCHE       Ce qu'il doit faire     │
│  4. FORMAT      Comment présenter       │
│  5. CONTRAINTES Ce qu'il ne faut pas    │
└─────────────────────────────────────────┘

Tous les composants ne sont pas toujours nécessaires — mais les avoir en tête te permet de construire des prompts bien meilleurs. Et ces composants ne changent pas selon les outils : que tu sois sur claude.ai, dans une API, ou dans Claude Code, tu les retrouveras. Ce qui change, c’est où tu les stockes.

Exemple déconstruit

Prompt basique :

“Écris un article sur le cloud computing”

Prompt avec les 5 composants :

“Tu es un rédacteur tech spécialisé dans la vulgarisation (rôle). Je prépare un article pour le blog interne de mon entreprise — les lecteurs sont des commerciaux sans background technique (contexte). Rédige un article d’introduction au cloud computing (tâche). Format : titre accrocheur, 3 sections avec sous-titres, 400 mots max (format). Évite le jargon, pas de code, pas d’analogies trop techniques (contraintes).”

La différence de résultat est immédiate.

Le composant le plus sous-estimé : le rôle

Donner un rôle à Claude change sa “perspective” sur le problème :

"Tu es un expert en cybersécurité" → réponses plus techniques et orientées risques
"Tu es un professeur qui explique à des débutants" → pédagogie, analogies, progression
"Tu es un avocat spécialisé en droit du travail français" → précision, nuances légales, prudence

Mini-POC — 15 minutes

Templates copiables

Debug

debug

J’ai ce bug : [colle l’erreur]

Contexte : [langage, version, ce que le code est censé faire]

Ce que j’ai déjà essayé : [tes tentatives]

[capture d’écran si le bug est visuel — UI cassée, erreur navigateur, comportement inattendu]

Identifie la cause racine et propose un fix minimal.

Review de code

review

Review ce code en te concentrant sur : [lisibilité / perf / sécurité / maintenabilité]

[colle le code]

Pour chaque problème : indique la ligne, explique pourquoi c’est un problème, propose une correction.

Expliquer un concept

expliquer

Explique [concept] comme si j’ai un background [ton background]. Utilise une analogie concrète, puis montre un exemple de code minimal. Ne dépasse pas 200 mots.

Rédiger une doc

doc

Rédige la documentation de cette fonction :

[colle la fonction]

Format : description courte (1 phrase), paramètres, valeur retournée, exemple d’utilisation.

Refactoring ciblé

refactoring

Refactorise ce code pour [objectif précis : lisibilité / réduire la duplication / extraire la logique métier].

Contraintes : [ne pas changer l’interface publique / garder la compatibilité avec X]

[colle le code]

Prochaine étape → Techniques avancées