CLAUDE.md faylına nə yazmalı

Claude Code-a layihənin eyni qaydalarını dönə-dönə izah edirsinizsə, onları CLAUDE.md faylında qeyd edin. Bu, Markdown formatında adi mətn faylıdır. Claude Code onu sessiyanın əvvəlində oxuyur və digər kontekstlə yanaşı sizin razılaşmalarınızı da nəzərə alır.

Başlamaq üçün bir neçə yoxlanmış sətir kifayətdir: harada işləmək, nəticəni necə yoxlamaq və dəyişikliklər zamanı nəyi qorumaq lazımdır.

CLAUDE.md nümunəsi

Kartları olan sadə bir səhifə götürək. HTML quruluşu, stillər və JavaScript bir index.html faylındadır, səhifəni birbaşa brauzerdə açmaq olar. Belə bir layihə üçün təlimat faylı bu cür görünə bilər:

# CLAUDE.md

## Layihə
- Səhifə, stillər və JavaScript `index.html` faylındadır.

## Yoxlama
- `index.html` faylını brauzerdə açın.
- Səhifəni geniş və dar ekranda yoxlayın.

## Qaydalar
- Kartların hazırkı rənglərini və üslubunu qoruyun.
- Təsdiq almadan hazır blokları silməyin.
- İşdən sonra dəyişiklikləri və yoxlamaları sadalayın.

Burada üç qrup var: layihənin quruluşu, nəticənin yoxlanması və razılaşmalar. İndi "daha bir kart əlavə edin" tapşırığında bütün qaydaları yenidən sadalamaq lazım deyil. Bununla belə, səhifəni özünüz yoxlaya bilərsiniz: agentin belə aləti yoxdursa, təlimatın olması ona brauzerə giriş vermir.

Bu, bir fayl üçün nümunədir, universal şablon deyil. Layihənizdə ayrı qovluqlar və başlatma əmrləri ola bilər. Məhz onları qeyd edin; test yoxdursa, sırf tam görünsün deyə əmr uydurmayın.

Nələri qeyd etmək lazımdır

Əsas meyar budur: bu qeydə növbəti tapşırıqlarda ehtiyac olacaqmı? Yoxlanmış əmrlər, vacib yollar və agentin koddan etibarlı şəkildə çıxara bilməyəcəyi razılaşmalar faydalıdır. Xüsusilə də siz onları artıq təkrar izah etmisinizsə.

Qaydanı elə ifadə edin ki, agentdən hansı hərəkətin gözlənildiyi aydın olsun:

• "hər şeyi yoxla" → "kartları dəyişəndən sonra səhifəni geniş və dar ekranda yoxla";
• "vacib şeylərə toxunma" → "təsdiq almadan hazır blokları silmə: onların məzmunu artıq razılaşdırılıb".

Birinci nümunədə yoxlama, ikincidə isə məhdudiyyətin əhatəsi və səbəbi göstərilir. Bu, "diqqətlə işlə" kimi uzun arzu siyahısından daha faydalıdır.

README.md insana qarşısındakı layihənin nə olduğunu və işə necə başlayacağını izah edir. CLAUDE.md isə agent üçün təlimatları toplayır. Bütün README məzmununu təkrarlamaq lazım deyil. "Deyəsən, yazı kartın eninə görə yerindən sürüşür" ehtimalını isə cari tapşırığın qeydində saxlayın, məsələn PROJECT_NOTE.md faylında. Bu, özünüzün seçdiyiniz adda adi fayldır; tapşırığı davam etdirəndə agentdən onu oxumasını istəyin.

Ehtimalı təsdiqlənmiş fakt kimi yazmayın, burada parol və ya giriş açarları da saxlamayın. Ümumi CLAUDE.md faylını adətən Git-ə əlavə edirlər ki, həmkarlarınız da layihə ilə birlikdə eyni təlimatları alsın.

Faylı necə yaradıb yoxlamaq olar

Artıq bildiyiniz qaydalardan başlayın. Uzun səhv siyahısının yığılmasını gözləmək və ya mümkün olan bütün halları qabaqcadan təsvir etmək lazım deyil.

