Brief de prompt productif pour Claude Code: quoi fournir en premier

Pourquoi ce workflow compte

Les débutants échouent rarement par manque de belles phrases. Ils échouent parce que l’objectif, les fichiers protégés, les liens de revenus et les critères de fin manquent. Un brief court réduit les suppositions.

Workflow pratique

Écrivez l’objectif en une phrase, puis le fichier, le lecteur et la raison business. Ajoutez ce qui ne doit pas être touché, les liens Gumroad à garder et la commande de preuve.

Kit minimal à copier-coller

# Claude Code task brief

## Goal
Change one clear thing:

## Context
- user or reader:
- current file/page:
- business reason:

## Constraints
- do not touch:
- keep these links working:
- proof command:

## Definition of done
- small diff
- public URL checked
- CTA path still works
- handoff note written

Use this brief before editing.
Ask up to three clarifying questions only if the goal, protected files, or proof command is missing.
Then propose the smallest safe patch and the verification receipt.

rg --files | Select-Object -First 80
git diff --name-only
cd site
npm.cmd run build

Exemple de bon brief de demande

Un bon brief ne dit pas seulement quoi modifier. Il indique aussi pourquoi la modification existe et ce qui doit rester intact. Pour un article, une demande solide peut ressembler à ceci:

Améliore uniquement l’introduction et la zone CTA de site/src/content/blog-fr/claude-code-productive-prompt-brief.mdx. Le lecteur est un développeur indépendant qui découvre Claude Code. L’objectif est de l’aider à comprendre quand le PDF gratuit suffit, puis quand Prompt Templates, Setup Guide ou une consultation deviennent utiles. Ne modifie pas le frontmatter, le slug, les liens Gumroad existants, les liens internes ni les blocs de code. Ensuite, exécute node scripts/check-updated-article-quality.mjs et confirme que les erreurs liées à ce slug ont disparu.

Ce brief fonctionne parce que la surface est limitée. “Uniquement l’introduction et la zone CTA” empêche une réécriture complète. Le lecteur et l’objectif business donnent un contexte pratique: Claude Code ne doit pas seulement rendre le texte plus joli, il doit guider la bonne prochaine action.

Les protections sont aussi explicites. Le frontmatter porte la date, la catégorie et heroImage. Les liens Gumroad sont la route de revenus. Les liens internes gardent la circulation entre articles. Les blocs de code sont des éléments que le lecteur copie. Les nommer dès le départ évite les corrections tardives où l’on découvre qu’un chemin important a disparu.

Exemple de mauvaise demande

Une mauvaise demande est souvent courte au mauvais endroit:

Améliore cet article pour le SEO et la conversion.

La phrase paraît claire, mais elle ne dit pas quelle action est autorisée. SEO peut vouloir dire titre, mots-clés, liens internes, description ou longueur du contenu. Conversion peut vouloir dire CTA plus fort, davantage de liens Gumroad, un tableau comparatif ou une note d’expérience. Claude Code risque alors de produire un diff large et difficile à relire.

Autre demande fragile:

Rends-le plus simple pour les débutants et dis-moi quand c’est fini.

L’intention est bonne, mais la fin n’est pas mesurable. Une meilleure demande préciserait qu’il faut ajouter un bon brief, une mauvaise demande, un template débutant et une transition naturelle vers le PDF gratuit, Gumroad et la consultation. Elle préciserait aussi la commande qui sert de preuve.

Template débutant pour la première demande

Au début, inutile de viser le prompt parfait. Remplissez cinq lignes simples:

Changement: une seule chose à modifier
Cible: fichier, URL, commande ou écran concerné
Lecteur ou utilisateur: la personne aidée par la modification
Protections: fichiers, liens, comportements ou règles à garder
Preuve: commande à lancer ou résultat à vérifier

Pour améliorer un CTA de page produit, limitez le changement au texte et à l’emplacement du CTA. La cible est le fichier MDX de la page. Le lecteur a compris le PDF gratuit, mais hésite entre templates, guide de setup ou aide directe. Les protections sont les liens vers le PDF gratuit, Prompt Templates et Setup Guide. La preuve est le build, l’URL publique et le clic sur les liens.

Ce template est volontairement petit. Il rend le premier patch relisible, réversible et attaché à un résultat. Ensuite, vous pouvez ajouter des règles locales: garder les traductions synchronisées, ne pas toucher aux prix sans accord, conserver les captures, ou ne pas modifier la hiérarchie des titres.

Chemin naturel vers les ressources et la consultation

Le brief aide aussi à choisir la bonne suite. Si le lecteur hésite encore sur les commandes de base, le PDF gratuit est la bonne marche. Si les mêmes demandes reviennent souvent, Prompt Templates transforme cette répétition en structure réutilisable. Si l’enjeu touche une équipe, des permissions, des règles de review ou des liens de revenus, une consultation peut éviter des essais coûteux.

L’ordre doit rester simple: d’abord une ressource gratuite utile aujourd’hui, puis des templates quand la répétition devient visible, enfin la consultation quand les exemples génériques ne suffisent plus. Le lecteur ne se sent pas poussé à acheter; il voit une progression adaptée à son risque réel.

Trois cas d’usage réels

Pour améliorer seulement un CTA, interdire la réécriture complète et exiger l’URL publique.
Pour CLAUDE.md, donner d’abord commandes interdites et commande de build.
Pour une page produit, protéger PDF gratuit, Prompt Templates et Setup Guide.

Échecs fréquents et comment les éviter

Demander ‘améliore ça’. Le diff devient trop large.
Oublier les liens protégés. Le chemin de revenus peut disparaître sans alerte.
Ne pas définir la fin. Claude Code peut s’arrêter à la recherche.

Chemin PDF gratuit, Gumroad et consultation

Utilisez le PDF gratuit avant les briefs. Utilisez Prompt Templates pour des demandes réutilisables. Utilisez Setup Guide quand CLAUDE.md, hooks et hypothèses doivent rester stables.

Commencez par le PDF gratuit pour stabiliser commandes et réflexes de sécurité. Passez à Gumroad quand le workflow se répète, puis réservez une consultation si l’adoption ou la conversion coûte cher à deviner.

Ce que j’ai vérifié pour cet article

J’ai séparé le brief Markdown, l’instruction courte et la preuve. Le but est un changement, une preuve et un contrôle du chemin de revenus.