Claude md that follows

Studie-opmerkingen: CloudMD Best Practices

Algemene Principes van CloudMD

• Geen Afdwingende Configuratie: CloudMD is geen harde, afdwingbare configuratie. Te grote bestanden maken het voor Cloud moeilijk om instructies correct te volgen.
• Kwaliteit boven Kwantiteit: De duidelijkheid van CloudMD hangt af van de formulering. Vage regels falen.
• Lean is Better: Hoe korter en duidelijker het bestand, hoe beter Cloud de regels volgt.

Plaatsing en Scope van Regels

• Tool Selectie: Harde regels (bijv. nooit pushen naar 'main') horen in pre-tool use hooks, omdat deze de actie stoppen, in plaats van in CloudMD.
• Regelhiërarchie (Scope): Regels bestaan op verschillende niveaus:
• Managed Policy (Hoogste prioriteit)
• User File
• Project File
• Local (Laagste prioriteit)
• Gebruik van 'Local': Gebruik het 'Local' niveau voor persoonlijke architecturale beslissingen binnen een project (bijv. beslissingen tijdens een sprint).

Onderhoud en Structuur

• Splitsing met Pad-Syntax: Gebruik de pad-naar-bestand-syntax om instructies op te splitsen en het hoofdbestand te onderhouden.
• Imports: Imports helpen bij het organiserend van grote bestanden, maar ze worden in line geëxpandeerd bij het laden en verminderen de context niet.
• Focus op Specificiteit:
• Wees specifiek en controleerbaar. Vermijd vage termen zoals "volg best practices".
• Geef expliciete instructies (bijv. "Plaats nieuwe API routes en source API handlers, één per bestand").
• Gebruik named exports in plaats van default exports om misinterpretatie te voorkomen.
• Prioriteit (Emphasis): Gebruik de budget voor nadruk (emphasis) alleen op de 2 of 3 meest kritieke regels.

Workflow en Debugging

• Behandel als Productiecode: Behandel je CloudMD-bestand als productiecode. Als een regel niet te rechtvaardigen is, verwijder deze.
• Bugrapportage: Als Cloud een fout maakt, behandel dit dan als een bugrapport tegen het CloudMD-bestand. Voeg de correctie toe aan het bestand.
• Optimalisatie: Verplaats afdwingingen naar hooks en gebruik pad-specifieke conventies zodat regels alleen laden wanneer ze van toepassing zijn.

Takeaways

• CloudMD vereist kwaliteit boven kwantiteit; wees kort, duidelijk en specifiek in je instructies.
• Regels hebben een hiërarchie: Managed Policy heeft de hoogste prioriteit, gevolgd door User File, Project File en Local.
• Harde, afdwingbare regels moeten in pre-tool use hooks worden geplaatst, aangezien CloudMD geen afdwingende configuratie is.
• Gebruik expliciete instructies en named exports om vage regels en misinterpretatie te voorkomen.