Skip to Content

Chapitre 14.1 — Prompts de cadrage

⏱️ TL;DR — Les prompts prêts à copier pour bien piloter : brief de kickoff, brief de feature (3 ingrédients), cadrage en plan mode, feedback correctif, comparaison de stack, exiger la preuve. Adapte les crochets <…> à ton contexte. Voir Parties 2 et 5 pour le pourquoi.

Kickoff d’un projet (→ 2.2)

OBJECTIF : <ce qu'on construit, 1-2 phrases>. Exclu : <ce qu'on ne fait PAS>. STACK : <framework, langage, styling, données, auth, tests>. CONVENTIONS : - <organisation des dossiers> - <alias d'import> - <règles TypeScript, ex. strict / no-any> - <pattern data / mutations> - <source des composants d'UI> DESIGN : <tokens, d'où viennent les composants>. CRITÈRE : <comment on saura que c'est fini : build, tests, écran qui marche>. CONTRAINTE : reste en plan mode, ne crée rien avant que je valide le plan.

Brief de feature — 3 ingrédients (→ 5.1)

OBJECTIF : <quoi + pourquoi>. ANCRAGES : suis le style de <fichier-modèle>. Respecte le CLAUDE.md. CRITÈRE : <preuve observable : tel test vert, tel écran fait X, build ok>.

Décider une stack sans subir (→ 2.3)

Je dois choisir <une lib / une approche> pour <besoin>. Mes contraintes : <contrainte 1>, <contrainte 2>, <contrainte 3>. Compare 2-3 options AVEC leurs compromis, puis recommande. Je tranche ensuite.

Et pour stress-tester une décision déjà prise :

J'ai choisi <X>. Donne-moi les meilleurs arguments CONTRE ce choix et les pièges concrets que je risque d'ignorer.

Feedback correctif ciblé (→ 5.1)

Au lieu de « non, refais », désigne l’écart :

Le problème précis : <l'écart observable>. Corrige uniquement ça. Ex : « le statut doit être un enum todo|doing|done, pas une string ». Ex : « deleteTask ne revalide pas la liste après suppression ». Ex : « utilise bg-surface-2 pour la carte, pas du blanc en dur ».

Exiger la preuve (→ 5.4)

À coller en fin de tâche :

Avant de conclure : lance <npm test / la commande de test> et MONTRE la sortie. Puis ouvre <l'écran concerné>, exerce le flux <décris-le>, et décris ce que tu vois. Ne conclus pas sur « ça devrait marcher » : prouve-le.

Découper en tranches vérifiables (→ 5.5)

Découpe <la feature> en 3 tranches vérifiables indépendamment. Pour chaque tranche : objectif + ancrage sur l'existant + preuve (test / flux exercé). On valide chaque tranche avant la suivante. Ne fais pas tout en un bloc.

Onboarder l’IA sur un repo (→ 6.1)

Cartographie ce repo sans le lire ligne à ligne : (1) structure des dossiers et rôle de chaque zone, (2) points d'entrée, (3) stack et libs clés, (4) conventions apparentes, (5) où regarder pour ajouter une feature de type <X>. Reste haut niveau, cite les fichiers plutôt que de les coller.

Déduire les conventions existantes (→ 6.2)

Avant de modifier quoi que ce soit : lis 3-4 fichiers représentatifs et DÉDUIS les conventions (nommage, structure d'un module, data-fetching, gestion d'erreurs, style de composant). Liste-les. Je veux du code INDISCERNABLE de l'existant. Ne modernise/ refactore RIEN sans que je le demande.

Recette suivante : Templates CLAUDE.md.