Skip to content
Floskool

Chapter 4 · Chapitre 4 · Optimiser ses instructions

4.1 Structurer correctement son fichier

Free lesson 6 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Claude lit ton fichier comme toi tu lirais un document : des titres clairs et des listes courtes le rendent plus facile à suivre. La documentation le dit simplement : des instructions regroupées sous des titres et en puces sont plus faciles à suivre que des paragraphes denses.

La structure qui marche

# Nom du projet
Une phrase qui dit ce qu'est le projet.

## Audience
## Style et ton
## Règles (toujours / jamais)
## Façon de travailler
## Organisation des fichiers
## Commandes utiles

Pourquoi cet ordre ? Parce que les sections du haut changent le résultat de chaque demande (pour qui, avec quel ton, avec quelles limites), alors que celles du bas servent de repères pratiques.

Les bonnes pratiques

  • Une idée par ligne, sous forme de puce.
  • Des titres (##) pour regrouper ce qui va ensemble.
  • Le plus important en haut.
  • Moins de 200 lignes par fichier, comme le conseille la documentation.
  • Des mots constants : si tu dis « hook » dans une section, ne dis pas « accroche » dans une autre pour la même chose.

Avant / après dans mes-videos-ia

Avant, un paragraphe difficile à suivre :

Mes vidéos sont pour des débutants et doivent être courtes, environ 40 à 55 secondes,
avec un début qui accroche, et j'aimerais qu'on évite le jargon, d'ailleurs les fichiers
sont dans video-XX et il faut me montrer le script avant.

Après, une structure claire :

## Audience
Débutants en IA, sans connaissances techniques.

## Vidéos
- 40 à 55 secondes, verticales.
- Hook dans la première phrase : une question ou un constat.
- Pas de jargon ; un mot technique est expliqué en une phrase.

## Façon de travailler
- Montre-moi le script avant de produire.

## Organisation des fichiers
- video-XX/ : un dossier par vidéo.

Même contenu, mais chaque règle est maintenant repérable, vérifiable et modifiable sans toucher aux autres.

Découper avec les imports

Si un sujet prend de la place (par exemple ta charte graphique détaillée), mets-le dans un autre fichier et importe-le avec @ :

## Charte graphique
Voir @docs/charte.md

Le fichier importé est chargé avec CLAUDE.md. Quelques détails vérifiés dans la documentation :

  • les chemins peuvent être relatifs ou absolus ; un chemin relatif part du fichier qui contient l'import, pas du dossier de lancement ;
  • les imports peuvent s'enchaîner jusqu'à 4 niveaux ;
  • la première fois qu'un CLAUDE.md de projet importe un fichier situé hors de ton dossier de travail, Claude Code affiche une fenêtre d'approbation listant ces fichiers.

Attention : les imports rendent le fichier plus lisible, mais ils ne réduisent pas la place occupée dans le contexte. Pour du contenu utile seulement de temps en temps, un skill ou une règle .claude/rules/ avec paths est plus économe.

Astuce : un chemin écrit entre accents graves (par exemple `@docs/charte.md`) n'est pas importé ; c'est utile pour le citer sans le charger. Et si ton chemin contient des espaces, la documentation indique de mettre une barre oblique inversée avant chaque espace.

Si ça coince

  • Le fichier importé ne semble pas lu : vérifie le chemin (relatif au fichier qui importe) et regarde dans /context s'il apparaît. S'il est entre accents graves, il n'est pas importé.
  • Une fenêtre demande d'approuver des imports : c'est normal pour des fichiers hors du dossier du projet. Approuve seulement si tu connais ces fichiers.
  • Ton fichier reste trop long malgré les imports : c'est attendu, les imports ne réduisent pas le contexte. Déplace les procédures en skills et les règles partielles en .claude/rules/ avec paths.

À retenir

  • Titres ##, une idée par puce, le plus important en haut.
  • Moins de 200 lignes par fichier.
  • @chemin importe un fichier, jusqu'à 4 niveaux.
  • Les imports organisent, ils n'allègent pas le contexte.