Aller au contenu
Floskool

Chapitre 5 · Chapitre 5 · Exemples concrets

5.3 Le développeur sur un projet

Leçon gratuite 5 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Situation : une application web avec des tests, en équipe. C'est le cas d'usage d'origine de CLAUDE.md : les commandes et conventions qu'on ne veut plus répéter. Même si tu ne codes pas, lis cette leçon : elle montre à quel point un fichier précis rend Claude fiable.

# Application de réservation

## Stack
Node.js 22, TypeScript, React, base PostgreSQL.

## Commandes
- npm run dev : lance l'application en local
- npm test : lance les tests (obligatoire avant chaque commit)
- npm run lint : vérifie le style du code

## Conventions
- Indentation : 2 espaces.
- Les routes de l'API sont dans src/api/routes/, une route par fichier.
- Les composants React sont dans src/components/, un composant par fichier, en PascalCase.

## Règles
- Ne jamais modifier les fichiers de migration déjà appliqués.
- Ne jamais committer le fichier .env.
- Toute nouvelle fonction a au moins un test.

## Façon de travailler
- Pour une tâche importante, propose d'abord un plan.
- Lance npm test après tes modifications et montre le résultat.

À noter : les règles propres à une partie du code (par exemple l'API) peuvent aller dans src/api/CLAUDE.md ou dans .claude/rules/ avec un en-tête paths : elles ne seront chargées que quand Claude travaille sur ces fichiers.

Les choix expliqués

  • La stack (les technologies utilisées) évite que Claude propose une solution dans un autre langage.
  • Les commandes exactes : Claude n'a pas à deviner comment lancer les tests. La documentation cite justement « Lance npm test avant de committer » comme exemple de bonne instruction, plutôt que « Teste tes changements ».
  • Les conventions d'emplacement : chaque nouveau fichier arrive au bon endroit.
  • Les règles « Ne jamais » protègent ce qui est coûteux à réparer (migrations, secrets).

Équipe et fichiers personnels

Ce fichier est committé (enregistré dans git) et partagé avec toute l'équipe. Tes préférences à toi, comme l'adresse de ta base de test locale, vont dans CLAUDE.local.md, ajouté au .gitignore. Ainsi, chacun garde ses réglages sans polluer le fichier commun.

Quand une consigne doit être absolue

« Lance npm test avant chaque commit » reste une consigne : Claude la suit très bien, mais sans garantie absolue. La documentation recommande, pour ce qui doit se produire à un moment précis à chaque fois (avant un commit, après chaque modification de fichier), d'utiliser un hook. Par exemple, l'exemple officiel lance un formateur de code après chaque modification de fichier. C'est un sujet à part entière, à aborder quand ton CLAUDE.md est stable.

Le prompt d'audit pour une équipe

Compare CLAUDE.md avec le projet réel : les commandes listées existent-elles dans package.json ? Les dossiers cités existent-ils ? Signale tout ce qui est faux ou périmé, sans rien modifier.

Une commande périmée dans CLAUDE.md fait échouer Claude à chaque session : cet audit vaut la peine d'être lancé après chaque grosse modification du projet.

Si ça coince

  • Claude lance une mauvaise commande de test : vérifie la section Commandes, et précise le contexte (« depuis la racine du projet »).
  • Les règles de l'API sont appliquées partout : déplace-les dans src/api/CLAUDE.md ou dans une règle .claude/rules/ avec paths.
  • Un collègue a des règles différentes en local : c'est sans doute son CLAUDE.local.md ou son ~/.claude/CLAUDE.md. Gardez dans le fichier commun uniquement ce qui vaut pour tous.

À retenir

  • Commandes exactes, conventions d'emplacement, règles « Ne jamais ».
  • Le fichier commun est partagé ; le perso va dans CLAUDE.local.md.
  • Ce qui doit arriver à chaque fois sans exception relève des hooks.
  • Vérifie régulièrement que le fichier correspond au projet réel.