La qualité du code généré par l'IA dépend presque entièrement de ce que vous demandez et de la façon dont vous le demandez. Ce guide couvre les modèles qui produisent toujours de meilleurs résultats avec Claude Code.
De l'établissement de la portée des tâches aux instructions du système, du raffinement itératif aux instructions spécifiques. Techniques pratiques que vous pouvez appliquer lors de votre prochaine session de codage.
Quand vous demandez à un développeur humain de 'construire une page de connexion', ils posent des questions claires : quel fournisseur auth ? Quels champs ? Ça devrait gérer OAuth ? Des messages d'erreur ? Chargement des états ?
Les agents de codage AI essaieront de répondre à toutes ces questions. Parfois, ils ont raison. Ils devinent souvent quelque chose de raisonnable, mais pas ce que vous vouliez. L'écart entre «raisonnable» et «juste» est ce qui se rapproche rapidement de l'ingénierie.
Pas besoin d'être long. Ils doivent être précis sur les choses qui comptent et silencieux sur les choses qui ne le font pas. Cet équilibre est l'objet de ce guide.
Des modèles qui améliorent les résultats indépendamment de la tâche.
Au lieu de 'créer un composant React, puis ajouter l'état, puis ajouter le style', décrire le résultat final: 'Construisez une barre latérale pliable qui affiche les noms de projet, supporte glisser-à-commander, et utilise notre thème Tailwind existant.' Laissez l'agent décider comment y arriver.
Avoid
Créer un composant. Ajouter useState. Ajoutez un bouton de bascule. Comme avec Tailwind.
Better
Construisez un composant pliable de barre latérale qui énumère les projets par leur nom. Il devrait supporter le glisser-à-commander et correspondre à notre thème sombre (bg-[#111318], border-[#262b38]). L'état effondrement devrait persister à travers les rechargements de page.
Les agents travaillent mieux quand ils connaissent les limites. Spécifiez les fichiers à toucher (ou éviter), les modèles à suivre, et à quoi ressemble 'fait'. Les tâches non limitées entraînent des changements qui sont difficiles à examiner.
Avoid
Refactorer le système d'authentification.
Better
Refactorer le gestionnaire de connexion dans src/api/auth/login.ts pour utiliser bcrypt au lieu de sha256 pour le hachage du mot de passe. Ne modifiez pas la logique JWT ou la gestion des cookies de session. Mettre à jour les tests correspondants dans les tests/auth/.
Claude Code peut lire vos fichiers de projet, mais il ne peut pas lire votre esprit. Si vous suivez une convention, une bibliothèque que vous préférez ou un modèle que vous avez déjà établi, dites-le. Ça économise le retravail.
Avoid
Ajouter la validation du formulaire.
Better
Ajouter la validation de formulaire au formulaire d'inscription en utilisant zod (nous l'utilisons déjà pour le formulaire de configuration dans src/forms/settings.ts). Afficher les messages d'erreur en ligne sous chaque champ. Suivez le même style d'erreur que le formulaire de connexion.
Les appels composés ('construire l'API, écrire des tests, mettre à jour les docs et déployer') forcent l'agent à tenir trop de buts à la fois. Divisez le travail complexe en tâches séquentielles et ciblées. Chacun s'appuie sur le résultat précédent.
Avoid
Construisez la page de profil d'utilisateur, écrivez les paramètres de l'API, ajoutez des tests, mettez à jour le README et corrigez la barre nav pendant que vous y êtes.
Better
Construisez le paramètre GET /api/user/profil. Return id, name, email, and plan fields. Utilisez l'intergiciel d'auth existant pour l'authentification.
Si le premier résultat n'est pas correct, raffinez l'invite plutôt que de recommencer. Claude conserve le contexte de conversation complet. Dis ce qui ne va pas, que changer, et que garder. L'itération est plus rapide que la réinvention.
Avoid
C'est faux. Recommencer et construire le composant différemment.
Better
La disposition est bonne, mais le point d'arrêt mobile est faux. En dessous de 768px, empilez les cartes verticalement au lieu d'utiliser une grille. Gardez tout le reste.
Le système invite à définir le comportement de base d'un agent avant de dire quoi que ce soit. C'est l'outil le plus sous-utilisé dans le codage AI.
Un système prompt indique à l'agent qui il est, sur quoi il devrait se concentrer, et ce qu'il devrait éviter. Il s'applique à chaque message de la session. Pensez-y comme la description de travail de l'agent.
AgentsRoom est livré avec 14 invites système spécifiques au rôle : une pour chaque type d'agent. L'invite de l'agent Frontend lui dit de se concentrer sur les composants, l'accessibilité et la conception réactive. L'invite de l'agent QA lui dit de penser aux cas de bord et d'écrire des tests complets. Vous pouvez les personnaliser ou écrire les vôtres.
Vous êtes un développeur principal. Se concentrer sur les composants React, le style CSS/Tailwind, l'accessibilité (WCAG AA) et la conception réactive. Utilisez la bibliothèque de composants existante du projet avant de créer de nouveaux composants. Préférez la composition plutôt que l'héritage. Écrire le HTML sémantique. Ne modifiez jamais les fichiers backend.
L'invite la plus efficace n'est pas tapée dans un chat. Il vit dans votre dépôt.
CLAUDE.md est un fichier balisage à la racine de votre projet que Claude Code lit automatiquement. Il contient la structure du projet, les conventions, les détails de la pile et les lignes directrices qui s'appliquent à chaque session d'agent du projet.
Au lieu de répéter 'nous utilisons Tailwind CSS 4, Prisma ORM, et Next.js 16' dans chaque conversation, écrivez-le une fois dans CLAUDE.md. Chaque agent hérite de ce contexte. AgentsRoom comprend un éditeur intégré pour CLAUDE.md afin que vous puissiez le mettre à jour sans quitter l'application.
Un CLAUDE.md bien écrit vaut plus de dizaines d'invites individuelles soigneusement conçues. Il se compose : chaque session en profite.
Arrêtez de réécrire les mêmes instructions. Enregistrer ce qui fonctionne et le réutiliser.
Si vous vous trouvez à taper le même type de requête sur des projets ('write unit testes for this file', 'refactor this to use the depot pattern', 'add error handling to all API routes'), enregistrez-le comme une prompte réutilisable.
AgentsRoom comprend une fonctionnalité de bibliothèque rapide avec deux niveaux : des invites par projet pour des tâches spécifiques au projet, et des invites globales (cloud-synced) pour des modèles que vous utilisez partout.
Bons candidats pour les invites de bibliothèque: listes de contrôle de révision de code, modèles d'écriture de test, scripts de migration, instructions d'échafaudage des composants, étapes de vérification de sécurité. Tout ce que vous avez mis dans un wiki d'équipe comme une procédure standard.
Écrire des tests unitaires pour [fichier]. Utilise la vitest. Couvrez le chemin heureux, les cas de bord (entrée vide, null, types invalides), et la gestion des erreurs. Mock dépendances externes. Objectif de couverture de la branche > 90 %.
Examiner les changements dans le diff git actuel. Vérifier : les importations non utilisées, la manipulation des erreurs manquantes, les problèmes de sécurité de type, les conditions de course potentielles et les incohérences de désignation. Suggérer des corrections pour chaque problème trouvé.
Créer un paramètre REST pour [resource]. Inclure la validation d'entrée avec zod, les réponses d'erreur appropriées (400, 401, 404, 500), les types de script de type pour requête/réponse, et un commentaire JSDoc décrivant le paramètre. Suivre le modèle existant dans src/api/.
Techniques pour des tâches complexes qui vont au-delà d'une seule prompte.
Briser une tâche importante en étapes ordonnées. Démarrez le premier agent avec l'étape 1, attendez l'achèvement, puis lancez l'agent suivant avec l'étape deux (voir la sortie de l'étape un). Chaque étape est plus petite et plus ciblée. Exemple : Agent 1 conçoit le schéma de base de données, Agent 2 écrit l'API en utilisant ce schéma, Agent 3 écrit des tests contre l'API.
Après la fin d'un agent, pointez un agent différent à sa sortie. Revoir les modifications que l'agent frontal vient d'apporter en src/composants/. Vérifiez les problèmes d'accessibilité et les états d'erreur manquants.» Un agent frais avec un rôle différent capture des choses que l'agent original a manquées.
Commencez par une prompte vague pour voir comment l'agent aborde le problème. Ajoutez ensuite des contraintes dans les messages de suivi : « Bonne structure, mais utilisez des composants de serveur plutôt que des composants de client ». « Gardez le crochet, mais retirez l'utilisationEffect et utilisez plutôt une mutation React Query. » Chaque itération se limite à la solution que vous voulez.
Pointez l'agent sur le code existant : 'Construisez une page de paramètres suivant le même modèle que src/pages/profile.tsx. Même structure de mise en page, même manipulation de formulaire, même affichage d'erreur.» Cela est souvent plus efficace que de décrire le modèle en mots.
Des modèles qui produisent toujours des résultats pires.
Dire à l'agent exactement quelles fonctions écrire, quelles variables nommer et quel ordre mettre en œuvre les choses. Cette microgestion supprime la capacité de l'agent à trouver une meilleure approche. Décrivez le résultat et non la procédure.
Demander à un agent d'améliorer la base de code sans contraintes. Sans limites, l'agent pourrait refactorer les fichiers que vous ne vouliez pas toucher, modifier les API dont dépend l'autre code, ou dépenser des jetons sur des améliorations de faible priorité.
Sans mentionner qu'un modèle, une utilité ou un élément existe déjà dans le projet. L'agent en créera un nouveau. Un simple 'nous avons déjà un crochet d'utilisationAuth dans src/hooks/' permet d'économiser un retravail important.
Cinq tâches en un seul message. L'agent tentera tous, mais la qualité baisse en jonglant avec des objectifs concurrents. Les diviser en requêtes séquentielles et ciblées.
AgentsRoom vous donne des invites système, une bibliothèque rapide, et CLAUDE.md édition intégrée. Moins de temps d'artisanat invite, plus de construction de temps.
App companion : suivez vos agents en déplacement
Utilisez Claude, Codex, Antigravity CLI ou un autre fournisseur IA.
Remontez bugs et demandes directement dans votre backlog public.
Aperçu d'AgentsRoom en action.