CLAUDE.md, Claude'un projenizi nasil anladigini sekillendiren tek dosyadir. Iyi yazilmis bir CLAUDE.md daha az duzeltme, daha iyi kod ve gercekten ne uzerinde calistiklarini bilen ajanlar demektir.
Bu kilavuz, teknoloji yigini bildirimlerinden ajana ozgu ipuclarina kadar CLAUDE.md dosyasinin her bolumunu anlatir. Takip edin ve kendinizinkini adim adim olusturun.
CLAUDE.md, projenizin kokune yerlestirdiginiz bir markdown dosyasidir. Claude Code bir oturum basltatiginda bu dosyayi ilk okur. Icindeki her sey Claude'un baglaminin parcasi olur: teknoloji yigininiz, dosya yapiniz, ekibinizin kurallari ve her ajanin uymasini istediginiz ozel talimatlar.
Bunu bir brifing belgesi olarak dusunun. Bu dosya olmadan Claude projenizin nasil duzenledigini tahmin etmek zorunda kalir. Iyi bir CLAUDE.md ile Claude her seyin nerede oldugunu, hangi kaliplari izlemesi gerektigini ve nelerden kacinmasi gerektigini zaten bilir. Cikti kalitesindeki fark onemlidir.
“CLAUDE.md'ye yapilan 10 dakikalik yatirim, projenizin kaliplarina uymayan yapay zeka kodunu duzeltmek icin harcanan saatleri kurtarir.”
Yuzlerce Claude Code projesinde gozlemlenmistir
CLAUDE.md'nizin yapisi ve ozgullugu, Claude'un kod tabaninizda ne kadar iyi performans gosterdigini dogrudan etkiler.
Iyi yapilandirilmis bir CLAUDE.md bu alti alaani kapsar. Her biri Claude'a hemen uygulayabilecegi somut bilgi verir.
Cercevelerinizi, kutuphanelerinizi ve surumlerini acikca listeleyin. Paket yoneticinizi, Node surumunuzu ve calisma zamani gereksinimlerini ekleyin. Claude tahmin etmeden uyumlu kod uretmek icin bunu kullanir.
Anahtar dizinlerinizi ve her birinde ne oldugunu tanimlayin. Bilesenler, storeler, servisler, API rotalari, tipler. Klasor basina tek satirlik aciklamali kisa bir agac diyagrami iyi calisir.
Adlandirma kaliplinizi (dosyalar icin camelCase, bilesenler icin PascalCase), hata yonetimi yaklaiminizi, import siralanizi ve projeye ozgu kurallarinizi belgeleyin. Bu, Claude'un ciktisini mevcut kodunuzla tutarli tutar.
Gelistirme, derleme, test ve lint komutlarinizi ekleyin. Claude bir seyin calistigini dogrulmasi veya betik onermesi gerektiginde projenizin beklentigi komutlari kullanir.
Birden fazla ajan kullaniyorsaniz (QA, frontend, backend, DevOps), her rolun neye odaklanmasi gerektigini tanimlayan bir bolum ekleyin. Bu ozellikle AgentsRoom'un coklu ajan yapilandimasinda kullanislidir.
Claude'a ne YAPMAMASI gerektigini soyeyin. Yapilandirma dosyalarini degistirme, kimlik dogrulama sistemini degistirme, veritabani katmanini yeniden yapilandirma. Acik sinirlar ajanlarin istenmeyen degisiklikler yapmasini onler.
Her seyi ayni anda yazmaniiz gerekmez. Temel bilgilerle baslayin ve Claude'un neyi bilmesi gerektigini kesfettikce genisletin.
package.json dosyanizi acin ve projenizin kullandigi her cerceve, kutuphane ve araci listeleyin. Surumleri not edin. Calisma zamani gereksinimlerinizi kontrol edin (Node surumu, Python surumu, veritabani). Bu, teknoloji yigini bolumunuz olur.
package.json + calisma zamani surumleri + veritabani
src dizininizin hizli bir agacini cikartin. Ust duzey klasorleri belirleyin ve her biri icin tek satirlik aciklama yazin. Bilesenlerin, storelarin, servislerin, tiplerin ve API rotalarinin nerede olduguna odaklanin.
Amac notlariyla src/ agaci
Mevcut kodunuza bakin ve kaliplari not edin: dosyalari nasil adlandiriyorsunuz, hatalari nasil yonetiyorsunuz, importlari nasil yapilandiriyorsunuz, varsayilan mi yoksa adlandirilmis mi export kullaniyorsunuz. Bunlari kisa kurallar olarak yazin.
Adlandirma, importlar, hata yonetimi, exportlar
Uzman ajanlarla calisiyorsaniz her rol icin odak alanlari ekleyin. Frontend ajani bilesen kutuphanenizi bilmeli. DevOps ajani dagitim boru hattinizi bilmeli. QA ajani test cercvenizi bilmeli.
Rol basina odak alanlari + kacinilacak alanlar
AgentsRoom, CLAUDE.md'yi sonradan eklenen bir dusunce degil birinci sinif kavram olarak ele alir.
CLAUDE.md'nizi sozdizimi vurgulama ve canli kaydetme ile dogrudan AgentsRoom icinde duzenleyin. Metin editorunuze veya IDE'nize gecis yapmaya gerek yok.
Her ajanin CLAUDE.md'nizi gercek zamanli nasil yorumladigini gorun. Ajanlarin kurallarinizi izledigini ve kacinilacak alanlariniza uyduunu dogrulamak icin terminal ciktisini izleyin.
AgentsRoom'daki her projenin kendi CLAUDE.md'si var. Projeler arasinda gecis yapin ve her ajan o kod tabani icin dogru baglam dosyasini otomatik yukler.
AgentsRoom'un 14 ajan rolu dogrudan CLAUDE.md bolumleriyle eslenir. Rol basina odak alanlari ve kacinilacak alanlar tanimlayin; her ajan kendisi icin tasarlanan talimatlari alir.
AgentsRoom'u indirin ve ajanlariniza ihtiyac duydugu baglami vermek icin yerlesik CLAUDE.md editorunu kullanin. Daha iyi talimatlar, daha iyi kod.
Yardimci uygulama: hareket halindeyken ajanlarinizi izleyin
Tum Claude planlariyla uyumlu (Free, Pro, Max, Team, Enterprise)