CLAUDE.md : le fichier secret qui transforme Claude Code

Vous utilisez Claude Code mais vous avez l’impression de devoir tout re-expliquer a chaque conversation ? Il y a un fichier magique pour ca : CLAUDE.md.

C’est quoi CLAUDE.md ?

CLAUDE.md est un fichier markdown que Claude Code lit automatiquement au demarrage de chaque conversation. Pensez-y comme la memoire persistante de votre assistant IA.

Placez-le a la racine de votre projet, et Claude saura immediatement :

• Quelle est l’architecture de votre projet
• Quelles conventions de code vous utilisez
• Quels sont les pieges a eviter
• Comment lancer les tests, builder, deployer

# Emplacement type
mon-projet/
├── CLAUDE.md    ← lu automatiquement
├── src/
├── package.json
└── ...

Que mettre dedans ?

Voici les sections les plus utiles, testees sur des dizaines de projets :

1. Contexte du projet

Donnez a Claude le “big picture” en 3-4 lignes. Pas besoin d’un roman.

## Contexte
Application SaaS de gestion immobiliere.
Stack : Symfony 7 + React 18 + TypeScript.
API REST avec API Platform.

2. Conventions de code

Claude respectera vos conventions si vous les decrivez explicitement.

## Conventions
- Noms de variables en camelCase
- Composants React en PascalCase
- Un composant par fichier
- Tests unitaires avec Vitest

3. Commandes utiles

Evitez de retaper “lance les tests avec…” a chaque fois.

## Commandes
- Tests : `npm run test`
- Build : `npm run build`
- Lint : `npm run lint`
- Dev : `npm run dev`

4. Architecture et fichiers cles

Indiquez ou se trouvent les choses importantes.

## Architecture
- API : `src/Controller/` (Symfony)
- Frontend : `src/components/` (React)
- Base de donnees : `src/Entity/` (Doctrine)
- Config : `.env.local`

Astuce avancee : les instructions negatives

Les instructions “ne fais PAS ca” sont souvent plus efficaces que les instructions positives :

## A ne pas faire
- Ne jamais modifier les fichiers dans `vendor/`
- Ne pas ajouter de commentaires JSDoc sauf si demande
- Ne pas creer de fichiers README automatiquement
- Ne pas utiliser `any` en TypeScript

Pourquoi ca marche ? Claude a tendance a etre proactif. Les instructions negatives canalisent cette energie dans la bonne direction.

Taille ideale

Un bon CLAUDE.md fait entre 50 et 200 lignes. Au-dela, il y a un risque de dilution de l’attention (oui, meme les IA ont ce probleme).

Si vous avez beaucoup de contexte, creez des fichiers separes et referencez-les :

## Documentation detaillee
- Architecture : voir `docs/ARCHITECTURE.md`
- API : voir `docs/API.md`
- Deploiement : voir `docs/DEPLOY.md`

L’erreur numero 1

Ne mettez pas de contenu ephemere dans CLAUDE.md (taches en cours, bugs du moment, etc.). Ce fichier doit contenir des verites stables sur votre projet.

Pour les taches temporaires, utilisez plutot les conversations directement ou un fichier TODO.md separe.

---

En resume : CLAUDE.md, c’est le briefing que vous donneriez a un nouveau developpeur qui rejoint votre equipe. Sauf que ce developpeur le relit a chaque conversation et ne l’oublie jamais. Pas mal, non ?