Structure de Code Claude Qui a Survécu à Plusieurs Projets Réels

Ce qui a fonctionné après plusieurs projets

Un développeur sur r/ClaudeAI a partagé sa structure Claude Code qui n'a pas cassé après l'avoir implémentée sur 2-3 projets réels. Cette configuration a tenu le coup une fois qu'ils ont ajouté plusieurs compétences, serveurs MCP et agents, dépassant ainsi les simples démos.

Décisions structurelles clés

• Utiliser CLAUDE MD : Ignorer CLAUDE MD au début a conduit à des résultats incohérents. Une fois qu'ils ont défini des conventions, des règles de test et des normes de nommage, les résultats sont devenus plus prévisibles.
• Séparer les compétences par intention : Organiser les compétences comme code-review/, security-audit/, text-writer/ a mieux fonctionné que de tout regrouper dans un seul endroit. Cela a rendu l'activation plus propre.
• Mettre en œuvre des hooks : Ne pas utiliser de hooks au départ était une erreur. Les hooks PreToolUse et PostToolUse ont aidé à détecter les mauvaises commandes et les sorties désordonnées, et étaient utiles pour les petites automatisations.
• Séparer les agents : L'approche à agent unique n'a pas bien évolué. Avoir des agents dédiés pour la relecture, l'écriture et l'audit s'est avéré plus prévisible.
• Gérer l'utilisation du contexte : Lorsque l'utilisation du contexte devient trop élevée, la qualité baisse. La maintenir sous environ 60% a fait une différence notable.
• Séparer les préoccupations : Mélanger la configuration, les compétences et la logique d'exécution a rendu le débogage pénible. Garder ces éléments séparés a rendu tout plus facile à comprendre.

Intégration MCP

L'intégration MCP (Model Context Protocol) avec GitHub, Postgres et l'accès au système de fichiers a complètement changé le comportement de Claude. Selon le développeur, c'est à ce moment que la configuration a cessé de ressembler à un jouet et a commencé à se comporter davantage comme un assistant de développement plutôt que comme une simple entrée → sortie.

Le développeur note qu'il cherche encore la manière la plus propre de structurer les agents, mais cette configuration fonctionne actuellement bien pour les projets qui dépassent les simples démos.