AgentVera Brain: projenin neden böyle yapıldığını hatırlayan hafıza
Bir kararın nedeni çoğu zaman bir PR açıklamasında, bir commit mesajında ya da unutulmuş bir ajan konuşmasında kalır. Brain bu kaynakları okur, kararları nedenleriyle listeler, hangilerinin artık kodla uyuşmadığını işaretler ve istersen projedeki yeni ajanlara kısa bir bağlam paketi verir.
Kaynaklar
Hafızayı Detaylar → Brain sekmesinde “Hafızayı oluştur” ile kurar, “Hafızayı yenile” ile güncellersin.
- Git’te izlenen dokümanlar ve ADR’ler: README, ARCHITECTURE, CONTRIBUTING, CLAUDE, AGENTS, CHANGELOG, docs/, adr/, decisions/ ve benzerleri; en fazla 250 dosya.
- Merge olmayan en yeni 1.500 commit ve dokundukları dosyalar.
- Depo GitHub’daysa ve giriş yaptıysan en fazla 200 PR ve 200 issue.
- Projedeki en fazla 120 ajan konuşması.
Kararlar ve durumları
Nedenini anlatan kaynaklar (ADR’ler, uzun PR açıklamaları, “çünkü”, “yerine”, “switched to” içeren commit’ler, konuşmalar) Claude Haiku ile okunur. Her karar başlığı, nedeni, tarihi, kaynakları ve ilgili kod terimleriyle kaydedilir; tekrarlar birleştirilir.
- Durumlar: geçerli, eskimiş, yerine yenisi geldi. Kararın kod terimleri artık kodda geçmiyorsa ya da dosyaları silindiyse karar eskimiş sayılır.
- “Kodla karşılaştır” bu kontrolü git grep ile yeniden yapar; “Claude ile doğrula” tek bir kararı salt okunur bir Claude Sonnet çalıştırmasıyla dosya kanıtına bakarak değerlendirir.
- Bilgi grafiği kararları ve paylaştıkları kod terimlerini gösterir.
Projeye sor ve bağlam paketi
“Neden JWT kullanıyoruz?” gibi bir soru yazdığında en ilgili kararlar ve kaynaklar seçilir, Claude Sonnet salt okunur olarak cevaplar ve kaynaklarını gösterir. Bağlam paketi projenin ne olduğunu, teknolojilerini, önemli kararlarını, kurallarını ve son değişiklikleri en fazla 2.500 karakterde özetler. “Yeni ajanlara bağlam paketi ver” açıksa projede başlatılan her yeni ajan bu özeti ve artık geçerli olmayabilecek kararların listesini talimatlarının sonunda alır. Bu seçenek varsayılan olarak kapalıdır.
Nasıl başlanır
- 1
Proje Detaylar → Brain sekmesini aç ve “Hafızayı oluştur”a tıkla.
- 2
Kararlar listesinde eskimiş olanları süz; gerekirse “Claude ile doğrula” ile kontrol et.
- 3
Bağlam paketi görünümünde paketi incele ve yeni ajanlara verilmesini aç.
Sık sorulanlar
Hafıza kendiliğinden güncellenir mi?
Hayır. “Hafızayı yenile” ile sen güncellersin.
Veriler nerede tutulur?
Hafıza bu bilgisayarda, uygulamanın veri klasöründe proje başına bir dosyada tutulur. Kararları çıkarmak ve soruları cevaplamak için kaynak metinler Claude Code girişinle Anthropic’e gider.
GitHub olmadan çalışır mı?
Evet. Dokümanlar, commit’ler ve konuşmalar yine okunur; PR ve issue’lar yalnızca depo GitHub’daysa ve giriş yaptıysan eklenir.
Ajanlar Brain’i nasıl kullanır?
Bağlam paketi açıksa yeni ajanların talimatına eklenir. Ajanların sorgulayabildiği ayrı bir Brain aracı yoktur.
İlgili özellikler
Ajanlarını bir masaya topla.
Ücretsiz planla başla. İndir, proje klasörünü ekle, ilk ajanını aç.