Structurer les Agents de Code Claude avec les Modèles CLAUDE.md et le Répertoire .claude/

Structure des répertoires des agents

La configuration implique la création de répertoires séparés pour chaque agent sous ~/Documents/. L'exemple montre cinq agents : planner (fonction exécutive, routage, responsabilité), content (pipeline de contenu), youtube (production YouTube), life (domaines personnels), et control-center (tableau de bord, base de données, API).

Chaque agent suit cette structure type :

nom-de-l'agent/
├── CLAUDE.md # Identité + mission + capacités
├── .claude/
│   ├── rules/ # Contexte chargé automatiquement (toujours actif)
│   └── skills/ # Flux de travail à la demande
├── inbox/ # Entrées des autres agents
├── outputs/ # Sorties générées
└── archive/ # Rien n'est supprimé sans archivage

Distinction entre règles et compétences

Les fichiers .claude/rules/ sont chargés automatiquement au début de chaque session. Claude les lit comme partie de sa fenêtre de contexte. C'est là que vous placez les choses que l'agent doit toujours connaître — son périmètre, le contexte métier, comment il doit se comporter.

Les fichiers .claude/skills/ sont à la demande. Ils ne se chargent que lorsque vous les invoquez avec /nom-de-la-compétence. C'est là que vous placez les flux de travail spécifiques comme les processus en plusieurs étapes, les modèles, les routines structurées.

Les fichiers de règles se chargent dans votre fenêtre de contexte au début de la session et y restent. Claude Code utilise la mise en cache des prompts pour que le contenu répété ne soit pas facturé au prix complet à chaque tour, mais les gros fichiers de règles augmentent toujours la pression contextuelle et peuvent causer une dégradation des réponses. Avec les compétences, seuls le nom et la description résident dans le contexte par défaut ; le flux de travail complet se charge à la demande, soit lorsque vous l'appelez, soit lorsque Claude décide qu'il est pertinent.

Règle générale

• Règles (toujours actives) : Limites du périmètre, contexte métier, logique de routage, conventions de nommage — choses qui affectent chaque décision
• Compétences (à la demande) : Flux de travail étape par étape, modèles, opérations par lots. Choses que vous faites occasionnellement (Note : les descriptions des compétences sont toujours dans le contexte pour que Claude sache ce qui est disponible ; seul le contenu complet est à la demande)

Contenu de CLAUDE.md

Le fichier CLAUDE.md doit être maintenu sous 120 lignes et couvre :

• Identité (2-3 lignes) : qui est cet agent et ce qu'il fait
• Phase actuelle (2-3 lignes) : sur quoi nous travaillons actuellement
• Capacités principales (10-15 lignes) : quelles compétences sont disponibles, ce qu'il peut faire
• Emplacements clés (10-15 lignes) : chemins de fichiers qu'il doit référencer
• Ce qui a été construit (10-20 lignes) : historique du travail accompli
• Prochaines étapes (5-10 lignes) : priorités immédiates
• Principes (5-10 lignes) : garde-fous comportementaux

Exemple de structure des règles

Pour un agent de planification, le répertoire .claude/rules/ contient des fichiers numérotés qui contrôlent l'ordre de chargement :

.claude/rules/
├── 01-business-context.md # Modèle de revenus, positionnement, clients cibles
├── 02-agent-ecosystem.md # Tous les agents, leurs missions, comment ils se connectent
├── 03-roadmap.md # Phase actuelle, jalons, critères de sortie
├── 04-content-architecture.md # Canaux de contenu, piliers, flux de travail
├── 05-daily-routine.md # Calendrier, filtrage des idées, règles anti-distraction
├── 07-godin-strategy.md # Principes marketing, suivi des jalons
├── 08-control-center.md # Référence des outils CLI, schéma de base de données
├── 98-end-of-session.md # Rituel : mettre à jour la feuille de route, capturer les connaissances
└── 99-content-capture.md # Extraction automatique des signaux de contenu de chaque session

Communication entre agents

Les agents ne s'appellent pas directement. Ils se coordonnent via :

• Base de données SQLite : Source de vérité pour les tâches, l'état du pipeline de contenu, les sessions, les métriques
• Fichiers inbox : Lorsqu'un agent doit transmettre un contexte à un autre, il dépose un fichier markdown dans la boîte de réception de la cible
• Points de terminaison API : Lecture du tableau de bord