Passage des règles CLAUDE.md à l'application par l'infrastructure avec Citadel

Le problème de l'accumulation de règles

Quand Claude ignorait les instructions, l'instinct était d'ajouter plus de règles à CLAUDE.md. Partant de 45 lignes, il est passé à 190 lignes en trois mois, mais la conformité s'est détériorée. Les instructions au-delà de la ligne 100 ont commencé à être traitées comme des suggestions plutôt que des règles. Un audit approfondi a révélé 40% de redondance – des règles disant la même chose avec des mots différents, des règles se contredisant, et des règles obsolètes. Réduire à 123 lignes a immédiatement amélioré la conformité.

Le changement d'infrastructure

La vraie solution a été de reconnaître CLAUDE.md comme un point d'entrée pour l'orientation (conventions du projet, pile technique, priorités clés), et non comme une maison permanente pour toutes les règles. Tout le reste devrait être chargé uniquement quand c'est nécessaire. Le changement clé : déplacer l'application des règles des instructions vers l'environnement.

Par exemple, au lieu d'une règle disant "toujours exécuter la vérification de type après avoir modifié un fichier", que Claude suivait de manière incohérente, un script de hook de cycle de vie s'exécute automatiquement à chaque sauvegarde de fichier. Cela garantit que la vérification de type se fait sans choix de l'agent, révélant les erreurs immédiatement plutôt que 20 modifications plus tard. Cela a réduit considérablement le temps de relecture, permettant de se concentrer sur l'intention et la conception plutôt que de courir après les erreurs de type.

Le système de progression

L'auteur décrit une progression à cinq niveaux :

• Niveau 1 : Prompting brut (rien ne persiste, les mêmes erreurs se répètent)
• Niveau 2 : CLAUDE.md (les règles aident mais atteignent un plafond vers 100 lignes)
• Niveau 3 : Compétences (expertise modulaire qui se charge à la demande, zéro token quand inactif)
• Niveau 4 : Hooks (l'environnement applique la qualité, pas les instructions)
• Niveau 5 : Orchestration (agents parallèles, campagnes persistantes, vagues coordonnées)

La plupart des projets se portent bien au Niveau 2 ou 3. L'idée cruciale : quand CLAUDE.md cesse de fonctionner, la solution n'est pas plus de règles – c'est de déplacer l'application dans l'infrastructure.

Implémentations spécifiques

L'auteur a mis en œuvre trois systèmes clés :

• Compétences : Fichiers Markdown encodant des modèles, des contraintes et des exemples pour des domaines spécifiques. L'agent charge les compétences pertinentes pour la tâche actuelle, évitant le gaspillage de tokens sur un contexte non pertinent.
• Fichiers de campagne : Documents structurés suivant ce qui a été construit, les décisions prises et ce qui reste. Ils persistent entre les sessions, éliminant les ré-explications quotidiennes.
• Hooks automatisés : Vérification de type à chaque modification, analyse d'anti-modèles à la fin de la session, disjoncteur arrêtant l'agent après 3 échecs répétés sur le même problème, et protection de compaction sauvegardant l'état avant que Claude ne compresse le contexte.

Citadel : Le système open-source

Le système complet, appelé Citadel, a été publié en open-source sur https://github.com/SethGammon/Citadel. Il inclut le système de compétences, les hooks, la persistance des campagnes, et une commande /do qui achemine automatiquement les tâches au bon niveau d'orchestration. Construit à partir de 27 échecs documentés sur 198 agents sur une base de code de 668K lignes, chaque règle remonte à quelque chose qui a cassé.