L'art du prompting
avec Claude Code
Maitrisez l'art de communiquer avec l'IA. Un bon prompt fait la difference entre une reponse generique et un resultat exactement adapte a vos besoins.
Les 5 principes du bon prompting
Ces principes sont la base de toute interaction efficace avec Claude Code. Maitrisez-les et vous obtiendrez des resultats 10x meilleurs.
Soyez specifique
Fournissez du contexte et des contraintes claires. Plus votre prompt est precis, plus la reponse sera pertinente.
# Vague"Fais-moi un formulaire"# Specifique"Cree un formulaire de contact en React avec TypeScript.Champs : nom (requis), email (requis, valide), message (requis, min 20 caracteres).Utilise react-hook-form avec validation Zod.Style avec Tailwind CSS, responsive mobile-first.Affiche un toast de confirmation apres envoi."
Definissez un role
Donnez une identite a Claude pour cadrer ses reponses. Le role influence le niveau de detail, le vocabulaire et l'approche.
"Tu es un architecte logiciel senior specialise en React et Next.js.Tu privilegies la maintenabilite, la performance et les bonnes pratiques.Tu commentes ton code en francais et tu expliques chaque decision d'architecture."
Specifiez le format attendu
Indiquez clairement la structure de la reponse souhaitee : code, liste, tableau, JSON, markdown, etc.
"Genere la reponse au format suivant :1. Un resume en 2-3 phrases2. Le code complet avec commentaires inline3. Un tableau des dependances necessaires (nom | version | usage)4. Les instructions d'installation etape par etape"
Donnez des exemples (few-shot)
Montrez a Claude ce que vous attendez avec des exemples concrets. C'est la technique la plus puissante pour obtenir le format exact souhaite.
"Genere des noms de variables en suivant ce pattern :Exemple 1 : utilisateur connecte → isUserLoggedInExemple 2 : nombre de produits dans le panier → cartItemCountExemple 3 : date de derniere mise a jour → lastUpdatedAtMaintenant, genere pour :- formulaire en cours de soumission- erreur de validation de l'email- liste des commandes filtrees"
Iterez et affinez
Le prompting est un dialogue. Affinez progressivement vos demandes en fonction des reponses obtenues.
# Iteration 1"Cree un composant Button"# Iteration 2"Ajoute les variantes : primary, secondary, ghost et danger"# Iteration 3"Ajoute le support des icones a gauche et a droite,un etat loading avec un spinner, et la prop disabled"# Iteration 4"Ajoute les tests unitaires avec Testing Libraryet les stories Storybook pour chaque variante"
La regle d'or
Prompts prets a l'emploi
Copiez, adaptez et utilisez ces templates pour vos projets. Chaque template suit les 5 principes et a ete optimise pour obtenir les meilleurs resultats.
Developpement web
Pour creer des composants, des pages ou des fonctionnalites web completes.
Tu es un developpeur senior React/Next.js/TypeScript.Cree un composant React qui [DESCRIPTION DU COMPOSANT].Contexte technique :- Framework : Next.js 14 (App Router)- Langage : TypeScript (strict mode)- Style : Tailwind CSS- State management : [zustand / React Context / aucun]Specifications fonctionnelles :- [Fonctionnalite 1]- [Fonctionnalite 2]- [Fonctionnalite 3]Contraintes :- Responsive mobile-first- Accessible (ARIA, focus management)- Performance optimisee (memo, lazy loading si necessaire)- Gestion des erreurs et etats de chargementGenere le code complet avec :1. Le composant principal2. Les types/interfaces TypeScript3. Un exemple d'utilisation4. Les tests unitaires (Vitest + Testing Library)
Comment personnaliser
Documentation
Pour generer de la documentation technique claire et structuree.
Tu es un redacteur technique senior.Redige la documentation technique pour [NOM DU PROJET/MODULE].Public cible : [developpeurs juniors / equipe interne / open-source]Structure attendue :1. Vue d'ensemble (2-3 phrases)2. Installation et prerequis3. Configuration4. Guide de demarrage rapide (Quick Start)5. Reference API (chaque fonction avec parametres, retour, exemple)6. Exemples d'utilisation avances7. FAQ et depannageConventions :- Exemples de code en [TypeScript/Python/etc.]- Tous les snippets doivent etre copiables et fonctionnels- Utilise des admonitions (note, warning, tip) quand pertinent- Inclus un sommaire navigable en debut de document
Comment personnaliser
Automatisation
Pour creer des scripts et pipelines d'automatisation robustes.
Tu es un ingenieur DevOps/SRE senior.Cree un script qui automatise [DESCRIPTION DE LA TACHE].Environnement :- OS : [Linux/macOS/Windows]- Langage : [Bash/Python/Node.js]- Outils disponibles : [Docker, GitHub Actions, etc.]Fonctionnement attendu :1. [Etape 1 du processus]2. [Etape 2 du processus]3. [Etape 3 du processus]Exigences :- Gestion d'erreurs robuste (exit codes, try/catch)- Logging avec niveaux (info, warn, error)- Mode dry-run pour tester sans executer- Variables configurables via .env ou arguments CLI- Idempotent (peut etre relance sans effet de bord)Genere :1. Le script complet et commente2. Le fichier .env.example3. Le README d'utilisation4. Un exemple de cron/schedule si pertinent
Comment personnaliser
Analyse de donnees
Pour explorer, transformer et visualiser des donnees efficacement.
Tu es un data analyst senior expert en Python.Analyse ce dataset CSV et [OBJECTIF DE L'ANALYSE].Informations sur les donnees :- Source : [description de la source]- Colonnes principales : [col1, col2, col3, ...]- Volume : [nombre de lignes approximatif]- Periode : [plage temporelle des donnees]Analyse demandee :1. Exploration : statistiques descriptives, valeurs manquantes, distributions2. Nettoyage : gestion des outliers, normalisation, encodage3. Analyse : [correlations / tendances / segmentation / prediction]4. Visualisation : graphiques pertinents avec matplotlib/seabornFormat de sortie :- Code Python complet (pandas, numpy, matplotlib)- Commentaires expliquant chaque etape- Interpretation des resultats en langage non-technique- Recommandations basees sur les insights
Comment personnaliser
Creation de contenu
Pour rediger du contenu structure, engageant et optimise.
Tu es un redacteur web senior specialise en [DOMAINE].Redige un article de blog sur [SUJET].Parametres :- Ton : [professionnel / decontracte / pedagogique]- Longueur : [800-1200 mots]- Public cible : [description du lecteur type]- Objectif : [informer / convaincre / tutoriel]Structure :1. Titre accrocheur (max 60 caracteres)2. Introduction avec hook (probleme/question)3. 3-5 sections avec sous-titres H24. Exemples concrets et donnees chiffrees5. Conclusion avec call-to-actionSEO :- Mot-cle principal : [mot-cle]- Mots-cles secondaires : [mot-cle-2, mot-cle-3]- Meta description (max 155 caracteres)- Suggestions de liens internesContraintes :- Pas de jargon inutile- Phrases courtes (max 20 mots)- Un paragraphe = une idee- Inclure des listes a puces pour la lisibilite
Comment personnaliser
Les erreurs courantes de prompting
Apprenez a reconnaitre et corriger les prompts inefficaces. Chaque exemple montre un avant/apres concret.
Trop vague
"Fais-moi un site web"
"Cree une landing page pour une app SaaS de gestion de projet.Stack : Next.js 14, TypeScript, Tailwind CSS.Sections : hero avec CTA, features (3 colonnes), pricing (3 plans), FAQ accordion.Design : moderne, dark mode, animations subtiles au scroll."
Conseil
Pas de contexte
"Corrige ce bug"
"J'ai une erreur 'TypeError: Cannot read property map of undefined'dans mon composant ProductList.tsx (ligne 42).Ce composant recoit un prop 'products' depuis une API REST.L'erreur apparait uniquement au premier rendu, avant que l'API reponde.Voici le composant : [code]"
Conseil
Tout demander d'un coup
"Cree-moi une app complete avec auth, dashboard, API, base de donnees, tests, CI/CD et deploiement"
"Commencons par la base de donnees.Cree le schema Prisma pour une app de gestion de taches avec :- Table User (id, email, name, createdAt)- Table Project (id, name, ownerId, createdAt)- Table Task (id, title, status, projectId, assigneeId, dueDate)Relations : User 1-N Project, Project 1-N Task, User 1-N Task"
Conseil
Ne pas iterer
"Ce n'est pas ce que je voulais" (sans plus de details)
"Le composant est bien structure, mais j'aimerais 3 modifications :1. Remplace le bouton bleu par un gradient teal-to-cyan2. Ajoute une animation fadeIn au montage du composant3. Le champ email doit valider le format en temps reel (pas seulement au submit)"
Conseil
Prompting avance pour power users
Allez au-dela des bases avec des techniques qui exploitent toute la puissance de Claude Code.
Prompt chaining (chainage multi-etapes)
Decomposez une tache complexe en une sequence de prompts ou chaque etape alimente la suivante.
# Etape 1 : Analyse"Analyse ce codebase et identifie les problemes de performance.Liste chaque probleme avec : fichier, ligne, severite, description."# Etape 2 : Priorisation (utilise la sortie de l'etape 1)"A partir de cette liste de problemes, cree un plan d'action priorise.Criteres : impact utilisateur, complexite de correction, risque de regression."# Etape 3 : Implementation (utilise la sortie de l'etape 2)"Implemente la correction du probleme #1 : [description].Genere le code corrige, les tests de non-regression, et un benchmark avant/apres."# Etape 4 : Validation"Revois les corrections appliquees. Verifie qu'elles ne cassent rienet que les tests passent. Suggere des ameliorations supplementaires si pertinent."
Pourquoi ca marche
Orchestration multi-agents
Utilisez plusieurs agents specialises qui travaillent en parallele sur differents aspects d'un probleme.
# Dans votre CLAUDE.md, definissez des agents specialises :## Agents disponibles| Agent | Role | Quand l'utiliser ||----------------|-----------------------------|-------------------------------|| planner | Planification | Avant toute feature complexe || tdd-guide | Test-Driven Development | Nouvelles features, bug fixes || code-reviewer | Revue de code | Apres chaque implementation || security-check | Analyse de securite | Avant chaque commit || architect | Decisions d'architecture | Choix techniques importants |# Exemple d'utilisation dans un prompt :"Utilise l'agent planner pour decomposer cette feature en taches.Puis lance en parallele :- Agent 1 (tdd-guide) : ecrit les tests pour le module auth- Agent 2 (tdd-guide) : ecrit les tests pour le module API- Agent 3 (security-check) : analyse les implications securiteUne fois les tests ecrits, implemente le code pour les faire passer."
Parallelisme
Workflows complexes avec agents
Combinez chainage, multi-agents et contexte persistant pour des workflows de production.
# Workflow complet : nouvelle feature du planning a la production## Phase 1 : Recherche et planification"Recherche les implementations existantes de [feature] sur GitHub.Evalue les 3 meilleures options selon : securite, extensibilite, pertinence.Genere un plan d'implementation detaille avec phases et risques."## Phase 2 : TDD (Test-Driven Development)"En suivant le plan, ecris d'abord les tests (RED).Pour chaque module :1. Ecris le test → verifie qu'il echoue2. Ecris l'implementation minimale → verifie qu'il passe (GREEN)3. Refactorise → verifie que tout passe toujours (REFACTOR)"## Phase 3 : Revue et securite"Lance en parallele :- Code review : qualite, patterns, maintenabilite- Security review : injections, auth, secrets, XSS- Performance review : N+1, memory leaks, bundle sizeCorrige les issues CRITICAL et HIGH avant de continuer."## Phase 4 : Integration et deploiement"Cree la PR avec un resume complet des changements.Verifie que le CI passe. Deploie en staging pour validation."
CLAUDE.md : Votre arme secrete
Le fichier CLAUDE.md est le contexte persistant que Claude Code lit a chaque session. C'est la cle pour obtenir des resultats coherents et adaptes a votre projet.
Structure d'un CLAUDE.md efficace
Un bon CLAUDE.md transforme Claude en un membre de votre equipe qui connait votre projet sur le bout des doigts.
# CLAUDE.md## ProjetNom : MonApp, Application SaaS de gestion de projetStack : Next.js 14, TypeScript, Tailwind CSS, Prisma, PostgreSQLRepo : monorepo avec apps/ (web, api) et packages/ (ui, utils, config)## Conventions de code- Immutabilite : toujours creer de nouveaux objets, jamais muter- Fichiers < 400 lignes, fonctions < 50 lignes- Nommage : camelCase (variables), PascalCase (composants), kebab-case (fichiers)- Commentaires en francais, code en anglais- Gestion d'erreurs explicite a chaque niveau## Architecture- Feature-based : src/features/[feature]/{components,hooks,utils,types}- Repository pattern pour l'acces aux donnees- API responses : { success, data, error, meta }## Tests- Minimum 80% de couverture- TDD obligatoire : RED → GREEN → REFACTOR- Stack : Vitest + Testing Library + MSW pour les mocks API## Git- Conventional commits : feat:, fix:, refactor:, test:, docs:- PR avec description detaillee et test plan- Jamais de push force sur main## Securite- Pas de secrets en dur, utiliser .env- Validation des inputs a toutes les frontieres- Requetes parametrees (pas de concatenation SQL)## Agents| Agent | Usage ||-------|-------|| planner | Avant toute feature complexe || tdd-guide | Nouvelles features, corrections || code-reviewer | Apres chaque implementation || security-reviewer | Avant chaque commit |
Ou placer le fichier
CLAUDE.md a la racine de votre projet. Claude Code le lit automatiquement au debut de chaque session. Vous pouvez aussi avoir des fichiers CLAUDE.md par dossier pour du contexte specifique a un module.Attention
Les 3 niveaux de CLAUDE.md
Global
~/.claude/CLAUDE.md
Preferences personnelles appliquees a tous vos projets (langue, style, conventions generales).
Projet
./CLAUDE.md
Contexte specifique au projet : stack, architecture, conventions d'equipe, agents configures.
Module
./src/features/auth/CLAUDE.md
Contexte ultra-specifique pour un module : schema, API, contraintes metier particulieres.
Continuez votre apprentissage
Le prompting est une competence qui s'ameliore avec la pratique. Explorez les autres guides pour devenir un expert de Claude Code.
Demarrer avec Claude Code
Installation, configuration et premiers pas pour bien commencer.
Lire le guideLes MCP en detail
Connectez Claude Code a Gmail, GitHub, Slack et des dizaines d'autres outils.
Explorer les MCPCreer des Skills
Automatisez vos workflows avec des Skills personnalises et reutilisables.
Decouvrir les Skills