--- title: "Parler aux agents : le prompt engineering qui marche vraiment" description: "Briefer un agent de coding pour qu'il livre un travail excellent du premier coup - avec axiomes, cadrage, contradiction et spec sheets" type: "lesson" locale: "fr" course: "Fondations - De zéro à votre première app en ligne" number: "1.5" canonical: "https://agenticschool.dev/fr/cours/foundations/talking-to-agents-prompt-engineering-that-actually-works" datePublished: "2026-06-12" dateModified: "2026-06-12" --- # Parler aux agents : le prompt engineering qui marche vraiment - Course: Fondations - De zéro à votre première app en ligne - Lesson: 1.5 - Duration: 24 min - Level: einsteiger - Status: published - Canonical URL: https://agenticschool.dev/fr/cours/foundations/talking-to-agents-prompt-engineering-that-actually-works - Locale: fr > Briefer un agent de coding pour qu'il livre un travail excellent du premier coup - avec axiomes, cadrage, contradiction et spec sheets ## Summary Prompter un agent n'est pas de la magie, c'est du cadrage clair. Cette leçon transmet les techniques qui font vraiment bouger la qualité : écrire des axiomes et des contrats de projet, le cadrage budget illimité, demander délibérément la contradiction et transformer une idée vague en un spec sheet que l'agent peut exécuter sans deviner. ## What you learn - Axiomes et contrats : poser des règles non négociables pour que l'agent cesse de les redécider - Le cadrage budget illimité et demander la contradiction pour élever la qualité de l'output - Écrire un spec sheet qui transforme une idée vague en un briefing exécutable ## Vue d'ensemble Le plus grand bond de résultats, de loin, ne vient pas d'un meilleur modèle mais d'un meilleur briefing. Bien parler à un agent est une compétence de management : vous posez des règles claires, cadrez le travail sur la qualité plutôt que les raccourcis, invitez la contradiction et livrez une spécification au lieu d'une intuition. Cette leçon vous donne les schémas concrets qui séparent les sessions frustrantes des agents qui visent juste du premier coup. ## Ce que vous allez apprendre Vous allez apprendre à écrire des axiomes (règles non négociables), à utiliser le cadrage budget illimité qui empêche l'agent de couper les coins, à demander explicitement la contradiction pour que l'agent attrape vos erreurs, et à transformer une demande vague en un spec sheet avec objectif, contexte, contraintes et critères d'acceptation. ## Prérequis Un setup Claude Code ou Codex fonctionnel issu de la leçon précédente. Vous devez aussi vous souvenir des leçons sur le contexte : un excellent prompt consiste en partie à donner le bon contexte, pas seulement les bons mots. ## Le problème L'échec classique est le souhait d'une ligne : « construis-moi un site web ». L'agent doit deviner l'audience, la stack, le design, le périmètre et la définition de « fini », et il devine mal. Puis vous en voulez à l'IA. Le vrai problème est que vous avez briefé un prestataire en cinq mots et attendu une maison finie. Un bon prompting supprime la devinette. ## Les axiomes : poser les règles une fois Les axiomes sont des règles non négociables que vous posez d'avance pour que l'agent cesse de les redécider à chaque tâche. Au lieu de corriger la même chose dix fois, vous l'écrivez comme une règle. « Utilise toujours TypeScript. N'utilise jamais d'em-dashes. Chaque nouvelle fonctionnalité a besoin d'un test. Ne committe jamais de secrets. » Elles se lisent comme un contrat, et l'agent les traite comme des contraintes plutôt que des suggestions. Au Cours 2, vous les déplacerez dans un CLAUDE.md durable, mais même collées en haut d'une session, elles élèvent nettement la constance. - Formulez les règles en absolus : « Toujours... », « Jamais... », « Chaque... doit... ». - Couvrez le style, la stack, les tests, la sécurité et le ton - les choses que vous corrigez sans cesse. - Gardez-les courtes et sans ambiguïté ; un agent suit mieux une règle nette qu'un paragraphe plein de nuances. ## Le cadrage budget illimité Les agents, comme les collaborateurs juniors, tendent vers la réponse acceptable la plus rapide. Si vous voulez un travail de classe mondiale, il faut le dire. Cadrer la tâche comme si le budget et le temps étaient illimités - « fais la bonne chose pour la santé à long terme de ce projet, pas la facile ; ne coupe aucun coin » - élève mesurablement la qualité, parce que cela autorise l'agent à ajouter des tests, à traiter les cas limites et à refactoriser au lieu de visser le correctif le plus rapide. Cela sonne mou, mais cela déplace fiablement l'output de « ça marche techniquement » vers « c'est réellement bon ». ## Demander la contradiction Par défaut, un agent est complaisant et met volontiers en œuvre une mauvaise idée. La solution tient en une phrase : « Avant de commencer, dis-moi tout ce qui cloche dans ce plan, tout ce que j'ai manqué, et une meilleure approche s'il en existe une. » Cela fait de l'agent, au lieu d'un exécutant d'ordres, un conseiller. Il attrape des exigences manquantes, signale des failles de sécurité et propose des designs plus simples. Certains des moments les plus précieux du travail agentique viennent de ce que l'agent vous contredit - mais seulement si vous lui en donnez explicitement la permission. ## Pas à pas : écrire un spec sheet Un spec sheet est la différence entre un souhait vague et un briefing exécutable. Il n'a pas besoin d'être long. Quatre parties suffisent, et les écrire vous force à prendre les décisions que l'agent devinerait sinon. - Objectif : ce qui doit exister quand c'est fini, en une à deux phrases. - Contexte : la stack, les fichiers pertinents, les exemples à suivre et tout ce que l'agent ne peut pas déduire. - Contraintes : vos axiomes plus les limites propres à la tâche (pas de nouvelles dépendances, doit marcher sur mobile, et ainsi de suite). - Critères d'acceptation : une checklist concrète qui définit « fini », pour que vous et l'agent sachiez quand vous arrêter. ```markdown ## Objectif Un formulaire de contact sur la landing page qui m'envoie les saisies par e-mail. ## Contexte - Stack : ce projet Astro, styles existants dans src/styles. - Suis le style de bouton déjà utilisé dans la section hero. ## Contraintes - TypeScript uniquement. Pas de nouvelle librairie UI. - Ne jamais exposer la clé API e-mail dans le code client. - Ajouter un test pour la validation du formulaire. ## Critères d'acceptation - [ ] Le formulaire valide le nom et l'e-mail avant l'envoi. - [ ] L'envoi affiche un message de succès. - [ ] Le test de validation passe. ``` Un spec sheet minimal mais complet, à coller dans l'agent ## Erreurs fréquentes Les erreurs récurrentes : le souhait d'une ligne sans spec ; ne jamais poser d'axiomes, si bien que vous corrigez les mêmes choses à l'infini ; accepter la première réponse au lieu de demander la contradiction ; et bourrer le prompt de contexte non pertinent, ce qui déclenche le performance cliff de la leçon un. Les briefings serrés et structurés battent les longs et prolixes. ## ROI business La compétence de briefing est le multiplicateur sur tout le reste. Le même agent et le même modèle livrent un travail médiocre ou excellent selon le seul briefing, et un bon spec sheet transforme souvent trois tours frustrants en une livraison propre. Pour une fondatrice, c'est la façon la moins chère possible de tripler la valeur de chaque abonnement d'IA que vous payez déjà. ## Checklist Avant d'avancer, assurez-vous de pouvoir produire chacun de ces éléments sur demande, car chaque leçon ultérieure suppose que vous savez bien briefer un agent. - Une courte liste d'axiomes pour vos propres projets. - Une tâche cadrée sur la qualité avec les lignes budget illimité et contradiction. - Un spec sheet en quatre parties pour une vraie fonctionnalité. - Un sens honnête de quand votre prompt est trop long, pas trop court. ## Ressources Sauvegardez vos axiomes quelque part de réutilisable - vous les collerez dans un CLAUDE.md au Cours 2. Le template de brief de tâche d'agent dans la bibliothèque de ressources est un squelette de spec sheet prêt à copier. Ensuite, vous mettez tout cela en œuvre pour construire un vrai projet. ## Votre mission Prenez l'idée de projet que vous avez choisie il y a deux leçons et écrivez un spec sheet complet pour sa première fonctionnalité, incluant vos axiomes, le cadrage budget illimité et la demande de contradiction. Livrez-le à votre agent et remarquez à quel point le résultat est plus net qu'un prompt d'une ligne. ## Prochaine leçon Vous savez briefer un agent. Maintenant vous construisez quelque chose de réel. La prochaine leçon scaffolde un vrai projet, lance un Dev Server pour que vous le voyiez dans le navigateur, et le met sous version control avec Git et un repo GitHub privé. ## Transcript Prompter un agent n'est pas de la magie, c'est du cadrage clair. Cette leçon transmet les techniques qui font vraiment bouger la qualité : écrire des axiomes et des contrats de projet, le cadrage budget illimité, demander délibérément la contradiction et transformer une idée vague en un spec sheet que l'agent peut exécuter sans deviner.