Fichier lu automatiquement par Claude Code à chaque démarrage de session. Place-le à la racine du projet (et/ou dans ~/.claude/CLAUDE.md pour des instructions globales). Il remplace des dizaines de répétitions en début de conversation.
## Description
Application React + Vite déployée sur Netlify.
Audience : 16-25 ans, Mission Locale.
## Stack technique
- React 18, Vite, Netlify Functions (ESM)
- Pas de TypeScript, pas de Tailwind
## Commandes clés
- `npm run dev` — dev server
- `npm run build` — build prod → dist/
- `git push origin main` — déploie sur Netlify
## Conventions
- Pas de commentaires sauf si raison non-évidente
- CSS vanilla dans les HTML standalone des jeux
- Liens Wikipedia → toujours fr.wikipedia.org
## À NE PAS faire
- Ne pas créer de fichiers README.md inutiles
- Ne pas ajouter d'emojis sauf si demandé
Crée un CLAUDE.md par sous-dossier important (src/, netlify/) pour du contexte granulaire.
Dans ~/.claude/CLAUDE.md : tes préférences globales valables sur tous tes projets.
Utilise /init dans Claude Code pour générer un CLAUDE.md de base depuis le code existant.
Rédige ton system prompt dans un fichier .md versionné. Le markdown améliore la lisibilité pour toi et la compréhension pour Claude. Dans les Projects Claude.ai, colle-le dans les « Instructions ».
Tu es [NOM], assistant spécialisé en [DOMAINE].
Ton ton est [professionnel / amical / pédagogique].
Tu tutvoies / vouvoies l'utilisateur.
## Ce que tu fais
- [Tâche principale 1]
- [Tâche principale 2]
## Ce que tu NE fais pas
- Tu ne fournis pas de conseils médicaux/légaux
- Tu ne réponds pas en dehors du périmètre
## Format de réponse
- Réponses courtes (max 3 paragraphes)
- Listes à puces si plus de 3 éléments
- Toujours proposer une prochaine étape
## Contexte utilisateur
Audience : jeunes 16-25 ans primo-demandeurs d'emploi.
Utilise les balises XML <role>, <rules>, <examples> pour structurer les sections — Claude les parse très bien.
Versionne ce fichier dans Git : chaque amélioration du prompt est traçable.
Active le prompt caching sur ce fichier si tu l'envoies à chaque requête API.
Si tu n'utilises pas Claude Projects ou Claude Code, crée un fichier context.md que tu colles ou uploades en début de chaque session. Claude lit ce contexte en quelques secondes et travaille immédiatement à son meilleur niveau.
## Qui je suis
Formateur IA en Mission Locale, 35 jeunes/semaine.
Pas développeur — j'utilise Claude via claude.ai.
## Ce sur quoi je travaille
Création d'ateliers IA pour 16-25 ans.
Niveau : débutant absolu, pas de code.
## Mes contraintes
- Contenu doit être validé pédagogiquement
- Pas de jargon technique sans explication
- Format : fiches A4 imprimables
## Décisions prises lors des sessions précédentes
- On utilise des exemples concrets (CV, lettre de motiv)
- On évite les mises en garde répétitives sur l'IA
Garde ce fichier dans ton bureau ou Notion — copier-coller prend 5 secondes.
Mets à jour la section « Décisions prises » après chaque session productive.
Dans Claude Projects : uploade ce fichier une fois — il est rechargé automatiquement.
Claude Code dispose d'un système de mémoire fichier dans ~/.claude/projects/[projet]/memory/. Chaque fichier est un type de souvenir — user, feedback, project, reference — rechargé automatiquement à chaque session. Résultat : Claude se souvient de toi entre les conversations.
---
name: user-identity
description: Qui est l'utilisateur, son rôle, son niveau
metadata:
type: user
---
Formateur IA senior. Pas développeur.
Maîtrise Git, Netlify, HTML/CSS basique.
---
name: feedback-style
description: Préférences de style validées
metadata:
type: feedback
---
Pas de commentaires dans le code sauf si raison
non-évidente. Toujours merger sur main.
**Why:** déploiement Netlify automatique sur main.
4 types : user (qui tu es), feedback (tes corrections), project (contexte en cours), reference (où trouver quoi).
Un fichier MEMORY.md joue le rôle d'index — Claude le lit en premier pour charger uniquement les souvenirs pertinents.
Dis « souviens-toi que… » ou « mémorise ça » à Claude Code — il écrira automatiquement le fichier memory adapté.
Crée une bibliothèque de personas réutilisables : chaque entrée est un rôle prêt à coller en system prompt. Fini les prompts de rôle rédigés à la volée — tu pioches dans ta bibliothèque et tu adaptes en 30 secondes.
## 🧑🏫 Coach pédagogique
Tu es un formateur bienveillant spécialisé
dans la pédagogie pour adultes en insertion.
Ton registre : clair, encourageant, concret.
Jamais de jargon sans définition.
## ✍️ Rédacteur web SEO
Tu es un expert en rédaction web optimisée SEO.
Format : H2 clairs, paragraphes courts (3 lignes max),
bullet points, CTA naturels. Ton : direct, actif.
## 🔍 Auditeur critique
Tu lis le texte fourni comme un lecteur hostile.
Identifie : incohérences, imprécisions, angles
manquants, affirmations non étayées.
Pas de faux encouragements — sois direct.
Stocke ce fichier dans Notion, Obsidian ou Google Drive — accessible partout en quelques secondes.
Pour chaque persona, note le contexte d'usage et un exemple de prompt déclencheur.
Dans Claude Projects : uploade ce fichier et demande à Claude de « choisir le persona adapté » à chaque tâche.
Un fichier de connaissance métier que tu donnes à Claude pour lui fournir le contexte domain qu'il ne peut pas avoir. Produits, processus internes, terminologie maison, règles spécifiques, données clés — Claude les intègre immédiatement.
## Terminologie
- PACEA : Parcours Contractualisé d'Accompagnement
vers l'Emploi et l'Autonomie (contrat d'engagement)
- CEJ : Contrat d'Engagement Jeune (revenu 500€/mois)
- PIJ : Point Information Jeunesse
## Notre public cible
16-25 ans, NEET (Not in Education, Employment
or Training). Niveau scolaire : CAP à Bac+2.
Contexte : fracture numérique fréquente.
## Ce que nous NE faisons PAS
- Pas de conseil juridique ou médical
- Pas d'orientation vers Pôle Emploi (>25 ans)
- Pas de formations longues sans financement validé
Commence petit : 1-2 pages suffisent. Claude s'appuie sur ce référentiel pour toutes ses réponses sans qu'on lui rappelle à chaque fois.
Inclus les erreurs fréquentes à éviter — c'est souvent plus utile que la liste des bonnes pratiques.
Mets à jour ce fichier quand les règles métier changent — c'est ta seule source de vérité pour Claude.
Un fichier d'exemples d'entrée/sortie (few-shot) à inclure dans tes prompts ou system prompts. C'est la technique la plus puissante pour obtenir un format cohérent sur des centaines de requêtes. Claude internalise le pattern dès le premier exemple.
## Format attendu
INPUT: [texte brut de l'offre]
OUTPUT: [version reformulée]
## Exemple 1
INPUT: "Vous serez garant de la satisfaction client
dans un environnement challengeant et innovant."
OUTPUT: "Tu gères les réclamations clients.
Le poste est stressant mais les méthodes changent."
## Exemple 2
INPUT: "Profil autonome, force de proposition,
capable de travailler en mode projet agile."
OUTPUT: "Tu travailles seul·e sans encadrement.
Tu dois proposer des idées. Le planning change souvent."
3-5 exemples bien choisis > 20 instructions abstraites. Choisis des exemples qui couvrent les cas limites et les variantes difficiles.
Versionne ce fichier dans Git — chaque ajout d'exemple améliore la robustesse du système.
Active le prompt caching sur ce fichier si tu l'envoies à chaque requête API.
Ton journal de ce qui fonctionne et ce qui ne fonctionne pas avec Claude. Chaque entrée est une règle apprise — une erreur évitée, une formulation qui marche, un cas spécial découvert. Claude Code le lit automatiquement et évite de répéter les erreurs passées.
## ✅ Ce qui fonctionne bien
- Donner le contexte métier AVANT la tâche
→ réponses bien plus précises et adaptées
- « Réponds en JSON strict » pour les extractions
→ format fiable, parsable sans regex
- Demander un plan avant la rédaction
→ structure plus cohérente, moins d'allers-retours
## ❌ À éviter
- Demandes vagues type « améliore ce texte »
→ résultats imprévisibles, souvent trop génériques
- Prompts > 4 000 tokens sans caching activé
→ coût élevé pour pas grand chose
## 🔍 Cas spéciaux découverts
- Pour les tableaux : préciser les colonnes exact
- Pour le code : toujours donner le stack complet
Mets à jour ce fichier après chaque session où tu as appris quelque chose — 30 secondes suffisent.
Dans Claude Code, ce fichier est rechargé automatiquement — Claude évite les erreurs passées sans qu'on lui rappelle.
Avec le temps, ce fichier devient ton manuel de prompt engineering personnalisé, optimisé pour tes usages spécifiques.