La qualité du code généré par IA depend presque entièrement de ce que vous demandez et comment vous le demandez. Ce guide couvre les patterns qui produisent systematiquement de meilleurs résultats avec Claude Code.
Du cadrage des tâches aux system prompts, de l'iteration progressive aux instructions spécifiques par rôle. Des techniques concretes applicables des votre prochaine session de code.
Quand vous demandez a un développeur humain de 'construire une page de connexion', il pose des questions de clarification : quel provider d'auth ? Quels champs ? Faut-il gérer l'OAuth ? Les messages d'erreur ? Les etats de chargement ?
Les agents de code IA vont essayer de répondre a toutes ces questions eux-memes. Parfois ils devinent juste. Souvent ils devinent quelque chose de raisonnable mais pas ce que vous vouliez. L'ecart entre 'raisonnable' et 'exactement ce qu'il faut' est ce que le prompt engineering comble.
Les bons prompts n'ont pas besoin d'etre longs. Ils doivent etre spécifiques sur les choses qui comptent et silencieux sur celles qui ne comptent pas. Cet equilibre est le sujet de ce guide.
Des patterns qui ameliorent les résultats quelle que soit la tâche.
Au lieu de 'créé un composant React, puis ajouté du state, puis ajouté du style', decrivez le résultat final : 'Construis une sidebar repliable qui affiché les noms de projets, supporte le drag-to-reorder et utilise notre theme Tailwind existant.' Laissez l'agent decider comment y arriver.
Avoid
Cree un composant. Ajoute useState. Ajoute un bouton toggle. Style avec Tailwind.
Better
Construis un composant sidebar repliable qui liste les projets par nom. Il doit supporter le drag-to-reorder et correspondre a notre theme sombre (bg-[#111318], border-[#262b38]). L'état replie doit persister entre les rechargements de page.
Les agents fonctionnent mieux quand ils connaissent les limites. Specifiez quels fichiers toucher (ou éviter), quels patterns suivre et a quoi ressemble 'termine'. Les tâches sans limites menent a des changements tentaculaires difficiles a reviewer.
Avoid
Refactorise le système d'authentification.
Better
Refactorise le handler de login dans src/api/auth/login.ts pour utiliser bcrypt au lieu de sha256 pour le hashing des mots de passe. Ne change pas la logique JWT ni la gestion du cookie de session. Mets à jour les tests dans tests/auth/.
Claude Code peut lire les fichiers de votre projet, mais pas vos pensees. Si vous suivez une convention, preferez une librairie ou avez déjà etabli un pattern, dites-le. Ca évité de refaire.
Avoid
Ajoute la validation du formulaire.
Better
Ajoute la validation du formulaire d'inscription avec zod (on l'utilise déjà pour le formulaire de settings dans src/forms/settings.ts). Affiche les messages d'erreur inline sous chaque champ. Suis le même style d'erreur que le formulaire de login.
Les prompts composes ('construis l'API, ecris les tests, mets à jour la doc et deploie') forcent l'agent a jongler avec trop d'objectifs. Decomposez le travail complexe en tâches sequentielles et ciblees. Chacune s'appuie sur le résultat précédent.
Avoid
Construis la page profil utilisateur, ecris les endpoints API, ajouté les tests, mets à jour le README et corrigé la barre de nav au passage.
Better
Construis l'endpoint GET /api/user/profile. Retourne les champs id, name, email et plan. Utilise le middleware d'auth existant pour l'authentification.
Si le premier résultat n'est pas bon, affinez le prompt plutôt que de repartir de zéro. Claude retient le contexte complet de la conversation. Dites ce qui ne va pas, ce qu'il faut changer et ce qu'il faut garder. L'iteration est plus rapide que la reinvention.
Avoid
C'est faux. Recommence et construis le composant differemment.
Better
Le layout est bon mais le breakpoint mobile est incorrect. En dessous de 768px, empile les cartes verticalement au lieu d'utiliser une grille. Garde tout le reste tel quel.
Les system prompts definissent le comportement de base d'un agent avant que vous ne disiez quoi que ce soit. C'est l'outil le plus sous-utilise du code assiste par IA.
Un system prompt dit a l'agent qui il est, sur quoi il doit se concentrer et ce qu'il doit éviter. Il s'applique a chaque message de la session. Voyez-le comme la fiche de poste de l'agent.
AgentsRoom est livre avec 14 system prompts spécifiques par rôle : un pour chaque type d'agent. Le prompt de l'agent Frontend lui dit de se concentrer sur les composants, l'accessibilite et le design responsive. Le prompt de l'agent QA lui dit de penser aux cas limites et d'écrire des tests complets. Vous pouvez les personnaliser ou écrire les votres.
Tu es un développeur frontend senior. Concentre-toi sur les composants React, le styling CSS/Tailwind, l'accessibilite (WCAG AA) et le design responsive. Utilise la bibliotheque de composants existante du projet avant de créer de nouveaux composants. Prefere la composition a l'heritage. Ecris du HTML semantique. Ne modifié jamais les fichiers backend.
Le prompt le plus efficace n'est pas tape dans un chat. Il vit dans votre dépôt.
CLAUDE.md est un fichier markdown a la racine de votre projet que Claude Code lit automatiquement. Il contient la structure du projet, les conventions, les details de la stack et les directives qui s'appliquent a chaque session d'agent du projet.
Au lieu de repeter 'on utilise Tailwind CSS 4, Prisma ORM et Next.js 16' dans chaque conversation, écrivez-le une fois dans CLAUDE.md. Chaque agent herite de ce contexte. AgentsRoom inclut un éditeur intégré pour CLAUDE.md afin de le mettre à jour sans quitter l'app.
Un CLAUDE.md bien écrit vaut plus que des dizaines de prompts individuels soigneusement rediges. C'est cumulatif : chaque session en bénéficie.
Arrêtez de recrire les memes instructions. Sauvegardez ce qui marche et reutilisez-le.
Si vous vous retrouvez a taper le même type de requête entre les projets ('ecris des tests unitaires pour ce fichier', 'refactorise ca en pattern repository', 'ajouté la gestion d'erreurs sur toutes les routes API'), sauvegardez-le comme prompt reutilisable.
AgentsRoom inclut une fonctionnalité de bibliotheque de prompts a deux niveaux : des prompts par projet pour les tâches spécifiques au projet, et des prompts globaux (synchronisés dans le cloud) pour les patterns que vous utilisez partout.
Bons candidats pour les prompts de bibliotheque : checklists de code review, templates d'ecriture de tests, scripts de migration, instructions de scaffolding de composants, étapes d'audit sécurité. Tout ce que vous mettriez dans un wiki d'équipe comme procedure standard.
Ecris des tests unitaires pour [fichier]. Utilise vitest. Couvre le cas nominal, les cas limites (entree vide, null, types invalides) et la gestion d'erreurs. Mocke les dependances externes. Vise >90% de couverture de branches.
Revois les changements dans le diff git actuel. Verifie : imports inutilises, gestion d'erreurs manquante, problèmes de types, conditions de course potentielles et incoherences de nommage. Suggere des corrections pour chaque problème trouve.
Cree un endpoint REST pour [ressource]. Inclus la validation des entrees avec zod, des réponses d'erreur appropriees (400, 401, 404, 500), des types TypeScript pour la requête/réponse et un commentaire JSDoc decrivant l'endpoint. Suis le pattern existant dans src/api/.
Techniques pour les tâches complexes qui vont au-dela des prompts simples.
Decomposez une grande tâche en étapes ordonnees. Démarrez le premier agent avec l'étape un, attendez la completion, puis lancez l'agent suivant avec l'étape deux (en referencant la sortie de l'étape un). Chaque étape est plus petite et plus ciblee. Exemple : l'Agent 1 conçoit le schema de base de donnees, l'Agent 2 écrit l'API avec ce schema, l'Agent 3 écrit les tests contre l'API.
Après qu'un agent a termine, pointez un agent différent sur sa sortie. 'Revois les changements que l'agent frontend vient de faire dans src/components/. Verifie les problèmes d'accessibilite et les etats d'erreur manquants.' Un agent frais avec un rôle différent attrape ce que l'agent original a manque.
Commencez avec un prompt large pour voir comment l'agent aborde le problème. Puis ajoutez des contraintes dans les messages suivants : 'Bonne structure, mais utilise des server components au lieu de client components.' 'Garde le hook, mais supprimé le useEffect et utilise une mutation React Query a la place.' Chaque iteration resserre vers la solution voulue.
Pointez l'agent vers du code existant : 'Construis une page de parametres en suivant le même pattern que src/pages/profile.tsx. Même structure de layout, même gestion de formulaire, même affichage d'erreurs.' C'est souvent plus efficace que de decrire le pattern en mots.
Des patterns qui produisent systematiquement de moins bons résultats.
Dire a l'agent exactement quelles fonctions écrire, quels noms de variables utiliser et dans quel ordre implementer. Ce micromanagement supprimé la capacité de l'agent à trouver une meilleure approche. Decrivez le résultat, pas la procedure.
Demander a un agent d' 'ameliorer le codebase' sans contraintes. Sans limites, l'agent pourrait refactoriser des fichiers que vous ne vouliez pas toucher, changer des API dont d'autre code depend, ou depenser des tokens sur des améliorations a faible priorite.
Ne pas mentionner qu'un pattern, un utilitaire ou un composant existe déjà dans le projet. L'agent en creera un nouveau. Un simple 'on a déjà un hook useAuth dans src/hooks/' fait economiser un travail significatif.
Entasser cinq tâches dans un seul message. L'agent tentera de toutes les faire, mais la qualité chute car il jongle avec des objectifs concurrents. Decoupez-les en requêtes sequentielles et ciblees.
AgentsRoom vous donne des system prompts, une bibliotheque de prompts et l'édition de CLAUDE.md intégrée. Moins de temps a rediger des prompts, plus de temps à construire.
App companion : suivez vos agents en déplacement
Utilisez Claude, Codex, Gemini CLI ou un autre fournisseur IA.
Remontez bugs et demandes directement dans votre backlog public.