---
name: claude-md-projet
description: Gabarit de fichier CLAUDE.md à placer à la racine d'un projet Claude Code. Donne les instructions permanentes que Claude lit à chaque session : but, structure, commandes, conventions, garde-fous.
type: skill
niveau: 4
outils: fichier de projet (aucun appel d'outil)
---

# Modèle CLAUDE.md pour un projet Claude Code

## Quand l'utiliser
Au démarrage d'un projet Claude Code, pour écrire une fois les règles que Claude relira à chaque session, au lieu de tout réexpliquer. À adapter à votre projet : restez court et concret, un fichier trop long se dilue.

## Instructions
Le bloc ci-dessous est le gabarit à copier dans un fichier nommé `CLAUDE.md`, à la racine de votre projet. Remplacez les éléments entre crochets, supprimez les lignes inutiles. Commencez par une dizaine de lignes ; ajoutez une règle chaque fois que vous corrigez Claude deux fois sur la même chose.

```
# Projet : [nom du projet]

## But
[En deux phrases : ce que fait ce projet et pour qui.]

## Structure des dossiers
- [dossier] : [ce qu'il contient]
- [dossier] : [ce qu'il contient]

## Commandes utiles
- Installer : [commande]
- Lancer en local : [commande]
- Tester : [commande]

## Conventions
- Langue de travail et de réponse : français.
- Style : [ton, format des messages, conventions de nommage].
- [Règle métier ou technique importante.]

## Préférences de collaboration
- Annonce ton plan avant toute action non triviale et attends ma validation.
- Pour toute opération sur des fichiers, teste d'abord sur une copie ou un échantillon.
- Ne réalise aucune action irréversible (suppression, envoi, publication, déploiement) sans me demander confirmation.

## Garde-fous
- Ne colle ni n'écris jamais de données sensibles (mots de passe, coordonnées bancaires, données médicales nominatives, documents confidentiels de tiers).
- Sur tout fait chiffré ou toute source citée, indique d'où vient l'information ; si tu n'es pas sûr, dis-le explicitement.
- Si une consigne te paraît ambiguë, pose une question avant d'agir.
```

Conseils d'usage :
- Mettez dans CLAUDE.md ce qui *guide* le travail. Ce qui doit arriver *à coup sûr et automatiquement* (lancer un test après chaque modification, par exemple) relève plutôt d'un hook (voir Niveau 4, chapitre 17).
- Évitez d'entasser des dizaines de consignes contradictoires : un fichier clair et bref vaut mieux qu'un règlement illisible.

## Entrées attendues
Les informations de votre projet : nom, but, structure des dossiers, commandes, conventions, préférences. Vous remplissez le gabarit, Claude n'a rien à inventer.

## Sortie attendue
Un fichier `CLAUDE.md` rempli, court et concret, placé à la racine du projet et relu par Claude Code à chaque session.

## Importer cet agent
- Claude Code : copiez le bloc encadré ci-dessus dans un fichier `CLAUDE.md` à la racine de votre projet, puis complétez-le. Claude le lira automatiquement au démarrage de chaque session.
- Vous pouvez aussi enregistrer ce fichier sous `.claude/skills/claude-md-projet/SKILL.md` pour qu'il vous serve d'aide-mémoire à la création d'un nouveau CLAUDE.md.