Le fichier CLAUDE.md
C’est quoi CLAUDE.md ?
Section intitulée « C’est quoi CLAUDE.md ? »CLAUDE.md est le contrat de travail de Claude Code. C’est un fichier Markdown situé à la racine du répertoire de travail (/home/sidy/CLAUDE.md) qui est automatiquement lu au démarrage de chaque session.
Il définit :
- Le rôle de Claude Code (“Laborantin DevOps”)
- Les procédures obligatoires à suivre
- Les règles de travail (Git, journal, sécurité)
- La structure de la documentation
Les sections du CLAUDE.md Levell
Section intitulée « Les sections du CLAUDE.md Levell »Section 1 — Protocole de démarrage obligatoire
Section intitulée « Section 1 — Protocole de démarrage obligatoire »À chaque nouvelle session, Claude Code doit :
- Afficher “BINGO 🦩” en première ligne
- Exécuter le check-up serveur complet
- Mettre à jour le journal
Ce protocole garantit qu’on ne rate jamais un problème critique (disque plein, container crashé, etc.).
Section 2 — Rôle : Laborantin DevOps
Section intitulée « Section 2 — Rôle : Laborantin DevOps »Définit la posture de Claude Code : expert en infrastructure, proactif, orienté sécurité.
Section 3 — Check-up serveur
Section intitulée « Section 3 — Check-up serveur »Les commandes exactes à exécuter au démarrage et le seuil d’alerte disque (40%).
Section 4 — Journal de bord
Section intitulée « Section 4 — Journal de bord »Les règles strictes pour documenter chaque action dans .lab_tracking/journal.md et .lab_tracking/erreurs_connues.md.
Section 5 — Configuration MCP
Section intitulée « Section 5 — Configuration MCP »Les instructions pour ajouter/configurer des serveurs MCP.
Section 6 — Workflow Git
Section intitulée « Section 6 — Workflow Git »La règle : commiter + pusher après chaque modification de fichier dans /docker/*/. Le post-commit hook s’en occupe automatiquement.
Section 7 — Structure des réponses
Section intitulée « Section 7 — Structure des réponses »Le format que Claude Code doit suivre : lecture du contexte, analyse, exécution, mise à jour du lab_tracking.
Section 8 — Contexte
Section intitulée « Section 8 — Contexte »L’ordre de lecture obligatoire au début de chaque tâche : context.md → erreurs_connues.md → dernières entrées journal.md.
Les fichiers de contexte
Section intitulée « Les fichiers de contexte »Ces fichiers sont dans /home/sidy/.lab_tracking/ :
| Fichier | Contenu |
|---|---|
context.md | Clés API, URLs, IDs workflows, patterns connus — source de vérité |
journal.md | Historique chronologique de toutes les actions |
erreurs_connues.md | Bugs documentés avec symptôme, cause, solution |
Modifier CLAUDE.md
Section intitulée « Modifier CLAUDE.md »Si tu veux changer le comportement de Claude Code (ajouter une règle, une convention, un pattern) :
"Mets à jour CLAUDE.md pour que tu fasses toujours X quand Y se passe"Claude Code modifie le fichier et la règle sera active dès la prochaine session.
Exemple de règle ajoutée
Section intitulée « Exemple de règle ajoutée »La règle du seuil disque 40% a été ajoutée après qu’on a découvert que le cache Docker mangeait 18 GB. Maintenant Claude Code vérifie et purge automatiquement au démarrage.
C’est comme ça qu’on améliore le “protocole” progressivement — une règle à la fois, basée sur ce qu’on apprend en pratique.