Burak Reis

Mon CLAUDE.md est surtout une liste de ce que je ne veux pas

En travaillant avec Claude, ce qui m'a le plus servi, c'est d'écrire dans CLAUDE.md ce que je ne veux pas, et pourquoi.

Burak Reis4 min de lecture

Le plus fatigant, quand je travaillais avec Claude, c'était de repartir de zéro à chaque nouvelle session. Il ne sait pas ce que je n'ai pas aimé la veille, ni pourquoi je l'ai refusé. À force de répéter les mêmes objections, j'ai compris que quelque chose clochait.

Aujourd'hui, dans le dossier de chaque projet, il y a un fichier que Claude lit avant de se mettre au travail. Il s'appelle CLAUDE.md. Il y a aussi une note de passation qui raconte où en est le projet à ce jour. Quand une nouvelle session s'ouvre, il commence par lire ces deux fichiers.

En les regardant de plus près, une chose m'a frappé : la plupart des règles ne commencent pas par « fais », mais par « ne fais pas ».

La liste de ce que j'ai refusé dans CLAUDE.md

J'en recopie quelques-unes telles quelles. Dans le projet où j'ai donné du mouvement à une pochette d'album, on trouve celles-ci :

  • Ne redessine pas la photo de la pochette ni les personnes avec l'IA générative. Reste fidèle à l'image originale.
  • N'imite pas l'interface d'Apple à la main. Là où c'est possible, utilise les composants Figma officiels d'Apple.
  • Ne devine pas les données comme le titre ou la durée d'un morceau.
  • N'ajoute pas d'effet sonore gênant.

Derrière chacune, il y a une déception. L'interface de téléphone dessinée à la main ne m'a pas plu : les espacements, la lumière, les libellés des boutons ne tombaient pas juste. Nous l'avons abandonnée pour repartir du fichier de design d'Apple lui-même. Je n'avais pas aimé du tout, non plus, le résultat précédent d'un outil vidéo, et cet outil figure maintenant sur la liste avec la mention « ne pas utiliser ».

Le dossier de mon projet d'assistant d'achat en contient de semblables. On n'invente pas d'information produit, on reprend ce qui est écrit sur le site de la marque. Partout où apparaît une vraie marque, une mention précise qu'il s'agit d'un concept. Les textes des vidéos sont dans la langue de l'écran affiché, et on n'utilise pas de points décoratifs.

Le goût, paraît-il, ne se décrit pas

On dit souvent que le goût ne s'explique pas. Du genre « je le reconnais quand je le vois ». Pourtant, en regardant ces fichiers, j'ai compris que mon goût est fait en grande partie de ce que je refuse. Décrire ce que je veux est difficile. Dire ce que je ne veux pas, et pourquoi, est facile.

Et c'est justement là que Claude est bon. Il devine mal, mais il suit très bien une règle. Quand je dis « fais quelque chose de plus élégant », il ne sait pas quoi faire. Quand je dis « n'utilise pas de point médian, parce que ça me paraît artificiel », il n'en met plus jamais.

Un autre exemple. Le premier film de ce projet durait 14 secondes, et en le regardant, même moi je n'ai pas compris ce qui se passait. C'est devenu une règle : l'interface tourne à vitesse réelle, une seule chose change par écran, les textes restent trois ou quatre secondes à l'écran.

Les décisions me reviennent

Ces fichiers sont en quelque sorte la version écrite de mon goût. Ils s'allongent un peu à chacune de mes corrections.

Mais c'est moi qui décide quelle règle y entre. Quand Claude propose quelque chose, par exemple ajouter un effet sonore à une vidéo, c'est aussi à moi de dire « non ».