Aller au contenu
Floskool

Chapitre 6 · Chapitre 6 · Combiner CLAUDE.md et les skills

6.2 Organiser les instructions de ton projet

Leçon gratuite 6 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Voici une organisation claire, de la plus générale à la plus précise :

~/.claude/CLAUDE.md              ← toi partout : langue, ton, façon de travailler
mon-projet/
  CLAUDE.md                      ← le projet : audience, style, règles, dossiers
  CLAUDE.local.md                ← tes notes perso sur ce projet (dans .gitignore)
  .claude/
    rules/
      site.md                    ← règles chargées seulement pour certains fichiers (paths)
    skills/
      video-faceless/SKILL.md    ← procédure : créer une vidéo
      publication/SKILL.md       ← procédure : publier sur les réseaux

Qui contient quoi

  • ~/.claude/CLAUDE.md : « Réponds en français. Explique simplement. Demande avant de supprimer. »
  • mon-projet/CLAUDE.md : « Public : débutants. Vidéos de 40 à 55 s. Jamais de chiffre inventé. »
  • CLAUDE.local.md : « Mon dossier de rushs est sur le disque D:. »
  • .claude/rules/site.md : « Pages HTML : une seule balise h1. » (avec paths)
  • skills/video-faceless : les 4 étapes de fabrication, avec validations.
  • skills/publication : la préparation des légendes par réseau et la création d'un brouillon.

Ce qui est chargé, et quand

  • Au démarrage : ~/.claude/CLAUDE.md, CLAUDE.md du projet, CLAUDE.local.md, les règles sans paths, et les descriptions des skills.
  • Quand Claude ouvre un fichier qui correspond : les règles avec paths et les CLAUDE.md des sous-dossiers.
  • Quand un skill sert : le contenu complet de son SKILL.md.

Cette organisation garde le démarrage léger tout en rendant disponibles des procédures très détaillées.

Un exemple de parcours complet

Tu lances Claude Code dans mes-videos-ia et tu demandes « Fais une vidéo sur les agents IA ». Au démarrage, Claude a déjà ton fichier personnel (français, explications simples), le CLAUDE.md du projet (public débutant, 40 à 55 secondes) et ta note locale (rushs sur D:). Il reconnaît dans les descriptions que le skill video-faceless correspond, charge ses étapes, et s'arrête à chaque validation. Si, pendant le montage, il ouvre une page HTML du dossier site/, la règle site.md se charge à ce moment-là seulement. Chaque fichier joue son rôle, sans doublon.

Les deux règles d'organisation

  1. Ne jamais dupliquer une règle à deux endroits : en cas de changement, tu en oublierais un.
  2. Le skill s'appuie sur CLAUDE.md au lieu de le répéter : « Respecte le style défini dans CLAUDE.md. »

Migrer pas à pas un CLAUDE.md trop chargé

Si ton fichier actuel mélange tout, voici l'ordre à suivre :

  1. Repère les procédures (listes d'étapes) : elles deviennent des skills.
  2. Repère les règles qui ne concernent qu'une partie du projet : elles vont dans .claude/rules/ avec paths, ou dans un CLAUDE.md de sous-dossier.
  3. Repère tes préférences personnelles : elles vont dans ~/.claude/CLAUDE.md (tous tes projets) ou CLAUDE.local.md (ce projet).
  4. Ce qui reste, vrai pour tout le projet à chaque session, reste dans CLAUDE.md.

Le prompt pour te faire aider :

Analyse CLAUDE.md et classe chaque section : à garder, à transformer en skill, à déplacer dans .claude/rules/ (avec quel motif paths), ou à déplacer dans CLAUDE.local.md / ~/.claude/CLAUDE.md. Présente-moi un plan de réorganisation, sans rien modifier.

Applique ensuite le plan par petites étapes, en testant dans une nouvelle session après chaque déplacement.

Si ça coince

  • Tu ne sais plus où se trouve une règle : tape /context pour voir les fichiers chargés, ou demande « Dans quel fichier se trouve la règle sur la durée des vidéos ? ».
  • La même règle existe à deux endroits : garde-la à l'endroit le plus logique et supprime l'autre.
  • Une règle .claude/rules/ ne s'applique jamais : son motif paths ne correspond à aucun fichier ouvert. Corrige le motif.

À retenir

  • Du plus général au plus précis : personnel, projet, local, rules, skills.
  • Le démarrage charge les fichiers principaux et les descriptions de skills.
  • Une règle à un seul endroit, jamais en double.
  • Les skills s'appuient sur CLAUDE.md au lieu de le répéter.