diff --git a/CLAUDE_PROJECT_OVERVIEW.md b/CLAUDE.md
similarity index 91%
rename from CLAUDE_PROJECT_OVERVIEW.md
rename to CLAUDE.md
index 4657285..7fe2bf4 100644
--- a/CLAUDE_PROJECT_OVERVIEW.md
+++ b/CLAUDE.md
@@ -309,3 +309,36 @@ npm run build:preprod  # Staging (avec sourcemaps)
 3. **Commentaires**: Positionnés en % (x, y) + pageIndex pour les PDFs multi-pages.
 4. **Notifications**: Stockées par projet, trackées par user UUID dans `readby[]`.
 5. **Virtual Sample**: Pistes dynamiques = pages enfants, pistes statiques = fichiers.
+
+---
+
+## Préférences de code et standards
+
+### Principes généraux
+
+**Clarté avant tout**
+- Privilégier des noms de variables et fonctions explicites
+- Éviter les commentaires sauf en cas de nécessité absolue
+- Le code doit être auto-documenté par des noms clairs
+
+**Organisation du code**
+- Factoriser le code en petites fonctions bien nommées
+- Éviter les blocs de code longs et complexes dans les hooks de lifecycle
+- Une fonction = une responsabilité claire
+
+**Ce qui est considéré comme "bricolage" (à éviter)**
+- Paramètres d'URL pour gérer des états applicatifs
+- Commentaires qui expliquent ce que fait le code au lieu de nommer correctement
+- Abstractions prématurées ou sur-ingénierie
+
+### Style de communication
+
+**Feedback direct**
+- Pas de politesses inutiles
+- Dire immédiatement si quelque chose ne va pas
+- Tester tout de suite et signaler les problèmes
+
+**Qualité attendue**
+- Standards élevés sur la qualité du code
+- Pas de code médiocre accepté
+- Exigence de clarté et d'explicité constante