Claude md that follows

CloudMD: Schlüsselkonzepte für die Konfiguration

• Dateigröße und Komplexität: Die CloudMD-Datei ist keine erzwungene Konfiguration. Zu große Dateien führen zu Fehlinterpretationen durch das System.
• Lösung: Halte die CloudMD-Datei so kurz und prägnant wie möglich.
• Harte Regeln: Für strikte Regeln (z. B. "niemals auf main pushen") sollten Pre-Tool-Use Hooks verwendet werden, da diese den Push verhindern.
• Speicherorte (Memory Files): CloudMD existiert an vier Stellen:
• Managed Policy
• User File
• Project File
• Local
• Ladeverhalten: Cloud lädt alle Speicherdateien gleichzeitig. Die Organisationsrichtlinien (Org Policy) sind immer aktiv.
• Scope (Umfang): Der Bereich "Local" ist für persönliche architektonische Entscheidungen und Refactoring innerhalb des Projekts reserviert.
• Organisation: Nutze die Pfad-zu-Datei-Syntax, um Anweisungen zu splitten und die Wartbarkeit zu erhöhen.
• Imports: Imports helfen bei der Organisation, erweitern die Datei jedoch bei Start in einer Zeile und reduzieren den Kontext nicht.
• Regelqualität: Die Formulierung ist entscheidend. Vage Regeln (z. B. "Best Practices befolgen") führen zu Fehlern.
• Spezifität: Sei explizit und überprüfbar (z. B. "Neue API-Routen und Source API Handlers, jeweils eine pro Datei").
• Exporte: Verwende benannte Exporte (named exports) anstelle von Standardexportern (default exports), um Mehrdeutigkeiten zu vermeiden.
• Betonung: Die Betonung ist ein begrenztes Budget. Setze sie nur auf die zwei oder drei kritischsten Regeln.
• Wartung: Behandle die CloudMD-Datei wie Produktionscode. Wenn eine Zeile nicht gerechtfertigt ist, lösche sie.
• Ziel: Je schlanker die Datei, desto besser die Einhaltung der Regeln durch Cloud.

Takeaways

• Die CloudMD-Datei muss kurz und prägnant gehalten werden, da zu große Dateien zu Fehlinterpretationen durch das System führen.
• Strikte Regeln (z. B. Verbot von Pushes) sollten über Pre-Tool-Use Hooks implementiert werden, nicht nur in der CloudMD-Datei.
• Regeln müssen explizit und überprüfbar formuliert sein; vage Anweisungen führen zu Fehlern.
• Die CloudMD existiert an vier Speicherorten (Managed Policy, User File, Project File, Local) und sollte mithilfe von Pfad-zu-Datei-Syntax strukturiert werden.