Belgeler

Kurulu ama sanki hiç kullanılmıyor mu? Hook kabul eden platformlarda bellek ajanınıza itilir ve öğretilmesi gereken bir şey olmaz. Kabul etmeyen platformlarda ise kurulum, platformun kendi bağlam dosyasına bir bellek bölümü yazar; böylece ajan neyi çekeceğini bilir. Bellek bağlı görünüyorsa ama ajan ona hiç başvurmuyorsa, kontrol edilecek ilk şey o dosyadır.

Claude Code'da ne yazar

Claude Code’da, pip install (brethof-brain install-hooks) işlemi, her oturum başlangıcında yeniden yazılan tek bir yönetilen blok tutar. Bu bir işaretçidir, öğretimin kopyası değildir; ajanınıza belleğin Brain olduğunu, ona nasıl ulaşılacağını ve “bunu hatırla” dediğinizde bilginin bir makinedeki Claude Code’un kendi bellek dosyalarına değil, Brain’e gideceğini söyler. Gerçek öğretim oturum başında gelir. Bloğun dışındaki hiçbir şeye dokunmaz: kendi kurallarınız sizin kalır. Bunu kapatmak için BRETHOF_BRAIN_NO_CLAUDE_MD=1 değerini ayarlayın. Eklenti bunu asla yazmaz: eklenti kurulumunda, bloğu eklentinin README dosyasından ~/.claude/CLAUDE.md içine yapıştırın veya ajanınıza yaptırın.

Komutlar ve sürümler

Claude Code eklentisi üç komut sunar: /recall (hemen arama), /onboard (bir projenin ilk dakikası) ve /curate (oturumu kapatma). Elle çalıştırılacak bir şey yoktur — kayıtlar geldikçe bellek onları düzenler ve temizler.

Değişen şey, acentenizle konuşma şeklinizdir. Artık şöyle şeyler söyleyebilirsiniz: Ödeme denemeleri konusunda ne karar verdik? or Unutmayın, sahneleme kutusu eski sertifikaya sahip olanıdır. — Basit bir dille, sohbet sırasında. Ajanınız uygun aracı seçer; siz asla bir isim söylemezsiniz.

Ajanınızın ulaşabileceği şeyler

Bu listeye ihtiyacınız yok. Burada, belirli bir şey istediğinizde nelerin mümkün olduğunu bilesiniz diye bulunuyor.

• Şeyler bulun — Geçmiş bir oturumdan kesin kelimelere ihtiyacınız olduğunda, özenle seçilmiş anılarınızı veya ham sohbet geçmişinizi inceleyin.
• Şeyleri hatırla. — Bir gerçeği bir projeye veya hepsini kapsayan ortak katmana kaydedin.
• Şeyler öğretin. — Bir kural kaydedin veya içinde önemli olan şeyleri tanımlayan bir cümleyle bir proje başlatın.
• Şeyleri inceleyin — projelerinizi listeleyin, bir projenin ne bildiğini listeleyin, kurallarını listeleyin veya tek bir kaydı okuyun.
• Öğeleri kaldırın — tek bir kaydı silin. Tam bir ifadenin sansürlenmesi veya tüm bir projenin silinmesi hesap panelinde yapılır.
• Ledger'ı inceleyin — bir projenin karara bağlanmamış niyet yığınını görün, karar verdikçe satırları kaldırın.
• Oyun kılavuzlarını saklayın. — Bir işlemi hesap genelinde bir kez kaydedin; herhangi bir projeden alıp çalıştırın; mevcut olanları listeyin; artık kullanılmayanları silin.

Bir ajanın kasıtlı olarak yapamayacağı bir şey: Tüm bir projeyi silin. Bu tek eylem ham arşive ulaşır; bu yüzden adı bir insan tarafından yazılan hesap panelinizde kalır.

Kurallar, kendinizi tekrarlamaktan alıkoymanın yollarıdır — ajanlarınızın asla unutmaması gereken gelenekler, kısıtlamalar ve zorlukla elde edilen düzeltmelerdir. İyi kurallar birer yasa gibi görünür: “Cuma günleri asla kullanmayın”, “Bu projede boşluk yerine sekme kullanılır”, “Müşterinin adı Brethof olarak yazılır, asla Brefoth değil.” Kısa, kesin ve gelecek ay da geçerli olan kurallardır.

Ajanınızdan bir kural kaydetmesini isteyin, o da size tek bir şey sorar: bu, yaptığınız her şey için mi, yoksa sadece bu proje için mi?

