Prompt d'agent IA pour une codebase
Ecris un prompt de codebase qui explique a l'agent comment lire, respecter l'architecture, editer proprement et verifier.
Reponse rapide
Un bon prompt de codebase definit architecture, contraintes d'edit, commandes de verification, frontieres securite et format de resume.
Quoi inclure
Inclus stack, regles de dossiers, frontieres data, auth, commandes de format, tests et comportement dans un worktree deja modifie.
Ce qu'il faut eviter
Evite les prompts vagues comme fais attention. Donne des contraintes concretes que l'agent peut respecter et verifier.
FAQ
Le prompt doit-il inclure les tests ?
Oui. L'agent doit connaitre les checks locaux exacts qui prouvent le changement.
Construire un prompt projet
Guides associés
CLAUDE.md : le guide de tout développeur
Un fichier markdown pour donner à Claude Code les conventions réelles de ton codebase et obtenir du code cohérent dès la première session.
Claude Code peut écrire du code propre dans un projet, puis sortir du code générique dans le suivant. Dans mon expérience, la différence vient souvent de CLAUDE.md . C'est le fichier qui évite de répéter les mêmes conventions à chaque session, et c'est une grosse partie de mon gain avec Claude Code. Ce que c'est CLAUDE.md est un fichier markdown que Claude Code lit au début de chaque session. Pense y comme le doc d'onboarding que tu donnerais à un prestataire senior le premier jour : stack, conventions, règles, contexte. Sans ça, Claude infère les patterns depuis ce qu'il voit dans le codebase. Parfois il tombe juste. Souvent non, surtout pour les conventions implicites que ton équipe connaît sans les avoir écrites. Avec un bon CLAUDE.md , Claude produit du code qui suit tes règles sans avoir besoin de le répéter à chaque fois. Quoi y mettre 1. Stack et…
Lire le guidePrompt, workflow ou agent : la différence
Tout le monde appelle tout ça des agents. En pratique, prompt, workflow et agent ne demandent pas la même architecture.
Le mot "agent" est partout. "Workflow" aussi. On mélange les deux, puis on se retrouve avec des systèmes impossibles à déboguer parce qu'on n'a pas nommé la bonne chose. Voilà le modèle mental que j'utilise. Pas la définition académique. La définition utile quand tu construis. Un prompt Un prompt est un seul appel à un LLM. Une entrée, une sortie. C'est tout. Pas de boucle. Pas de décision. Pas d'outils. Un aller retour. La plupart des fonctionnalités IA livrées en 2023 étaient des prompts. Un bon prompt peut déjà faire beaucoup. Mais il reste one shot et sans état. Un workflow Un workflow est une séquence d'étapes. Certaines peuvent appeler un LLM, mais l'ordre est prévu à l'avance. La structure est définie par le développeur, pas par le modèle. Exemple : un workflow de repurposing de contenu. 1. Recevoir un post LinkedIn (déclencheur) 2. Appeler Claude pour le réécrire en…
Lire le guideClaude Code Plan Mode : guide pratique
Le Plan Mode de Claude Code te laisse voir et ajuster le plan d'exécution avant qu'un seul fichier soit touché. Quand l'utiliser et comment en tirer le maximum.
Beaucoup de gens utilisent Claude Code comme un chat : ils décrivent la tâche et regardent l'exécution. Pour une petite modification, ça passe. Pour tout ce qui touche plusieurs fichiers, je préfère mettre un arrêt avant le diff. Le Plan Mode. Ce que fait le Plan Mode Quand tu actives le Plan Mode, Claude lit ton codebase et produit un plan d'exécution étape par étape, sans modifier de fichier. Tu vois ce qu'il compte faire avant qu'une ligne soit écrite. C'est un point de contrôle : tu valides le plan, tu le réorientes, ou tu corriges une hypothèse incorrecte avant qu'elle ne se propage en 15 mauvaises modifications. Comment l'activer Deux façons : Raccourci clavier : appuyer sur Shift+Tab avant d'envoyer ton message. L'input affiche un indicateur "Plan". Préfixe dans le message : commencer ton message par Plan: (P majuscule). Claude détecte l'intention et passe en mode plan uniquement. Claude…
Lire le guide