Claude Code’u daha iyi kullanma konusunda kendi yöntemimi paylaşmak istiyorum.

Sorun

Vibe coding ile bir projeye başladığınızda ilk birkaç saat bambaşka bir dünya gibi geliyor. Prompt’u atıyorsunuz, kod çıkıyor, bir şeyler çalışıyor gibi duruyor ve “Ben bunu gerçekten yapıyor muyum?” dediğiniz an geliyor.

Sonra hatalar çıkmaya başlıyor.

Düzeltmesini istediğinizde başka bir yer bozuluyor, 30 dakika geçince yapay zeka az önce söylediklerini unutuyor, 1 saat geçince siz de şu an ne yaptığınızı karıştırmaya başlıyorsunuz. Ertesi gün tekrar açınca her şey bomboş. Sonunda aynı yerde dönüp duruyorsunuz.

Birden fazla projeyi aynı anda yürütüyorsanız daha da kötü oluyor. Pazartesi yaptığınız bir şeye Perşembe devam etmek istiyorsanız bağlamı en baştan yeniden kurmanız gerekiyor.

Neden

Darboğazın kodda olmadığını fark ettim. Hafızadaydı.

Yapay zeka oturum kapanınca unutuyor, ben de birkaç gün geçince unutuyorum. Ama kimse kayıt tutmadığı için proje sürekli sıfırlanıyor.

Denediğim yöntem

Obsidian’ı projenin uzun vadeli hafıza deposu olarak kullanmaya başladım.

• Obsidian — planlama, tasarım, oturum günlükleri ve hata kayıtlarının tamamını Markdown ile yönetme
• Claude Desktop + MCP — Obsidian notlarını doğrudan okuyup tasarımı tartışan bir “orkestra şefi” rolü
• Claude Code + MCP — tasarımı tamamlanmış işleri gerçekten uygulayan bir “uygulayıcı” rolü

Claude Desktop’taki bağlam kaybı sorununu, oturumlar arası devir teslimi 날짜_handoff.md dosyasına yazarak çözdüm. Yeni bir oturum açarken sadece bu dosyayı okumak bile bağlamı hemen geri getiriyor.

Kilit nokta, "kayıt → tasarım → uygulama → kayıt" döngüsünü tekrar etmekti.

Sonuç

Eskiden toy projelere başlayıp 3 gün sonra klasörü silmeyi tekrar ediyordum; bu yönteme geçtikten sonra ise tamamlayamadığım projeler tek tek ilk sürüm tamamlama → dağıtım → gözden geçirme → düzeltme döngüsüne girmeye başladı. Şu anda 10’dan fazla projeyi aynı anda Obsidian Canvas üzerinde yönetiyorum.

Kısa süre önce Claude Code’a Auto Memory özelliği eklendi; bu, yapay zekanın yapay zeka için tuttuğu notlar. Benim yukarıdaki yöntemim ise insanın insan için tuttuğu kayıtlar. Birbirini tamamlayan ilişkide olduklarını düşünüyorum.

Özet

Bu iş akışını derleyip Wikidocs’ta bir kitap olarak paylaştım. Tamamı ücretsiz.

"Vibe coding neden başarısız olur — yapay zeka iş birliği rehberi" https://wikidocs.net/book/19307

Prolog’dan Ch.22’ye ve ek bölüme kadar mevcut; geri bildirimi her sayfanın yorumlarında bırakırsanız hemen yansıtacağım. Sert bir eleştiri bile memnuniyetle karşılanır.

[runableapp]

Cursor kullanıyorum; bu tür durumları (unutma gibi) yaşamadığım için Claude hakkında buna benzer şeyler ara sıra okuyunca şaşırıyorum. Kalite düşük olduğunda ya da yeterince net belirtilmediğinde böyle sorunlar yaşanabiliyor, ama unutma gibi bir durum bende olmadı. Başka yerlerde hata çıkıp zor durumda kaldığım örnekleri Cursor ürününün ilk dönemlerinde birkaç kez yaşadım, ama artık öyle şeyler olmuyor. Acaba benim projem yeterince büyük olmadığı için mi?

Ben şöyle yapıyorum:

• Genel taslağı, yöntemi ve varsa benzer yaklaşımları da belirterek 10-20 satırlık bir doküman yazıyorum.
• Bunu okuyup tasarım, mimari, testler ve planı detaylı bir doküman halinde yazmasını söylüyorum. Bana soracağı bir şey varsa sormasını da istiyorum. (O zaman çoğu kez bana numaralı seçenekler sunarak sorular soruyor.) Sonra bunun üzerine konuşup tamamlıyoruz. Ayrıca Gemini ile ayrı bir konuşma yapıp daha fazla araştırma yaptırıyor, onun hakkında da birlikte konuşuyoruz.
• Ardından tamamlanan dokümanı gözden geçirip yine konuşarak azar azar düzeltiyoruz, sonra da yapmasını söylüyorum. Geliştirirken biten kısımları tamamlandı diye işaretleyip o dokümanı güncelleyerek ilerlemesini istiyorum. Uzun sürecek kadar büyük ya da karmaşık işler içinse, her gün ne yaptığını başka bir dokümana kaydetmesini de Cursor kuralı olarak ekliyorum.

Dokümanlar proje içinde olduğu için ayrıca özel olarak yönetmek gerekmiyor. Ayrıca Cursor işi durmadan sürdürmüyor. Ne kadar sonuna kadar yap deseniz de hep bir yerde duruyor (bunun garip döngülere girmesin diye bir güvenlik önlemi olduğu söyleniyor ama seçim hakkının bende olmaması hoşuma gitmiyor) ve sizi konuşmaya zorluyor. Yine de bunun faydası oluyor. Saatler sonra dönüp baktığınızda tamamen alakasız bir şey üretilmiş olma ihtimalini de azaltıyor.

Her şeyi tek bir IDE içinde hallettiğim için başka servisler eklemeye gerek kalmıyor. Claude'u API üzerinden yalnızca LLM işlevi için kullandım; kodlama tarafında birçok kişi iyi diyor ama nasıl olduğunu bilmiyorum. Sadece bazen böyle unutma ya da hata verdiğine dair yazılar görünce, acaba proje boyutu küçük olduğu için mi diye düşünüyorum...

Sonuç olarak, şirkette proje ve ekip yönetirken nasıl ilerliyorsak öyle ilerliyorum — insanlarla çalışırken de yaptığımız gibi dokümantasyon ve kayıt, diyalog, kararlar... Yeni bir iş akışı da değil. O yüzden Claude ile hangi iş akışıyla bunu "tam otomatik" yaptıklarını gerçekten merak ediyorum; tam otomatik olmasa bile sık "toplantıları" (insanlardan oluşan ekiplerde de sık toplantıları azaltmaya çalışırız) nasıl azaltabileceğimi düşünüyorum.

[pari0130]

qmd kullanırsanız, önceki oturumları yönetmek için gereken veritabanını yerel olarak yönetir!

[sharpscar]

Faydalı bilgi için teşekkürler.