O üçüncü seçenek önemli olanıdır ve diğer ikisinden daha sık tercih edilir. Bir kural pahalıdır: her oturumda sürekli yer kaplar ve küratöre neyin önemli olduğunu öğretir. Sıradan bilgileri kural olarak kaydetmek, tıpkı bir hafızanın giderek dolup da artık hiçbir şeyin öne çıkmaması gibidir.

Kurallar, sadece temsilciye değil, küratöre de öğretir.

Birkaç keskin kuralı olan bir proje, hiç kuralı olmayandan belirgin biçimde daha iyi hatırlar — çünkü kurallar, onun düzenleyicisine orada neyin önemli olduğunu söyler. Bir kural kaydedin ve birkaç dakika içinde o projenin hafızası, projenin ne olduğunu yeniden öğrenmiştir.

Onları keskin tutmak

Bir kural, yüksek sesle söyleyebileceğiniz kadar kısa olmalıdır — sığmıyorsa, muhtemelen kural kılığına girmiş bir bilgidir. Yinelenenleri tek bir kuralda birleştirin ve bayatlamış kuralları silin; bunları sizin adınıza budayan hiçbir şey yoktur, çünkü yasalarınızın ne olacağına başka hiçbir şeyin karar vermesine izin verilmemelidir. İnandığınız on iki kural, okumayı bıraktığınız elli kuraldan iyidir.

Uygulamadaki projeler.

Tek gerçek karar, onları nasıl bölüştüreceğinizdir: Her kod tabanı, müşteri veya proje için ayrı bir bölüm oluşturmak en iyi yöntemdir. Çok az sayıda ve birbiriyle ilgisiz bölüm olursa işler birbirine karışır; çok fazla bölüm olursa bağlam dağılır. Bir projeye, ne olduğunu ve orada nelerin hatırlanması gerektiğini belirten tek cümlelik bir amaçla başlamak, harcayabileceğiniz en değerli dakikalardır. Bu yaklaşım, amacınızı parça parça anlamaya çalışmak yerine ilk günden itibaren sorumlu kişinin anlamasını sağlar.

Üç farklı şey farklı şekilde ölçülür ve hangisinin ne olduğunu bilmek önemlidir. Kayıt Depolama alanıyla sınırlıdır. Öğrenme Aylık ödeneğinizle sınırlıdır. Geri çağırma Ne tarafından da sınırlanmaz — arama, oturum bilgilendirmeleri ve her istekte geri çağırma işlemleri, hafızanız canlı sistemlerimizde olduğu sürece çalışmaya devam eder.

Eğer abonelik sona ererse

Brain hemen duraklatılır — geçiş süresi yoktur. Belleğiniz 7. gün sonrasında arşivlenir, 23. gün civarında uyarılırsınız ve 30. gün kaldırılır. Ücretli, aktif bir hesaba asla dokunulmaz. Tam takvim ve birlikte gelen e-postalar Gizlilik Politikası'ndadır.

Bir sınırın bıraktığı boşluk ve neden onu asla doldurmayız

Bir sınır mevcut olsa da, yeni anılar oluşmaz. Bu da söz konusu dönemi kapsayan hafızanızda bir boşluk bırakır. Daha sonra geri dönüp onu doldurmuyoruz.. Bu, kasıtlı bir tasarım kuralıdır ve bunu bilmelisiniz.

Bir anı yalnızca bir konuşmadan oluşur. Tesadüfen. Haftalar öncesine ait bilgilerden oluşturulan ve daha sonra yazılan bir kayıt, o zamandan beri doğru olan şeyleri silip atacaktır; hafızanız da artık doğru olmayan şeyleri kesin olarak iddia etmeye başlayacaktır. Kesin bir yalan uydurmaktansa boşluk bırakmayı tercih ederiz.

Kısacası: boşluk bellek olarak kalıcıdır. O döneme ait ham konuşma geçmişiniz hâlâ oradadır ve aranabilir durumdadır; kayıt kaybolmamıştır — yalnızca damıtılmış katmanda bir delik vardır. Sınır ne kadar uzun sürerse, belleğiniz asıl yaptığınız işten o kadar uzaklaşır. Ve devam ettiğinizde kendini onarmaz: ajanınız eskimiş anıları karşılaştıkça düzeltir, bellek yeni kayıtları eski olanlarla karşılaştırarak uzlaştırır ve daha yeni anılarınızın çürüttüğü olanları emekliye ayırır. İkisi de ileriye doğru çalışır, asla geriye değil.

Hiç kimse sessizce engellenmez. Bir sınırın yaklaştığınızda bir e-posta alırsınız; sınır aşıldığında başka bir e-posta gelir. Ajan oturumunuz başladığında bir uyarı mesajı görürsünüz ve sınır aktifken her komut satırında kısa bir bilgi yer alır.