AI Asistanlarıyla Çalışırken O Sinir Bozan Sorun: Her Seferinde Sıfırdan Başlamak

Şöyle düşün: Üç gündür üzerinde çalıştığın bir özelliği tamamlayıp cuma günü commit attın. Pazar gecesi biraz dinlenip pazartesi günü devam etmeye karar verdin. Terminali açtın, AI asistanını çağırdın ve... karşında bomboş bir tuval. O değişken adlandırma stillerin, o ekibin belirlediği test yaklaşımı, o saatlerce tartışarak aldığınız mimari kararlar — tamamen uçup gitmiş.

Tanıdık geliyor değil mi? İşte tam bu noktada devreye brain.md giriyor.

brain.md Nedir, Neden Var?

Basitçe anlatayım: brain.md, AI coding asistanları için bir çeşit kalıcı hafıza sistemi. Projenle ilgili her şeyi — mimari kararları, takım içi kuralları, dikkat edilmesi gereken noktaları — markdown dosyalarında saklıyor. Her yeni oturum başladığında AI asistanın bu dosyaları okuyarak kaldığı yerden devam edebiliyor.

Yani aslında yapay zekana "bak, biz bunu daha önce konuşmuştuk" diyebileceğin bir not defteri gibi düşünebilirsin. Terminali kapatıp açsan bile, projenin hafızası silinmiyor.

Bu arada kurulumu son derece sade. Harici bir veritabanı yok, bulut servisi yok, karmaşık konfigürasyon yok. Sadece markdown dosyaları ve işini halleden hafif bir CLI aracı. Bu sadelik, aracın en büyük gücü.

Neden Önemli?

Şöyle bir senaryo düşün: Üç gündür devam eden bir özellik üzerinde çalışıyorsun. AI çift programcınla belirli bir uyum yakaladın — değişkenleri nasıl isimlendirdiğin, testleri nasıl yazdığın, hata yakalama konusunda neye öncelik verdiğin. Sonra hafta sonu geliyor, kodları gönderiyorsun ve pazartesi günü sanki ilk günmüş gibi başa dönüyorsun.

brain.md ile bu kurumsal bilgi birikimini kalıcı hale getirebiliyorsun. Takımının belirlediği kurallar, vazgeçilmez ilkeler, "bu yaklaşımı neden seçmedik" tarzı gerekçeler — hepsi kaydediliyor ve sonraki her oturumda erişilebilir oluyor.

Somut olarak şunları elde ediyorsun:

• Oturumlar arasında tutarlı kod kalitesi — artık rastgele farklı yaklaşımlarla karşılaşmıyorsun
• Yeni ekip üyelerinin daha hızlı adapte olması — yazılı bir referans var
• Projeler arası geçişlerde daha az sürtünme — bağlam tek tıkla aktarılabilir
• Karar süreçlerinin kayıt altında olması — sadece ne yapıldığı değil, neden yapıldığı da belgelenmiş oluyor

Başlamak Beş Dakikanı Alıyor

İşleyiş gerçekten bu kadar basit:

1. CLI aracını kur (boyutu küçük, bağımlılığı yok)
2. Projenin kök dizinine bir .brain klasörü oluştur
3. İhtiyacına göre markdown dosyaları yaz — mimari.md, kurallar.md, kontekst.md, takim-kararlari.md gibi
4. AI asistanını bu dosyaları oturum başında okuyacak şekilde ayarla

Dosyalar sıradan markdown olduğu için insanlar tarafından okunabilir, versiyon kontrolüne uygundur ve birleştirilebilir. Yani tüm ekip bu beyin dosyalarına katkıda bulunabilir.

Mevcut Araç Setine Nasıl Oturuyor?

brain.md, dokümantasyonunun veya Confluence'ın yerine geçmeye çalışmıyor. O boşluğu dolduruyor: "kod ne yapıyor" ile "etkili çalışmak için ne bilmem gerekiyor" arasındaki farkı.

Özellikle uygun olduğu durumlar:

• Bireysel geliştiriciler — kendi oturumları arasında tutarlılık isteyenler
• Ekipler — AI destekli geliştirme için ortak pratikler oluşturmak isteyenler
• Karmaşık gereksinimlere sahip projeler — akılda tutması zor detayları olan işler
• Birden fazla müşteri projesi arasında gidip gelen danışmanlar

Daha Geniş Perspektif: AI-Native Geliştirme Pratiği

Şu gerçeği kabul etmemiz gerekiyor: AI coding asistanları artık geliştirme sürecinin vazgeçilmez parçaları haline geldi. Ancak mevcut araçlarımızın ve pratiklerimizin büyük çoğunluğu bu gerçek göz önüne alınarak tasarlanmamış.

brain.md gibi araçlar yeni bir kategoriye işaret ediyor: AI destekli geliştirme için bağlam altyapısı. İnsan ve makine oturumları arasında bilginin güvenilir şekilde aktarılabilmesi, artık versiyon kontrolü veya test çerçeveleri kadar kritik hale gelmeye başladı.

Proje bağlamını AI araçları için etkili şekilde yakalayıp sürdürmeyi başaran geliştiriciler, önümüzdeki dönemde ciddi bir verimlilik avantajına sahip olacak. Mesele geliştiricilerin yerini almak değil — insan ve yapay zeka işbirliğini gerçek anlamda sürdürülebilir kılmak.

brain.md Sana Uygun mu?

Eğer önemsiz olmayan projelerde AI coding asistanlarıyla ciddi vakit geçiriyorsan, büyük ihtimalle evet. Bağlamı yeniden kurma zihinsel yükü gerçekten var ve bu sürtünmeyi azaltan her şey kısa sürede kendini amorti ediyor.

GitHub'dan projeyi incele, kurulumu dene. Belki tam sana göre değil, ama en azından AI destekli geliştirme çağı için altyapı inşa etmeye nasıl yaklaşıldığını görmek açısından faydalı olacaktır.

Çünkü kodlamanın geleceği sadece AI'ı daha akıllı hale getirmek değil — AI ile yaptığımız işbirliğinin aslında ne inşa ettiğimizi hatırlaması.