CLAUDE.md

Le fichier CLAUDE.md est la mémoire persistante de ton projet. Il contient les instructions et le contexte que Claude doit connaître à chaque session.

Pourquoi CLAUDE.md ?

Sans CLAUDE.md, Claude repart de zéro à chaque session. Il ne connaît pas :

Les conventions de code du projet
Les erreurs passées à éviter
Les patterns architecturaux choisis
Les commandes spécifiques au projet

Structure recommandée

CLAUDE.md

# CLAUDE.md

## Project Overview
Description courte du projet (2-3 phrases).

## Tech Stack
- Framework: Next.js 16
- Auth: Better-Auth
- Database: Postgres + Drizzle ORM
- Payments: Stripe

## Commands
\`\`\`bash
npm run dev    # Start dev server
npm run build  # Production build
npm run test   # Run tests
\`\`\`

## Code Style
- TypeScript strict mode
- Async/await over callbacks
- Named exports over default exports

## Common Mistakes to Avoid
- Ne jamais exposer les clés API côté client
- Toujours valider les inputs utilisateur
- Utiliser les Server Actions pour les mutations

Où placer le fichier ?

Claude cherche CLAUDE.md dans cet ordre :

Racine du projet : ./CLAUDE.md (le plus courant)
Dossier .claude : .claude/CLAUDE.md
Global : ~/.claude/CLAUDE.md

Sections essentielles

Section	Contenu
Project Overview	2-3 phrases décrivant le projet
Tech Stack	Frameworks, libs, services utilisés
Commands	Commandes npm/pnpm du projet
Code Style	Conventions de code importantes
Common Mistakes	Erreurs à éviter (crucial !)

Bonnes pratiques

Garde-le concis - ~2500 tokens max
Soit spécifique - Pas de généralités, des instructions précises
Documente les erreurs - Chaque erreur corrigée = une ligne ajoutée
Versionne-le - Commit chaque modification

Quand Claude fait une erreur, ajoute-la au CLAUDE.md pour éviter qu'elle se reproduise.

Mettre à jour CLAUDE.md

Prompt

Analyse les derniers changements dans le projet
et propose des mises à jour pour CLAUDE.md.