1. Layihədə hazır CLAUDE.md faylının olub-olmadığına baxın. Varsa, oxuyub tamamlayın. Yeni fayl üçün layihənin kök qovluğunu seçin; .claude/CLAUDE.md yolu da dəstəklənir, amma hər iki nüsxəni yaratmağa ehtiyac yoxdur.
2. Bir neçə sətri özünüz yazın və ya layihə qovluğunda açılmış Claude Code-da /init daxil edin. Əmr layihəni araşdırıb qaralama hazırlayacaq; mövcud fayl üçün isə təkmilləşdirmələr təklif edəcək.
3. Nəticəni oxuyun. Əmrləri və yolları layihə ilə tutuşdurun, fərziyyələri silin. Məsələn, agent sizdə olmayan test əmrini yazıbsa, onu çıxarın. Yalnız sizin bildiyiniz məhdudiyyətləri özünüz əlavə edin.
4. Faylı saxlayın və layihə qovluğunda yeni sessiya açın. /context daxil edin: Memory files bölməsində CLAUDE.md faylınızın yolu olmalıdır.

Sonra kiçik bir dəyişiklik sınayın: məsələn, daha bir kart əlavə etməyi istəyin və rənglərin qorunub-qorunmadığına, yoxlamalar barədə hesabatın yaranıb-yaranmadığına baxın. Fayl siyahıda görünmürsə, əvvəlcə adını və başladığınız qovluğu yoxlayın. Görünür, amma nəticə qaydaya uyğun gəlmirsə, ifadəni və mümkün ziddiyyətləri nəzərdən keçirin.

Qalan qeydləri harada saxlamaq olar

İlk layihə üçün bir CLAUDE.md kifayətdir. Şəxsi göstərişlər və ya çoxlu ümumi qaydalar yarananda, qeydlər üçün yer seçməyə bu sxem kömək edəcək:

Ümumi qayda yalnız bir qovluğa aid ola bilər, amma yenə də bütün komandaya lazım ola bilər. .claude/rules/ bu cür təlimatları mövzulara görə ayırmağa kömək edir; konkret yollarla məhdudlaşdırma ayrıca sazlanır. Cəmi bir-iki qayda varsa, strukturu mürəkkəbləşdirməyin.

CLAUDE.local.md bu layihədə qısa cavablara üstünlük vermək kimi şəxsi göstərişlər üçün uyğundur. Commit etməmək üçün onu .gitignore faylına əlavə edin. Agent lokal faylı da oxuyur, ona görə sirləri orada da saxlamayın.

Auto memory (avtomatik yaddaş) mexanizm aktiv olduqda Claude-un iş zamanı saxladığı ayrıca qeydlərdir. Vacib qaydanı yalnız onun ixtiyarına buraxmayın: onu CLAUDE.md faylına əlavə etməyi birbaşa istəyin. Xəta barədə müvəqqəti fərziyyə isə tapşırıq qeydində qalır.

Layihədə artıq AGENTS.md varsa, məzmununu ikinci fayla köçürməyin. CLAUDE.md faylında @AGENTS.md sətri ilə yanaşıdakı faylı qoşmaq olar. Bu, xüsusilə CLAUDE.local.md əlavə edəndə faydalıdır: şəxsi fayl AGENTS.md-nin birbaşa oxunmasına təsir göstərə bilər. Digər variantlar sənədlərdə təsvir olunub.

Qaydaları nə vaxt yeniləməli

Faylı layihə ilə birlikdə redaktə edin. Stilləri index.html faylından ayrıca fayla çıxarmısınızsa, quruluş barədə sətri də dəyişin. Yoxlama üsulu dəyişibsə, köhnə təlimatı yeniləyin. Ziddiyyətli köhnə qaydanın üstünə yenisini əlavə etməyin.

Təkrarlanan düzəlişi agentə tapşıra bilərsiniz: "CLAUDE.md faylına hazır bloku silməzdən əvvəl məndən təsdiq almaq lazım olduğunu əlavə et". Sonra dəyişikliyi oxuyun: o, razılaşmanızı çatdırmalı, özündən yeni məhdudiyyətlər artırmamalıdır. Çox vaxt bir sətir kifayət edir.

Qayda pozulubsa, onu daha üç dəfə təkrarlamaq əvəzinə əvvəlcə səbəbi araşdırın. Köhnəlmiş qeydləri silin və yalnız növbəti tapşırığa kömək edənləri saxlayın.