Quel est le niveau de difficulté et quel outil IA utiliser ?

Ce prompt est de niveau intermédiaire. Il est compatible avec claude.

💻DeveloppementIntermediaireClaude

Brief de tâche pour Claude Code : cadrer une fonctionnalité de bout en bout

Gabarit de brief pour déléguer une fonctionnalité complète à Claude Code : objectif, point de départ, contraintes, définition de terminé, règles de travail et format du récapitulatif.

Coller dans votre IA

Collez ce prompt dans ChatGPT, Claude ou Gemini et personnalisez les variables entre crochets.

Tu es Claude Code et tu vas implémenter une fonctionnalité de bout en bout dans ce dépôt. Voici le brief ; lis-le entièrement, puis commence par me présenter un plan en 5 à 10 étapes et attends mon accord avant d'écrire du code.

Objectif (une phrase, du point de vue de l'utilisateur) :
[OBJECTIF]

Pourquoi maintenant :
[CONTEXTE MÉTIER EN 2-3 LIGNES]

Point de départ :

Fichiers ou modules concernés : [CHEMINS]
Comportement actuel : [CE QUI SE PASSE AUJOURD'HUI]
Exemple concret d'entrée → sortie attendue : [EXEMPLE]

Contraintes :

Techniques : [ex. pas de nouvelle dépendance, TypeScript strict, compatible avec la migration X]
Produit : [ex. FR + EN, accessible au clavier, aucun changement d'API publique]
Ne pas toucher : [FICHIERS / DOSSIERS INTERDITS]

Définition de terminé (tout doit être vrai) :

[CRITÈRE VÉRIFIABLE, ex. le test T passe]
[CRITÈRE, ex. le build passe sans warning nouveau]
[CRITÈRE, ex. un test couvre le cas limite Y]
[CRITÈRE, ex. la doc D est mise à jour]

Règles de travail :

Écris ou adapte les tests avant l'implémentation quand c'est possible.
Commits petits et en français, un par étape du plan.
Si tu découvres que le brief est incomplet ou contradictoire, arrête-toi et pose une question d'une ligne ; ne devine pas.
Si tu vois un autre problème dans le code, note-le à la fin, ne le corrige pas.

À la fin, rends un récapitulatif : fichiers modifiés (liste exhaustive), ce qui a changé par fichier (une ligne), ce que tu as volontairement laissé de côté, et ce qui reste à faire.

Personnaliser ce prompt avec Léa

Léa réécrit ce prompt pour ton métier et ton objectif précis — 3 questions suffisent.

Pourquoi ce prompt fonctionne

La qualité d'une tâche livrée par Claude Code dépend moins du modèle que du brief. Un agent autonome qui reçoit « ajoute l'export CSV » va deviner le format, la localisation et le périmètre — et se tromper sur au moins un des trois. Ce gabarit force les quatre informations qui suppriment les allers-retours : un exemple concret d'entrée → sortie, les zones à ne pas toucher, une définition de terminé vérifiable, et la consigne de s'arrêter en cas de doute plutôt que d'improviser. Le passage par un plan validé avant le code est délibéré : c'est le moment le moins coûteux pour corriger une mauvaise interprétation. Le récapitulatif final imposé (fichiers, changements, laissé de côté, reste à faire) rend la relecture rapide et sert de base à la description de la pull request. Ce brief fonctionne tel quel avec Codex ou tout agent de code qui accepte une consigne longue ; seule la première ligne change.

Cas d'usage

Déléguer une fonctionnalité complète (front + API + tests) sans surveiller chaque étapeStandardiser la façon dont une équipe confie des tâches à un agent de codeObtenir un récapitulatif exploitable directement comme description de PR

Résultat attendu

D'abord un plan en 5 à 10 étapes soumis à validation ; puis l'implémentation par petits commits ; enfin un récapitulatif en quatre parties (fichiers, changements, laissé de côté, reste à faire).

Questions fréquentes

Faut-il vraiment un exemple d'entrée → sortie ?

C'est la ligne la plus rentable du brief. Un exemple lève plus d'ambiguïtés que trois paragraphes de description, et il devient naturellement le premier test.

Que faire si la tâche est trop grosse pour un seul brief ?

Découpez par livrable vérifiable (une migration, puis l'API, puis l'interface) et enchaînez trois briefs. Un agent livre mieux trois tâches de deux heures qu'une tâche de six heures.

Améliorez ce prompt

Passez ce prompt dans l'Optimiseur pour renforcer le contexte, les contraintes et le format attendu.

Améliore ce prompt avec l'Optimiseur

Commentaires

LéaIA
Astuce : versionnez ce brief dans le repo (ex. `docs/briefs/feature-x.md`) et lancez Claude Code avec `claude -p "$(cat docs/briefs/feature-x.md)"` pour garder une trace des specs et relancer l’implémentation après un changement. Dans « Définition de terminé », précisez toujours la commande exacte à exécuter (ex. `pnpm test -- --run`) : un critère non vérifiable automatiquement reste interprétable.