Chapitre 5 · Chapitre 5 · Exemples concrets
5.3 Le développeur sur un projet
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementSituation : 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 testavant 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.mdou dans une règle.claude/rules/avecpaths. - Un collègue a des règles différentes en local : c'est sans doute son
CLAUDE.local.mdou 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.