Aller au contenu

LEÇON OFFERTE · MODULE 03

La structure d’un bon prompt

Un vrai extrait de la formation. Apprenez à formuler une demande précise, comparez trois exemples et repartez avec un modèle à utiliser sur votre projet.

12 min de lecture100 % écritSans inscription

La qualité de ce que produit Claude Code dépend directement de la qualité de vos demandes. Un bon prompt n'est pas une formule magique : c'est une spécification courte et claire. Cette leçon vous donne une structure réutilisable.

Les 6 éléments d'un bon prompt

  1. Objectif : ce que vous voulez obtenir, en une phrase.
  2. Contexte : le projet, la stack, les fichiers concernés, ce qui existe déjà.
  3. Comportement attendu : ce que l'utilisateur doit voir et pouvoir faire.
  4. Contraintes : sécurité, conventions, bibliothèques à utiliser ou à éviter.
  5. Critères de réussite : comment savoir que c'est terminé (tests, commandes, vérifications).
  6. Mode de travail : plan d'abord ? une étape à la fois ? questions avant de coder ?

Exemple : une page de connexion

Mauvais prompt

Fais une page de connexion.

Pourquoi c'est insuffisant : quel framework ? quel système d'authentification ? quels champs ? que se passe-t-il après la connexion ? en cas d'erreur ? L'IA va deviner, et vous passerez plus de temps à corriger qu'à décrire.

Meilleur prompt

Crée une page de connexion avec email et mot de passe en utilisant Supabase Auth. Après la connexion, redirige vers /dashboard. Affiche un message d'erreur si les identifiants sont incorrects.

C'est mieux : la technologie, les champs, la redirection et le cas d'erreur sont précisés. Il manque encore le contexte du projet, les contraintes de sécurité et les critères de réussite.

Excellent prompt

Objectif : ajouter la connexion par email et mot de passe.

Contexte : projet Next.js (App Router, TypeScript strict), Tailwind et shadcn/ui. Supabase est déjà configuré : clients dans src/lib/supabase/server.ts et src/lib/supabase/client.ts. La page d'inscription src/app/register/page.tsx existe : reprends son style.

Comportement attendu :

  • page /login avec les champs email et mot de passe, et un lien « Mot de passe oublié ? » ;
  • validation des champs avec Zod (email valide, mot de passe non vide) ;
  • connexion via une Server Action avec signInWithPassword ;
  • en cas de succès, redirection vers /dashboard ;
  • en cas d'échec, message générique « Email ou mot de passe incorrect » (ne pas révéler si l'email existe) ;
  • si l'email n'est pas confirmé, message invitant à vérifier sa boîte mail ;
  • bouton désactivé pendant l'envoi.

Contraintes : aucune clé secrète côté client ; textes en français ; accessible (labels, focus visible, messages d'erreur liés aux champs).

Critères de réussite : npm run lint et npx tsc --noEmit passent ; je peux me connecter avec un compte de test et je suis redirigé ; un mauvais mot de passe affiche le message d'erreur.

Mode de travail : présente d'abord ton plan et la liste des fichiers que tu vas créer ou modifier, puis attends ma validation.

Ce prompt est plus long, mais il fait gagner un temps considérable : moins d'allers-retours, un résultat cohérent avec l'existant, et des critères clairs pour vérifier.

Faut-il toujours écrire des prompts aussi longs ?

Non. Adaptez la précision au risque et à la taille de la tâche :

  • Petite retouche (changer une couleur, corriger une faute) : une phrase suffit.
  • Nouvelle fonctionnalité : objectif, contexte, comportement, critères.
  • Sujet sensible (paiement, permissions, données personnelles) : tout, y compris les contraintes de sécurité et les tests.

À retenir

  • Objectif, contexte, comportement, contraintes, critères de réussite, mode de travail.
  • Plus la tâche est risquée, plus le prompt doit être précis.
  • Demandez un plan avant l'exécution pour les tâches importantes.

À vous de jouer · 10 minutes

Transformez votre idée en premier prompt.

Choisissez une petite fonctionnalité : un formulaire de contact, une liste de tâches ou une prise de rendez-vous. Complétez le modèle, puis vérifiez que chaque critère peut être testé.

OBJECTIF
Je veux créer : …

CONTEXTE
Mon public : …
Mon projet et les outils déjà installés : …

COMPORTEMENT ATTENDU
L’utilisateur doit pouvoir : …
En cas d’erreur : …

CONTRAINTES
Ne pas exposer de clés secrètes. Vérifier les permissions côté serveur.

CRITÈRES DE RÉUSSITE
Je vérifierai que : …

MODE DE TRAVAIL
Propose un plan, identifie les informations manquantes, puis avance par petites étapes vérifiables.

Comment vérifier votre réponse ?

Votre prompt nomme un utilisateur, une action observable, un cas d’erreur et un test précis. « Faire un beau site » reste vague. « Le formulaire refuse un email invalide, conserve les autres champs et affiche une erreur lisible au clavier » est vérifiable. Si une information manque, demandez à l’IA de poser une question avant de coder.

Vos choix en matière de cookies

Nous utilisons des cookies nécessaires au fonctionnement du site. Avec votre accord, nous utilisons aussi des mesures d'audience et d'attribution des campagnes. Vous pouvez changer d'avis à tout moment. Politique cookies