Yapay zeka destekli kodlama ara\u00e7lar\u0131 hayat\u0131m\u0131za h\u0131zla entegre olurken, bu ara\u00e7larla etkili ileti\u015fim kurmak ve onlardan en iyi verimi almak giderek daha \u00f6nemli hale geliyor. \u00d6zellikle karma\u015f\u0131k projelerde, yapay zeka ajanlar\u0131n\u0131n (agent) beklentilerimizi tam olarak anlamas\u0131 ve istenen \u00e7\u0131kt\u0131y\u0131 \u00fcretmesi i\u00e7in net, anla\u015f\u0131l\u0131r ve yap\u0131land\u0131r\u0131lm\u0131\u015f bir ileti\u015fim kanal\u0131 \u015fart. \u0130\u015fte tam da bu noktada “CLAUDE.md” devreye giriyor. CLAUDE.md, ad\u0131ndan da anla\u015f\u0131laca\u011f\u0131 gibi, \u00f6zellikle Claude gibi geli\u015fmi\u015f dil modelleriyle \u00e7al\u0131\u015f\u0131rken, ajan kodlama projeleri i\u00e7in bir standart haline gelebilecek pratik bir \u015fartname sunuyor. Peki, bu \u015fartname nedir, neden \u00f6nemlidir ve nas\u0131l kullan\u0131l\u0131r? Bu makalede, CLAUDE.md’nin temel prensiplerini, pratik uygulamalar\u0131n\u0131 ve bu yakla\u015f\u0131m\u0131n kodlama projelerinizde nas\u0131l bir devrim yaratabilece\u011fini ad\u0131m ad\u0131m inceleyece\u011fiz.<\/p>\n
G\u00fcn\u00fcm\u00fczde yaz\u0131l\u0131m geli\u015ftirme s\u00fcre\u00e7leri, tek bir geli\u015ftiricinin \u00f6tesine ge\u00e7erek ekip \u00e7al\u0131\u015fmas\u0131n\u0131 ve giderek artan bir \u015fekilde yapay zeka ara\u00e7lar\u0131n\u0131n entegrasyonunu gerektiriyor. Yapay zeka ajanlar\u0131, kod \u00fcretme, hata ay\u0131klama, dok\u00fcmantasyon yazma ve hatta proje planlamas\u0131 gibi pek \u00e7ok alanda bizlere yard\u0131mc\u0131 olabiliyor. Ancak bu potansiyeli tam olarak ortaya \u00e7\u0131karmak i\u00e7in, ajana ne istedi\u011fimizi net bir \u015fekilde anlatmam\u0131z gerekiyor. \u0130\u015fte CLAUDE.md, tam da bu ihtiyaca cevap veren bir dok\u00fcmantasyon format\u0131 olarak kar\u015f\u0131m\u0131za \u00e7\u0131k\u0131yor.<\/p>\n
CLAUDE.md, basit\u00e7e, yapay zeka ajanlar\u0131yla yap\u0131lacak kodlama projeleri i\u00e7in bir t\u00fcr “talimatname” veya “\u015fartname”dir. Bu format, projenin amac\u0131n\u0131, gereksinimlerini, kullan\u0131lacak teknolojileri, beklenen \u00e7\u0131kt\u0131lar\u0131 ve hatta ajan\u0131n izlemesi gereken ad\u0131mlar\u0131 net bir \u015fekilde tan\u0131mlar. Markdown format\u0131nda yaz\u0131lmas\u0131, hem insanlar taraf\u0131ndan okunabilirli\u011fini hem de makineler taraf\u0131ndan i\u015flenebilirli\u011fini kolayla\u015ft\u0131r\u0131r. Bu, bir projenin ba\u015flang\u0131c\u0131ndan sonuna kadar ajan\u0131n do\u011fru yolda ilerlemesini sa\u011flamak i\u00e7in kritik \u00f6neme sahiptir.<\/p>\n
Neden bu kadar \u00f6nemli? \u00d6ncelikle, yapay zeka ajanlar\u0131, sizin girdi\u011finiz metne dayanarak \u00e7al\u0131\u015f\u0131r. E\u011fer girdi belirsiz, eksik veya \u00e7eli\u015fkili ise, ajan\u0131n \u00fcretece\u011fi \u00e7\u0131kt\u0131 da ayn\u0131 \u015fekilde olacakt\u0131r. CLAUDE.md, bu belirsizlikleri ortadan kald\u0131rarak ajan\u0131n ne yapmas\u0131 gerekti\u011fini netle\u015ftirir. \u0130kinci olarak, karma\u015f\u0131k projelerde, ajan\u0131n izlemesi gereken ad\u0131mlar\u0131 ve \u00f6ncelikleri belirlemek, projenin verimlili\u011fini art\u0131r\u0131r. \u00dc\u00e7\u00fcnc\u00fc olarak, CLAUDE.md, projenin farkl\u0131 a\u015famalar\u0131ndaki ilerlemeyi takip etmek ve ajan\u0131n performans\u0131n\u0131 de\u011ferlendirmek i\u00e7in bir temel olu\u015fturur. Bu, \u00f6zellikle \u00e7evik (agile) geli\u015ftirme s\u00fcre\u00e7lerinde, ajan\u0131n geri bildirim d\u00f6ng\u00fcs\u00fcne dahil edilmesini ve s\u00fcrekli iyile\u015ftirilmesini sa\u011flar. Son olarak, bu standartla\u015ft\u0131r\u0131lm\u0131\u015f format, farkl\u0131 ajanlar aras\u0131nda veya ayn\u0131 ajan\u0131n farkl\u0131 s\u00fcr\u00fcmleriyle \u00e7al\u0131\u015f\u0131rken tutarl\u0131l\u0131\u011f\u0131 korumaya yard\u0131mc\u0131 olur.<\/p>\n
Yapay zeka ajanlar\u0131 ile \u00e7al\u0131\u015f\u0131rken kar\u015f\u0131la\u015f\u0131lan en b\u00fcy\u00fck zorluklardan biri, “prompt engineering” (komut m\u00fchendisli\u011fi) olarak da bilinen, ajana do\u011fru komutlar\u0131 verme sanat\u0131d\u0131r. Geli\u015fmi\u015f dil modelleri bile, ne istedi\u011fimizi tam olarak anlamad\u0131klar\u0131nda, beklentilerin d\u0131\u015f\u0131nda sonu\u00e7lar \u00fcretebilirler. Bu durum, \u00f6zellikle yaz\u0131l\u0131m geli\u015ftirme gibi detay ve hassasiyet gerektiren alanlarda ciddi zaman kayb\u0131na ve hayal k\u0131r\u0131kl\u0131\u011f\u0131na yol a\u00e7abilir.<\/p>\n
\u00d6rne\u011fin, bir geli\u015ftirici bir “kullan\u0131c\u0131 giri\u015f formu” olu\u015fturmak isteyebilir. Ancak “kullan\u0131c\u0131 giri\u015f formu” ifadesi olduk\u00e7a geneldir. Hangi alanlar olacak? Hangi do\u011frulama kurallar\u0131 uygulanacak? Hangi stil \u015femas\u0131 kullan\u0131lacak? Bu gibi sorular\u0131n yan\u0131tlanmamas\u0131, ajan\u0131n rastgele bir form \u00fcretmesine neden olabilir. CLAUDE.md, bu t\u00fcr belirsizlikleri ortadan kald\u0131rarak, geli\u015ftiricinin ne istedi\u011fini detayl\u0131 bir \u015fekilde ifade etmesini sa\u011flar. Bu, ajan\u0131n daha odakl\u0131 ve do\u011fru \u00e7\u0131kt\u0131lar \u00fcretmesine yard\u0131mc\u0131 olur, b\u00f6ylece geli\u015ftiricinin zaman\u0131n\u0131 tekrar eden d\u00fczeltmelerle harcamas\u0131n\u0131 engeller.<\/p>\n
CLAUDE.md format\u0131, bir projenin t\u00fcm \u00f6nemli y\u00f6nlerini kapsayan belirli b\u00f6l\u00fcmlerden olu\u015fur. Bu b\u00f6l\u00fcmler, ajan\u0131n projeyi anlamas\u0131 ve ba\u015far\u0131yla tamamlamas\u0131 i\u00e7in gerekli t\u00fcm bilgileri sa\u011flar. Bu bile\u015fenleri anlamak, etkili bir CLAUDE.md dosyas\u0131 olu\u015fturman\u0131n ilk ad\u0131m\u0131d\u0131r.<\/p>\n
* Proje Tan\u0131m\u0131 (Project Description):<\/strong> Bu b\u00f6l\u00fcm, projenin genel amac\u0131n\u0131 ve kapsam\u0131n\u0131 \u00f6zetler. Neden bu proje yap\u0131l\u0131yor? Hangi problemi \u00e7\u00f6z\u00fcyor? Hedef kitle kim? Bu sorular\u0131n k\u0131sa ve net yan\u0131tlar\u0131 burada yer al\u0131r. Bu bile\u015fenlerin her biri, CLAUDE.md’nin etkinli\u011fini art\u0131ran kritik unsurlard\u0131r.<\/p>\n Etkili bir CLAUDE.md dosyas\u0131 olu\u015fturmak, sadece bilgileri listelemekten daha fazlas\u0131n\u0131 gerektirir. Bu, ajan\u0131n sizin bak\u0131\u015f a\u00e7\u0131n\u0131z\u0131 anlamas\u0131n\u0131 ve projenin ruhunu yakalamas\u0131n\u0131 sa\u011flamakla ilgilidir. \u0130\u015fte bu s\u00fcreci kolayla\u015ft\u0131racak baz\u0131 pratik ad\u0131mlar ve ipu\u00e7lar\u0131:<\/p>\n Herhangi bir kodlama projesinin kalbinde bir “neden” yatar. Bu neden, projenin amac\u0131n\u0131, \u00e7\u00f6zd\u00fc\u011f\u00fc problemi ve hedeflenen fayday\u0131 a\u00e7\u0131klar. CLAUDE.md’nin ilk b\u00f6l\u00fcm\u00fc olan “Proje Tan\u0131m\u0131”nda bu “neden”i net bir \u015fekilde ifade etmek, ajan\u0131n projeye do\u011fru motivasyonla ba\u015flamas\u0131n\u0131 sa\u011flar.<\/p>\n \u00d6rne\u011fin, “Bir e-ticaret sitesi i\u00e7in sepet \u00f6zelli\u011fi geli\u015ftirme” yerine, “M\u00fc\u015fterilerin \u00fcr\u00fcnleri sepete ekleyip \u00e7\u0131karabilmesini, sepetin g\u00fcncellenmesini ve \u00f6deme ad\u0131m\u0131na ge\u00e7i\u015fi sa\u011flayarak sat\u0131\u015f d\u00f6n\u00fc\u015f\u00fcm oranlar\u0131n\u0131 %15 art\u0131rmay\u0131 hedefleyen bir sepet \u00f6zelli\u011fi geli\u015ftirme” gibi daha a\u00e7\u0131klay\u0131c\u0131 bir tan\u0131m, ajan\u0131n i\u015flevselli\u011fin \u00f6tesinde i\u015f hedefini de anlamas\u0131na yard\u0131mc\u0131 olur. Bu, ajan\u0131n sadece kod yazmakla kalmay\u0131p, projenin ticari hedeflerine de hizmet eden \u00e7\u00f6z\u00fcmler \u00fcretmesini te\u015fvik eder.<\/p>\n “Gereksinimler” b\u00f6l\u00fcm\u00fc, CLAUDE.md’nin en kritik k\u0131s\u0131mlar\u0131ndan biridir. Burada, projenin ne yapmas\u0131 gerekti\u011fini a\u00e7\u0131k\u00e7a belirtmelisiniz. Ancak bu, sadece bir liste olu\u015fturmakla kalmamal\u0131, ayn\u0131 zamanda gereksinimlerin somut ve m\u00fcmk\u00fcnse \u00f6l\u00e7\u00fclebilir olmas\u0131 gerekir.<\/p>\n * Fonksiyonel Gereksinimler:<\/strong> Kullan\u0131c\u0131n\u0131n sistemle nas\u0131l etkile\u015fim kuraca\u011f\u0131n\u0131 tan\u0131mlar. \u00d6rne\u011fin, “Kullan\u0131c\u0131lar, \u00fcr\u00fcnleri sepete ekleyebilmelidir.” Bu t\u00fcr detaylar, ajan\u0131n ne t\u00fcr bir \u00e7\u00f6z\u00fcm \u00fcretece\u011fi konusunda net bir fikre sahip olmas\u0131n\u0131 sa\u011flar. E\u011fer bir web uygulamas\u0131 geli\u015ftiriyorsan\u0131z, “responsive tasar\u0131m” gibi ifadeler yerine, “Uygulama, mobil, tablet ve masa\u00fcst\u00fc ekran boyutlar\u0131nda sorunsuz g\u00f6r\u00fcnt\u00fclenmeli ve kullan\u0131labilir olmal\u0131d\u0131r.” gibi daha spesifik ifadeler kullanmak daha faydal\u0131d\u0131r.<\/p>\n Hangi teknolojilerin kullan\u0131laca\u011f\u0131n\u0131 belirlemek, ajan\u0131n size uygun ara\u00e7lar\u0131 se\u00e7mesini sa\u011flar. Bu b\u00f6l\u00fcm, sadece dil ve framework’leri listelemekle kalmamal\u0131, ayn\u0131 zamanda bu teknolojilerin nas\u0131l birlikte \u00e7al\u0131\u015faca\u011f\u0131na dair ipu\u00e7lar\u0131 da i\u00e7ermelidir.<\/p>\n \u00d6rne\u011fin, e\u011fer bir mobil uygulama geli\u015ftiriyorsan\u0131z, “React Native kullan\u0131larak iOS ve Android platformlar\u0131 i\u00e7in tek kod taban\u0131 ile uygulama geli\u015ftirilecek.” gibi bir ifade, ajan\u0131n platformlar aras\u0131 uyumlulu\u011fu g\u00f6z \u00f6n\u00fcnde bulundurmas\u0131n\u0131 sa\u011flar. Ayr\u0131ca, kullan\u0131lacak belirli k\u00fct\u00fcphaneler veya API’ler (Application Programming Interface – Uygulama Programlama Aray\u00fcz\u00fc) de bu b\u00f6l\u00fcmde belirtilebilir. Bu, ajan\u0131n standart d\u0131\u015f\u0131 veya uyumsuz teknolojiler kullanmas\u0131n\u0131 engeller.<\/p>\n Projenin sonunda ne elde etmek istedi\u011finizi net bir \u015fekilde tan\u0131mlamak, ajan\u0131n hedefe odaklanmas\u0131n\u0131 sa\u011flar. Bu, sadece “\u00e7al\u0131\u015fan bir kod” demekten \u00e7ok daha fazlas\u0131d\u0131r.<\/p>\n * Kod Kalitesi:<\/strong> “Temiz, okunabilir ve iyi belgelenmi\u015f kod” gibi ifadeler, ajan\u0131n kodun kalitesine de dikkat etmesini sa\u011flar. Bu, ajan\u0131n sadece i\u015flevsel de\u011fil, ayn\u0131 zamanda s\u00fcrd\u00fcr\u00fclebilir ve test edilebilir kod \u00fcretmesini sa\u011flar.<\/p>\n CLAUDE.md’nin g\u00fcc\u00fcn\u00fc en iyi \u015fekilde anlamak i\u00e7in, ger\u00e7ek d\u00fcnya senaryolar\u0131ndan \u00f6rnekler incelemek faydal\u0131 olacakt\u0131r.<\/p>\n Diyelim ki, yapay zeka ajan\u0131 ile basit bir blog sitesi olu\u015fturmak istiyorsunuz.<\/p>\n CLAUDE.md Dosya \u0130\u00e7eri\u011fi (\u00d6zet):<\/strong><\/p>\n <\/code><\/p>\n Bu CLAUDE.md dosyas\u0131, ajana projenin ne oldu\u011funu, hangi \u00f6zellikleri i\u00e7ermesi gerekti\u011fini, hangi teknolojileri kullanmas\u0131 gerekti\u011fini ve sonunda ne elde etmemiz gerekti\u011fini net bir \u015fekilde anlat\u0131r. Bu, ajan\u0131n gereksiz yere karma\u015f\u0131k \u00e7\u00f6z\u00fcmler \u00fcretmesini veya yanl\u0131\u015f teknolojiler se\u00e7mesini engeller.<\/p>\n Daha karma\u015f\u0131k bir senaryoda, bir \u00fc\u00e7\u00fcnc\u00fc taraf API'sinden veri \u00e7ekip i\u015fleyen bir uygulama geli\u015ftirmek isteyebilirsiniz.<\/p>\n CLAUDE.md Dosya \u0130\u00e7eri\u011fi (\u00d6zet):<\/strong><\/p>\n <\/code><\/p>\n Bu vaka analizleri, CLAUDE.md'nin farkl\u0131 karma\u015f\u0131kl\u0131ktaki projeler i\u00e7in nas\u0131l uyarlanabilece\u011fini g\u00f6stermektedir. \u00d6nemli olan, ajan\u0131n ihtiya\u00e7 duydu\u011fu t\u00fcm bilgileri net ve yap\u0131land\u0131r\u0131lm\u0131\u015f bir \u015fekilde sunmakt\u0131r.<\/p>\n CLAUDE.md'yi sadece bir talimat listesi olman\u0131n \u00f6tesine ta\u015f\u0131yarak, yapay zeka ajanlar\u0131yla daha derin ve etkili bir i\u015fbirli\u011fi kurmak m\u00fcmk\u00fcnd\u00fcr. \u0130\u015fte deneyimli kullan\u0131c\u0131lar i\u00e7in baz\u0131 ileri d\u00fczey ipu\u00e7lar\u0131:<\/p>\n CLAUDE.md, tek seferlik bir dok\u00fcman olmaktan ziyade, projenin ya\u015fam d\u00f6ng\u00fcs\u00fc boyunca g\u00fcncellenebilen dinamik bir belge olarak d\u00fc\u015f\u00fcn\u00fclmelidir. Yapay zeka ajan\u0131yla \u00e7al\u0131\u015f\u0131rken, ilk \u00e7\u0131kt\u0131y\u0131 ald\u0131ktan sonra CLAUDE.md dosyas\u0131n\u0131 g\u00f6zden ge\u00e7irin ve ajan\u0131n performans\u0131na g\u00f6re g\u00fcncellemeler yap\u0131n.<\/p>\n * \u00d6rnek:<\/strong> E\u011fer ajan, beklenenden daha basit bir kullan\u0131c\u0131 aray\u00fcz\u00fc \u00fcrettiyse, CLAUDE.md'nin \"Aray\u00fcz\" gereksinimlerini daha detayl\u0131 hale getirebilirsiniz. \u00d6rne\u011fin, \"Kullan\u0131c\u0131 aray\u00fcz\u00fc, modern bir tasar\u0131m anlay\u0131\u015f\u0131na sahip olmal\u0131, renk paleti a\u00e7\u0131k ve canl\u0131 olmal\u0131.\" gibi ifadeler ekleyebilirsiniz. Bu iteratif yakla\u015f\u0131m, ajan\u0131n zamanla projenizin gereksinimlerini daha iyi anlamas\u0131n\u0131 ve daha do\u011fru \u00e7\u0131kt\u0131lar \u00fcretmesini sa\u011flar.<\/p>\n CLAUDE.md'de, ajan\u0131n hangi rolleri \u00fcstlenece\u011fini ve hangi yeteneklere sahip oldu\u011funu belirtebilirsiniz. Bu, ajan\u0131n projedeki yerini ve sorumluluklar\u0131n\u0131 netle\u015ftirir.<\/p>\n * \u00d6rnek:<\/strong> \"Sen bir backend geli\u015ftiricisi olarak hareket etmelisin ve RESTful API'leri tasarlamaktan sorumlu olmal\u0131s\u0131n.\" veya \"Sen bir frontend geli\u015ftiricisi olarak, kullan\u0131c\u0131 deneyimini optimize etmeli ve duyarl\u0131 tasar\u0131mlar olu\u015fturmal\u0131s\u0131n.\" Bu, ajan\u0131n yeteneklerini do\u011fru \u015fekilde y\u00f6nlendirmenize ve potansiyel sorunlar\u0131 \u00f6nceden belirlemenize yard\u0131mc\u0131 olur.<\/p>\n E\u011fer projenizde karma\u015f\u0131k bir mant\u0131k veya \u00f6zel bir algoritma kullanman\u0131z gerekiyorsa, bunu CLAUDE.md'de a\u00e7\u0131k\u00e7a a\u00e7\u0131klamak \u00f6nemlidir. Sadece algoritman\u0131n ad\u0131n\u0131 vermek yerine, nas\u0131l \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 ve neden kullan\u0131ld\u0131\u011f\u0131n\u0131 da belirtebilirsiniz.<\/p>\n * \u00d6rnek:<\/strong> \"Veri s\u0131ralamas\u0131 i\u00e7in QuickSort algoritmas\u0131 kullan\u0131lacakt\u0131r. Bu algoritma, b\u00fcy\u00fck veri setlerinde y\u00fcksek performans g\u00f6stermesi nedeniyle tercih edilmi\u015ftir. Algoritman\u0131n temel ad\u0131mlar\u0131 \u015funlard\u0131r: [Ad\u0131mlar\u0131n k\u0131sa a\u00e7\u0131klamas\u0131].\" Bu, ajan\u0131n karma\u015f\u0131k problemleri do\u011fru bir \u015fekilde \u00e7\u00f6zmesini ve sizin beklentilerinizi kar\u015f\u0131lamas\u0131n\u0131 sa\u011flar.<\/p>\n Projede ka\u00e7\u0131n\u0131lmas\u0131 gereken belirli \"anti-patterns\" (anti-desenler) veya yayg\u0131n hatalar varsa, bunlar\u0131 da CLAUDE.md'de belirtebilirsiniz. Bu, ajan\u0131n benzer hatalar\u0131 yapmas\u0131n\u0131 \u00f6nler.<\/p>\n * \u00d6rnek:<\/strong> \"Global de\u011fi\u015fkenlerin a\u015f\u0131r\u0131 kullan\u0131m\u0131ndan ka\u00e7\u0131n\u0131lmal\u0131d\u0131r.\" veya \"Asenkron i\u015flemler y\u00f6netilirken, race condition (yar\u0131\u015f durumu) senaryolar\u0131na dikkat edilmelidir.\" Bu, ajan\u0131n daha sa\u011flam ve g\u00fcvenli kodlar \u00fcretmesine yard\u0131mc\u0131 olur.<\/p>\n CLAUDE.md, yapay zeka ajanlar\u0131yla yap\u0131lan kodlama projelerinde ileti\u015fimi standardize etmek ve verimlili\u011fi art\u0131rmak i\u00e7in g\u00fc\u00e7l\u00fc bir ara\u00e7t\u0131r. Bu pratik \u015fartname format\u0131, ajan\u0131n beklentilerinizi tam olarak anlamas\u0131n\u0131 sa\u011flayarak, daha do\u011fru, g\u00fcvenilir ve hedefe y\u00f6nelik \u00e7\u0131kt\u0131lar \u00fcretmesine olanak tan\u0131r. Proje tan\u0131m\u0131ndan gereksinimlere, teknolojilerden beklenen \u00e7\u0131kt\u0131lara kadar her ad\u0131m\u0131 net bir \u015fekilde belirleyerek, yapay zeka ile \u00e7al\u0131\u015f\u0131rken kar\u015f\u0131la\u015f\u0131lan belirsizlikleri ortadan kald\u0131rabilir ve geli\u015ftirme s\u00fcrecini h\u0131zland\u0131rabilirsiniz.<\/p>\n Ger\u00e7ek d\u00fcnya senaryolar\u0131 ve vaka analizleri, CLAUDE.md'nin farkl\u0131 projelerde nas\u0131l uygulanabilece\u011fini g\u00f6stermektedir. \u0130leri d\u00fczey ipu\u00e7lar\u0131 ve p\u00fcf noktalar\u0131 ise, bu format\u0131 kullanarak yapay zeka ajanlar\u0131yla daha derin ve etkili bir i\u015fbirli\u011fi kurman\u0131n yollar\u0131n\u0131 sunmaktad\u0131r. CLAUDE.md, sadece bir dok\u00fcmantasyon bi\u00e7imi de\u011fil, ayn\u0131 zamanda yapay zeka destekli kodlama projelerinde ba\u015far\u0131y\u0131 garantileyen bir stratejidir. Bu standart\u0131 benimseyerek, gelece\u011fin kodlama projelerinde daha verimli, daha h\u0131zl\u0131 ve daha kaliteli sonu\u00e7lar elde edebilirsiniz.<\/p>\n * CLAUDE.md yaln\u0131zca Claude modeli i\u00e7in mi ge\u00e7erlidir?<\/strong> #YapayZeka #Kodlama #Yaz\u0131l\u0131mGeli\u015ftirme #CLAUDEmd #AgenticAI<\/p>\n","protected":false},"excerpt":{"rendered":"CLAUDE.","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[1],"tags":[],"class_list":{"0":"post-41646","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-genel","7":"cs-entry","8":"cs-video-wrap"},"yoast_head":"\n
\n* Gereksinimler (Requirements):<\/strong> Projenin teknik ve fonksiyonel gereksinimlerini detayland\u0131r\u0131r. Hangi \u00f6zellikler bulunmal\u0131? Hangi kullan\u0131c\u0131 senaryolar\u0131 desteklenmeli? Performans beklentileri nelerdir? Bu b\u00f6l\u00fcm, projenin temel ta\u015flar\u0131n\u0131 olu\u015fturur.
\n* Teknolojiler (Technologies):<\/strong> Projede kullan\u0131lacak programlama dilleri, k\u00fct\u00fcphaneler (libraries), framework’ler (yaz\u0131l\u0131m \u00e7er\u00e7eveleri) ve di\u011fer ara\u00e7lar burada listelenir. \u00d6rne\u011fin, “React ile bir \u00f6n y\u00fcz (frontend) geli\u015ftirilecek, Node.js ile bir arka y\u00fcz (backend) olu\u015fturulacak ve PostgreSQL veritaban\u0131 kullan\u0131lacak.” gibi bilgiler bu b\u00f6l\u00fcmde yer al\u0131r.
\n* Beklenen \u00c7\u0131kt\u0131lar (Expected Outputs):<\/strong> Proje tamamland\u0131\u011f\u0131nda ne t\u00fcr \u00e7\u0131kt\u0131lar\u0131n beklendi\u011fini tan\u0131mlar. Bu, tamamlanm\u0131\u015f bir kod deposu (code repository), belirli bir i\u015flevselli\u011fe sahip bir web uygulamas\u0131, bir API dok\u00fcmantasyonu veya bir test raporu olabilir. \u00c7\u0131kt\u0131lar\u0131n format\u0131 ve teslimat \u015fekli de burada belirtilebilir.
\n* K\u0131s\u0131tlamalar ve Kurallar (Constraints and Rules):<\/strong> Projeyle ilgili uyulmas\u0131 gereken \u00f6zel kurallar veya k\u0131s\u0131tlamalar burada belirtilir. Bu, g\u00fcvenlik standartlar\u0131, kodlama stil rehberleri, performans limitleri veya belirli algoritmalar\u0131n kullan\u0131m\u0131na ili\u015fkin k\u0131s\u0131tlamalar olabilir.
\n* Ad\u0131m Ad\u0131m Plan (Step-by-Step Plan – \u0130ste\u011fe Ba\u011fl\u0131):<\/strong> \u00d6zellikle karma\u015f\u0131k projelerde, ajan\u0131n takip etmesi gereken ad\u0131mlar\u0131n bir listesi sunulabilir. Bu, projenin daha y\u00f6netilebilir par\u00e7alara ayr\u0131lmas\u0131na ve ajan\u0131n odaklanmas\u0131na yard\u0131mc\u0131 olur.
\n* \u00d6rnekler ve Vaka Analizleri (Examples and Case Studies):<\/strong> \u0130stenen \u00e7\u0131kt\u0131n\u0131n neye benzeyece\u011fine dair somut \u00f6rnekler veya benzer projelerin vaka analizleri, ajan\u0131n beklentileri daha iyi anlamas\u0131na yard\u0131mc\u0131 olur.<\/p>\nEtkili Bir CLAUDE.md Dosyas\u0131 Nas\u0131l Olu\u015fturulur?<\/h3>\n
1. Amac\u0131 Netle\u015ftirin: Projenin “Neden”ini Tan\u0131mlay\u0131n<\/h4>\n
2. Gereksinimleri Detayland\u0131r\u0131n: Somut ve \u00d6l\u00e7\u00fclebilir Olun<\/h4>\n
\n* Teknik Gereksinimler:<\/strong> Sistemin nas\u0131l \u00e7al\u0131\u015fmas\u0131 gerekti\u011fini tan\u0131mlar. \u00d6rne\u011fin, “Sepete ekleme i\u015flemi, 2 saniyenin alt\u0131nda tamamlanmal\u0131d\u0131r.” veya “Kullan\u0131lan veritaban\u0131, en az 10.000 e\u015f zamanl\u0131 kullan\u0131c\u0131y\u0131 destekleyebilmelidir.”<\/p>\n3. Teknolojileri Belirleyin: Uyumlu Bir Ekosistem Olu\u015fturun<\/h4>\n
4. Beklenen \u00c7\u0131kt\u0131lar\u0131 Tan\u0131mlay\u0131n: Son Noktay\u0131 G\u00f6sterin<\/h4>\n
\n* Teslimat Format\u0131:<\/strong> Kodun hangi formatta teslim edilece\u011fi (\u00f6rne\u011fin, bir Git deposu linki, s\u0131k\u0131\u015ft\u0131r\u0131lm\u0131\u015f bir dosya) belirtilmelidir.
\n* Testler:<\/strong> “T\u00fcm fonksiyonlar i\u00e7in birim testleri (unit tests) yaz\u0131lmal\u0131 ve testlerin %90’\u0131 ba\u015far\u0131yla ge\u00e7melidir.” gibi ifadeler, ajan\u0131n kodun do\u011frulu\u011funu da garanti alt\u0131na almas\u0131n\u0131 te\u015fvik eder.<\/p>\nGer\u00e7ek D\u00fcnya Senaryolar\u0131 ve Vaka Analizleri<\/h3>\n
Vaka Analizi 1: Basit Bir Blog Olu\u015fturma<\/h4>\n
## Proje Ad\u0131: Basit Blog Platformu\n\n### Proje Tan\u0131m\u0131\nKullan\u0131c\u0131lar\u0131n yaz\u0131 yaz\u0131p yay\u0131nlayabilece\u011fi, di\u011fer yaz\u0131lar\u0131n okunabilece\u011fi temel bir blog platformu olu\u015fturmak.\n\n### Gereksinimler\n- Kullan\u0131c\u0131lar:<\/strong>\n - Giri\u015f yapmadan yaz\u0131 okuyabilirler.\n - Yaz\u0131 ba\u015fl\u0131\u011f\u0131, i\u00e7eri\u011fi ve yay\u0131nlanma tarihi g\u00f6sterilmelidir.\n- Y\u00f6netici (Admin):<\/strong>\n - Yeni yaz\u0131 olu\u015fturabilmeli (ba\u015fl\u0131k, i\u00e7erik).\n - Mevcut yaz\u0131lar\u0131 d\u00fczenleyebilmeli.\n - Yaz\u0131lar\u0131 silebilmeli.\n - Yaz\u0131lar\u0131 yay\u0131nlayabilmeli\/taslak olarak kaydedebilmeli.\n- Teknik:<\/strong>\n - H\u0131zl\u0131 y\u00fckleme s\u00fcreleri.\n - Basit ve kullan\u0131c\u0131 dostu aray\u00fcz.\n\n### Teknolojiler\n- Frontend:<\/strong> React (Create React App ile)\n- Backend:<\/strong> Node.js (Express.js framework'\u00fc ile)\n- Veritaban\u0131:<\/strong> SQLite (basitlik ve kurulum kolayl\u0131\u011f\u0131 i\u00e7in)\n- Stil:<\/strong> Tailwind CSS (h\u0131zl\u0131 stil olu\u015fturma i\u00e7in)\n\n### Beklenen \u00c7\u0131kt\u0131lar\n- Tamamen i\u015flevsel bir blog web uygulamas\u0131.\n- T\u00fcm kodlar\u0131n bir Git deposunda (GitHub) payla\u015f\u0131lmas\u0131.\n- Temel CRUD (Create, Read, Update, Delete - Olu\u015ftur, Oku, G\u00fcncelle, Sil) i\u015flemleri i\u00e7in API endpoint'leri.\n- Basit bir README.md dosyas\u0131.\n\n### K\u0131s\u0131tlamalar\n- G\u00fcvenlik \u00f6nlemleri: Admin paneline eri\u015fim i\u00e7in basit bir parola korumas\u0131.\n- Kodlama stili: Airbnb JavaScript Style Guide'a uyulmal\u0131.<\/pre>\nVaka Analizi 2: API Entegrasyonu ve Veri \u0130\u015fleme<\/h4>\n
## Proje Ad\u0131: Hava Durumu Veri \u00c7ekici ve Analiz Arac\u0131\n\n### Proje Tan\u0131m\u0131\nBelirli bir \u015fehir i\u00e7in OpenWeatherMap API'sinden g\u00fcnl\u00fck ve saatlik hava durumu verilerini \u00e7ekerek, bu verileri i\u015fleyip kullan\u0131c\u0131lara basit bir aray\u00fczde sunan bir web uygulamas\u0131 geli\u015ftirmek.\n\n### Gereksinimler\n- API Entegrasyonu:<\/strong>\n - OpenWeatherMap API'sine (https:\/\/openweathermap.org\/api) ge\u00e7erli bir API anahtar\u0131 ile ba\u011flan\u0131lmal\u0131.\n - Belirli bir \u015fehir (\u00f6rne\u011fin, Ankara) i\u00e7in mevcut hava durumu verileri \u00e7ekilmeli.\n - \u00d6n\u00fcm\u00fczdeki 5 g\u00fcn i\u00e7in tahmin edilen hava durumu verileri \u00e7ekilmeli.\n- Veri \u0130\u015fleme:<\/strong>\n - \u00c7ekilen verilerdeki s\u0131cakl\u0131k, nem, r\u00fczgar h\u0131z\u0131 gibi temel bilgiler ayr\u0131\u015ft\u0131r\u0131lmal\u0131.\n - S\u0131cakl\u0131klar Celsius cinsinden g\u00f6sterilmeli.\n - Veriler, kullan\u0131c\u0131 dostu bir formatta i\u015flenmeli (\u00f6rne\u011fin, \"Bug\u00fcn Ankara'da hava par\u00e7al\u0131 bulutlu, s\u0131cakl\u0131k 25\u00b0C\").\n- Aray\u00fcz:<\/strong>\n - \u015eehir ad\u0131 girilebilen bir metin kutusu.\n - Hava durumu bilgilerini g\u00f6steren bir sonu\u00e7 alan\u0131.\n - Hata mesajlar\u0131 (API anahtar\u0131 ge\u00e7ersizse, \u015fehir bulunamazsa vb.) anla\u015f\u0131l\u0131r bir \u015fekilde g\u00f6sterilmeli.\n\n### Teknolojiler\n- Frontend:<\/strong> Vue.js\n- Backend:<\/strong> Python (Flask framework'\u00fc ile)\n- API \u0130stemci K\u00fct\u00fcphanesi:<\/strong> requests<\/code> (Python)\n- Veri Format\u0131:<\/strong> JSON\n\n### Beklenen \u00c7\u0131kt\u0131lar\n- Tamamen i\u015flevsel bir web uygulamas\u0131.\n- Python kodlar\u0131 ve Vue.js bile\u015fenleri ayr\u0131 ayr\u0131 sunulmal\u0131.\n- API anahtar\u0131n\u0131n g\u00fcvenli bir \u015fekilde y\u00f6netilmesi (\u00f6rne\u011fin, ortam de\u011fi\u015fkenleri - environment variables - arac\u0131l\u0131\u011f\u0131yla).\n- \u00d6rnek API anahtar\u0131 ile birlikte \u00e7al\u0131\u015ft\u0131r\u0131labilir bir proje.\n- Kodlar i\u00e7in temel dok\u00fcmantasyon.\n\n### K\u0131s\u0131tlamalar ve Kurallar\n- API kullan\u0131m limitlerine dikkat edilmeli.\n- Hassas bilgiler (API anahtar\u0131 gibi) kod i\u00e7ine g\u00f6m\u00fclmemeli.\n- Kullan\u0131c\u0131 aray\u00fcz\u00fc mobil cihazlarda da d\u00fczg\u00fcn \u00e7al\u0131\u015fmal\u0131 (responsive).<\/pre>\n\u0130leri D\u00fczey \u0130pu\u00e7lar\u0131 ve P\u00fcf Noktalar\u0131<\/h3>\n
1. Iteratif Geli\u015ftirme ve Geri Bildirim D\u00f6ng\u00fcleri<\/h4>\n
\n* Geri Bildirim:<\/strong> Ajan\u0131n \u00fcretti\u011fi kod veya \u00e7\u0131kt\u0131 hakk\u0131nda spesifik geri bildirimler vermek, ajan\u0131n \u00f6\u011frenme s\u00fcrecini h\u0131zland\u0131r\u0131r. Bu geri bildirimleri, CLAUDE.md'ye eklenen \"Geri Bildirimler\" veya \"\u0130yile\u015ftirme \u00d6nerileri\" gibi b\u00f6l\u00fcmlerle belgeleyebilirsiniz.<\/p>\n2. Ajan\u0131n Rol\u00fcn\u00fc ve Yeteneklerini Belirleme<\/h4>\n
\n* Kapasite Belirleme:<\/strong> E\u011fer ajan\u0131n belirli bir konuda daha az deneyimli oldu\u011funu d\u00fc\u015f\u00fcn\u00fcyorsan\u0131z, bu durumu belirtebilir ve bu alanda daha fazla y\u00f6nlendirme sa\u011flayabilirsiniz. \u00d6rne\u011fin, \"G\u00fcvenlik konusunda daha dikkatli olmal\u0131s\u0131n ve olas\u0131 zafiyetlere kar\u015f\u0131 \u00f6nlemler almal\u0131s\u0131n.\"<\/p>\n3. Karma\u015f\u0131k Mant\u0131k ve Algoritmalar\u0131 A\u00e7\u0131klama<\/h4>\n
\n* Pseudocode (S\u00f6zde Kod):<\/strong> Gerekirse, karma\u015f\u0131k mant\u0131\u011f\u0131 a\u00e7\u0131klamak i\u00e7in pseudocode kullanabilirsiniz. Bu, ajan\u0131n ger\u00e7ek kodlama diline ge\u00e7meden \u00f6nce mant\u0131\u011f\u0131 anlamas\u0131na yard\u0131mc\u0131 olur.<\/p>\n4. \"Anti-Patterns\" ve Ka\u00e7\u0131n\u0131lmas\u0131 Gereken Durumlar<\/h4>\n
\n* G\u00fcvenlik A\u00e7\u0131klar\u0131:<\/strong> \"SQL injection (SQL enjeksiyonu) gibi yayg\u0131n g\u00fcvenlik a\u00e7\u0131klar\u0131na kar\u015f\u0131 \u00f6nlemler al\u0131nmal\u0131d\u0131r.\"<\/p>\nSonu\u00e7: CLAUDE.md ile Yapay Zeka Destekli Kodlamada Yeni Bir D\u00f6nem<\/h3>\n
S\u0131k\u00e7a Sorulan Sorular (SSS)<\/h3>\n
\n Hay\u0131r, CLAUDE.md format\u0131 genel bir standart olarak tasarlanm\u0131\u015ft\u0131r ve Claude gibi geli\u015fmi\u015f dil modelleri ba\u015fta olmak \u00fczere, \u00e7e\u015fitli yapay zeka ajanlar\u0131 ve kodlama ara\u00e7lar\u0131yla kullan\u0131labilir. \u00d6nemli olan, ajana net ve yap\u0131land\u0131r\u0131lm\u0131\u015f bilgi sunmakt\u0131r.
\n* CLAUDE.md dosyas\u0131 ne kadar detayl\u0131 olmal\u0131d\u0131r?<\/strong>
\n Dosyan\u0131n detay seviyesi projenin karma\u015f\u0131kl\u0131\u011f\u0131na ba\u011fl\u0131d\u0131r. Basit projeler i\u00e7in daha k\u0131sa ve \u00f6z bir dosya yeterli olabilirken, karma\u015f\u0131k projeler i\u00e7in daha fazla ayr\u0131nt\u0131 ve a\u00e7\u0131klama gerekebilir. Ama\u00e7, ajan\u0131n projeyi tam olarak anlamas\u0131 i\u00e7in yeterli bilgiyi sa\u011flamakt\u0131r.
\n* CLAUDE.md dosyas\u0131n\u0131 g\u00fcncel tutmak \u00f6nemli midir?<\/strong>
\n Evet, \u00f6zellikle iteratif geli\u015ftirme s\u00fcre\u00e7lerinde CLAUDE.md dosyas\u0131n\u0131 g\u00fcncel tutmak \u00e7ok \u00f6nemlidir. Proje ilerledik\u00e7e veya gereksinimler de\u011fi\u015ftik\u00e7e, bu dosyay\u0131 da buna g\u00f6re g\u00fcncellemek, ajan\u0131n her zaman en g\u00fcncel bilgilere sahip olmas\u0131n\u0131 sa\u011flar.
\n* CLAUDE.md dosyas\u0131n\u0131 olu\u015ftururken hangi format kullan\u0131lmal\u0131d\u0131r?<\/strong>
\n CLAUDE.md, ad\u0131ndan da anla\u015f\u0131laca\u011f\u0131 gibi Markdown format\u0131nda yaz\u0131lmal\u0131d\u0131r. Markdown, hem insanlar taraf\u0131ndan kolayca okunabilir hem de makineler taraf\u0131ndan i\u015flenebilir bir formatt\u0131r.<\/p>\n