Aller au contenu principal
Guide du prompting

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.

Fondamentaux

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.

Principe 1

Soyez specifique

Fournissez du contexte et des contraintes claires. Plus votre prompt est precis, plus la reponse sera pertinente.

exemple-principe-1.mdmarkdown
# 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."
Principe 2

Definissez un role

Donnez une identite a Claude pour cadrer ses reponses. Le role influence le niveau de detail, le vocabulaire et l'approche.

exemple-principe-2.mdmarkdown
"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."
Principe 3

Specifiez le format attendu

Indiquez clairement la structure de la reponse souhaitee : code, liste, tableau, JSON, markdown, etc.

exemple-principe-3.mdmarkdown
"Genere la reponse au format suivant :
1. Un resume en 2-3 phrases
2. Le code complet avec commentaires inline
3. Un tableau des dependances necessaires (nom | version | usage)
4. Les instructions d'installation etape par etape"
Principe 4

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.

exemple-principe-4.mdmarkdown
"Genere des noms de variables en suivant ce pattern :
Exemple 1 : utilisateur connecte → isUserLoggedIn
Exemple 2 : nombre de produits dans le panier → cartItemCount
Exemple 3 : date de derniere mise a jour → lastUpdatedAt
Maintenant, genere pour :
- formulaire en cours de soumission
- erreur de validation de l'email
- liste des commandes filtrees"
Principe 5

Iterez et affinez

Le prompting est un dialogue. Affinez progressivement vos demandes en fonction des reponses obtenues.

exemple-principe-5.mdmarkdown
# 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 Library
et les stories Storybook pour chaque variante"

La regle d'or

Imaginez que vous delegue une tache a un collegue brillant mais qui ne connait rien a votre projet. Que lui diriez-vous pour qu'il reussisse du premier coup ? C'est exactement ce qu'il faut dire a Claude.
Templates

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.

template-web-dev.txtmarkdown
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 chargement
Genere le code complet avec :
1. Le composant principal
2. Les types/interfaces TypeScript
3. Un exemple d'utilisation
4. Les tests unitaires (Vitest + Testing Library)

Comment personnaliser

Remplacez les elements entre [CROCHETS] par vos propres valeurs. Ajoutez ou retirez des sections selon vos besoins. Ce template est un point de depart, pas un format rigide.

Documentation

Pour generer de la documentation technique claire et structuree.

template-documentation.txtmarkdown
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 prerequis
3. Configuration
4. Guide de demarrage rapide (Quick Start)
5. Reference API (chaque fonction avec parametres, retour, exemple)
6. Exemples d'utilisation avances
7. FAQ et depannage
Conventions :
- 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

Remplacez les elements entre [CROCHETS] par vos propres valeurs. Ajoutez ou retirez des sections selon vos besoins. Ce template est un point de depart, pas un format rigide.

Automatisation

Pour creer des scripts et pipelines d'automatisation robustes.

template-automatisation.txtmarkdown
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 commente
2. Le fichier .env.example
3. Le README d'utilisation
4. Un exemple de cron/schedule si pertinent

Comment personnaliser

Remplacez les elements entre [CROCHETS] par vos propres valeurs. Ajoutez ou retirez des sections selon vos besoins. Ce template est un point de depart, pas un format rigide.

Analyse de donnees

Pour explorer, transformer et visualiser des donnees efficacement.

template-data-analysis.txtmarkdown
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, distributions
2. Nettoyage : gestion des outliers, normalisation, encodage
3. Analyse : [correlations / tendances / segmentation / prediction]
4. Visualisation : graphiques pertinents avec matplotlib/seaborn
Format 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

Remplacez les elements entre [CROCHETS] par vos propres valeurs. Ajoutez ou retirez des sections selon vos besoins. Ce template est un point de depart, pas un format rigide.

Creation de contenu

Pour rediger du contenu structure, engageant et optimise.

template-contenu.txtmarkdown
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 H2
4. Exemples concrets et donnees chiffrees
5. Conclusion avec call-to-action
SEO :
- Mot-cle principal : [mot-cle]
- Mots-cles secondaires : [mot-cle-2, mot-cle-3]
- Meta description (max 155 caracteres)
- Suggestions de liens internes
Contraintes :
- Pas de jargon inutile
- Phrases courtes (max 20 mots)
- Un paragraphe = une idee
- Inclure des listes a puces pour la lisibilite

Comment personnaliser

Remplacez les elements entre [CROCHETS] par vos propres valeurs. Ajoutez ou retirez des sections selon vos besoins. Ce template est un point de depart, pas un format rigide.
A eviter

Les erreurs courantes de prompting

Apprenez a reconnaitre et corriger les prompts inefficaces. Chaque exemple montre un avant/apres concret.

Trop vague

A ne pas faire
mauvais-prompt.mdmarkdown
"Fais-moi un site web"
A faire
bon-prompt.mdmarkdown
"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

Plus vous etes precis, moins vous aurez d'iterations a faire.

Pas de contexte

A ne pas faire
mauvais-prompt.mdmarkdown
"Corrige ce bug"
A faire
bon-prompt.mdmarkdown
"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

Donnez toujours le contexte : fichier, erreur exacte, comportement attendu vs obtenu.

Tout demander d'un coup

A ne pas faire
mauvais-prompt.mdmarkdown
"Cree-moi une app complete avec auth, dashboard, API, base de donnees, tests, CI/CD et deploiement"
A faire
bon-prompt.mdmarkdown
"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

Decomposez les gros projets en etapes. Une demande claire = une reponse precise.

Ne pas iterer

A ne pas faire
mauvais-prompt.mdmarkdown
"Ce n'est pas ce que je voulais" (sans plus de details)
A faire
bon-prompt.mdmarkdown
"Le composant est bien structure, mais j'aimerais 3 modifications :
1. Remplace le bouton bleu par un gradient teal-to-cyan
2. Ajoute une animation fadeIn au montage du composant
3. Le champ email doit valider le format en temps reel (pas seulement au submit)"

Conseil

Dites precisement ce qui est bien, ce qui ne va pas, et ce que vous voulez changer.
Avance

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.

prompt-chaining.mdmarkdown
# 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 rien
et que les tests passent. Suggere des ameliorations supplementaires si pertinent."

Pourquoi ca marche

Le chainage force Claude a se concentrer sur une seule tache a la fois. Chaque etape produit un resultat de meilleure qualite car le contexte est plus cible.

Orchestration multi-agents

Utilisez plusieurs agents specialises qui travaillent en parallele sur differents aspects d'un probleme.

multi-agent.mdmarkdown
# 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 securite
Une fois les tests ecrits, implemente le code pour les faire passer."

Parallelisme

Les agents independants peuvent travailler simultanement. Cela divise le temps de travail et apporte des perspectives differentes sur le meme probleme.

Workflows complexes avec agents

Combinez chainage, multi-agents et contexte persistant pour des workflows de production.

workflow-complet.mdmarkdown
# 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 echoue
2. 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 size
Corrige 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."
Secret weapon

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.mdmarkdown
# CLAUDE.md
## Projet
Nom : MonApp, Application SaaS de gestion de projet
Stack : Next.js 14, TypeScript, Tailwind CSS, Prisma, PostgreSQL
Repo : 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

Placez 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

Ne mettez jamais de secrets, tokens ou mots de passe dans votre CLAUDE.md. Ce fichier est souvent commite dans le repo et doit rester public-safe.

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.