Claude md that follows

Notes d'étude : Optimisation du fichier CloudMD

• Nature du CloudMD : Le fichier CloudMD n'est pas une configuration imposée, mais une série de directives.
• Problème de taille : Un fichier trop long est difficile à suivre pour Cloud, car il doit gérer une concurrence interne entre ses propres instructions.
• Hiérarchie des fichiers : Cloud charge tous les fichiers de mémoire. L'ordre de priorité est :
• Politique gérée → Fichier utilisateur → Fichier projet → Local.
• Portée (Scope) : Le scope "Local" est destiné aux décisions architecturales personnelles (ex: refactoring de sprint), et non aux décisions partagées du projet.
• Organisation :
• Utiliser la syntaxe de chemin de fichier pour diviser les instructions.
• Les imports aident à l'organisation, mais tout est chargé au lancement (ils ne réduisent pas le contexte).
• Qualité des règles :
• Les règles doivent être spécifiques et vérifiables. Éviter les termes vagues (ex: "suivre les meilleures pratiques").
• Être explicite (ex: "Ajouter une nouvelle route API et un gestionnaire de source API, un par fichier").
• Utiliser des exports nommés plutôt que des exports par défaut pour éviter les interprétations erronées.
• Priorité et Maintenance :
• L'accent (emphasis) est limité ; il doit être utilisé uniquement pour les règles critiques.
• Traiter le CloudMD comme du code de production : si vous ne pouvez pas justifier une ligne, supprimez-la.
• Enforcement (Règles strictes) : Les règles d'application stricte (ex: interdire les pushes sur main) doivent être déplacées vers des hooks (pré-outil), car le CloudMD n'est pas un outil d'application forcé.
• Principe clé : Plus le fichier CloudMD est léger, plus Cloud le suit fidèlement.

Takeaways

• Un fichier CloudMD léger est crucial pour garantir que Cloud le suive fidèlement.
• L'ordre de priorité des fichiers est : Politique gérée → Fichier utilisateur → Fichier projet → Local.
• Les règles doivent être spécifiques, vérifiables et explicites, en évitant les termes vagues.
• CloudMD n'est pas un outil d'application forcé ; les règles strictes (ex: interdire des pushes) doivent être gérées via des hooks.