AI ilə işləyən tərtibatçılar üçün CLAUDE.md faylı getdikcə daha vacib alətə çevrilir. Lakin mütəxəssislər xəbərdarlıq edir: ən yaxşı CLAUDE.md ən uzun olanı deyil, hər sətirinin Claude'un davranışını dəyişdiyi fayldır. Əsas bacarıq nəyin daxil edilməli olduğunu bilməkdir — eyni dərəcədə vacib olan isə nəyin atılmalı olduğunu anlamaqdır.
Düzgün CLAUDE.md faylı üçün ilk addım layihənizin qısa təsviri və texnoloji yığınınızı (stack) versiya nömrələri ilə yazmaqdır. Claude kodunuzdan çox şey çıxara bilər, amma sizin Next.js 15 yoxsa 14 istifadə etdiyinizi və ya hansı ORM seçdiyinizi təxmin edə bilməz. Sonra qovluq strukturunun xəritəsini verin — hər faylı deyil, yalnız yuxarı səviyyədəki düzülüşü və hər hissənin nə saxladığını qeyd edin. Build və test əmrləri, formatlayıcının tətbiq etmədiyi konvensiyalar və ən əsası — toxunulmamalı olan hissələr haqqında məlumat da daxil edilməlidir.
Nəyi daxil etmək olmaz?
Çox vaxt tərtibatçılar iki növ faydasız məlumatı CLAUDE.md faylına əlavə edirlər. Birincisi, şəxsiyyət təlimatlarıdır: 'böyük mühəndis kimi davran', 'addım-addım düşün', 'diqqətli ol'. Bunlar faydalı görünür, amma əslində heç nəyi dəyişmir — Claude onsuz da bunları edir. İkincisi, artıq linter və ya formatter tərəfindən tətbiq olunan qaydaları təkrar yazmaqdır. Bunları hook'a bağlamaq daha yaxşıdır, CLAUDE.md isə yalnız alətlərin tətbiq edə bilmədiyi şeylər üçün saxlanılmalıdır.
Hər sətir üçün bir test var: 'Bunu çıxarsam, Claude səhv edəcəkmi?' Cavab 'bəli'dirsə, saxlayın. 'Xeyr' isə — silin. Bu sualı sərt şəkildə tətbiq etmək, Claude'un əməl etdiyi faylla görməzlikdən gəldiyi fayl arasındakı əsas fərqdir. Şişmiş fayl vacib qaydaları səs-küydə basdırır və Claude hansı sətrin əhəmiyyətli olduğunu ayırd edə bilmir. Qısaltma təmizlik deyil, faylın işləməsinin tələbidir.
CLAUDE.md hər sessiyada Claude'un kontekstinə yüklənir və kontekst böyüdükcə performans aşağı düşür. Daha yığcam fayl təkcə oxumağı asanlaşdırmır, həm də Claude'u daha etibarlı edir — çünki vacib qaydalar lazımsız məlumatla rəqabət aparmır. Qısalıq burada stil seçimi deyil, performans tələbidir.
Mənbə: Dev.to (https://dev.to/promptmaster/what-to-put-in-your-claudemd-and-what-to-leave-out-4f39)
