Sıfır-Daemon Hafıza Motoru: 10.000 Satır Kodu 40 Token'a Nasıl Sıkıştırıyoruz?

Bir yapay zekâ kodlama ortamı her arka planda hantal bir dil sunucusu (LSP) başlattığında, bir melek kanatlarını kaybeder.

2026’da kurumsal dünyanın bir AI kodlama ajanına depo farkındalığı kazandırmak için sunduğu standart reçete son derece sığdır: 2 GB RAM yiyen bir Java/Node.js Language Server Protocol (LSP) servisi başlat, arka plana parçalanmış vektör gömmeleri (embeddings) yığan bir veritabanı koy ve ajan bir fonksiyonun nerede olduğunu her sorduğunda on binlerce token ham kodu bağlam penceresine (context window) boşalt.

Yusuf’un dijital garajında bu paradigmanın tamamı mimari bir suç sayılır.

Gece saat 03:00’te citation-manager, boun-archive ve hepyeni gibi çok depolu ortamlarda otonom ajanlarla yan yana çalıştığınızda; arka plan daemon’ları sessizce çöker, vektör gömmeleri topoğrafik bağlantı yerine anlamsal benzerlik sanrıları üretir ve kontrolsüz dosya dökümleri modelin muhakeme yeteneğini token gürültüsünde boğar.

İşte tam bu noktada devreye mimori giriyor: sıfır-daemon proje hafızası, AST depo haritalama ve seans aktivite motorumuz.

1. Vektör Gömmeleri (Embeddings) Mimari Değildir

Vektör veritabanları, “ödeme işlemcisine benzeyen kod parçası” ararken harikadır. Ancak şu soruya cevap ararken feci şekilde yetersiz kalırlar:

“Eğer server/middleware.ts içindeki authMiddleware imzasını değiştirirsem hangi 8 rota bozulur, bunları kim içe aktarıyor (import) ve çağrı grafiği neye benziyor?”

Gömmeler token kümeleri arasındaki kosinüs mesafesini hesaplar; topoğrafik iç-derece (in-degree) veya içe aktarım grafı (import graph) hakkında hiçbir fikirleri yoktur.

Bir ajanın 58 dosya ve 10.725 satır ayrıştırılmış kod içeren bir depoda yönünü bulması gerektiğinde her satırı okumasına gerek yoktur. İhtiyaç duyduğu şey bir yapısal radardır.

`server/db.ts` · 189 ln · ← admin, api.test, auth, citations, +8 · 3 commits/90d
  :6    export const db = new Database(dbPath, { create: true });
  :15   export function initDB()
  :168  export function resetDB()

Şu tek satıra bakın: ← admin, api.test, auth, citations, +8. Bu ok işareti, düz bir grep veya vektör aramasının tek adımda size asla veremeyeceği en kritik bilgiyi sunar: bu dosyaya kimler bağımlı.

2. PageRank + 90 Günlük Git Değişim Yoğunluğu

mimori, bellekte yer kaplayan ve bayat önbellek durumlarına yol açan yerleşik bir arka plan servisi çalıştırmak yerine, tamamen talep anında çalışan bağımsız bir CLI ikilisidir. Bir çalışma seansı başladığında tek bir komut çalışır:

mimori dump > /tmp/ctx.md

Kaputun altında dosyaları alfabetik olarak dizmez. Deponun içe aktarımlarından bellekte yönlü bir graf oluşturur, bunu son 90 günlük git commit sıklığıyla birleştirir ve giriş noktası sezgiselleriyle ağırlıklandırılmış bir PageRank algoritması çalıştırır.

1. İç-Derece Sıralaması: Herkes tarafından çağrılan kritik omurga modülleri (server/db.ts, AuthContext.tsx) haritanın en tepesine fırlar.
2. Değişim Ağırlığı: 15 dakika önce düzenlenen veya son 3 commit’te değiştirilen dosyalar, tozlu statik yapılandırmaların önüne geçer.
3. Bütçe Sıkıştırması: Dosya başına yaklaşık ~40 token harcar. 10.000 satırlık bir repo, ajanın bağlam bütçesinin ufacık bir dilimine sığan bir oryantasyon anlık görüntüsüne indirgenir.
4. Önceliğe Göre Daralma: Karakter bütçesi sınırına gelindiğinde, düşük öncelikli yaprak dizinler temiz bir şekilde dizin özetlerine daralır (dev-docs/ — 9 dosya (.md)), yüksek etkili mimari düğümler ise kesin satır numaralarıyla tamamen açık kalır.

3. Mağara Adamı (Caveman) Tarzı: Bağlaç Çöpünü Temizlemek

Hafıza motorumuzun ikinci ayağı, ajanların kalıcı bilgiyi nasıl kaydettiğidir. Geleneksel dökümantasyonlar kibar kurumsal dolgu laflarıyla şişirilir:

“Testlerin yürütülmesi sırasında, eşzamanlılık çakışmalarını önlemek için SQLite veritabanının bellekte tutulmasının sağlanması düşünülebilir…”

.mimori/memory.md ve .mimori/decisions.md dosyalarında bu tarz paragraflar kesin olarak yasaktır. Mağara Adamı Tarzı (Caveman Style) kuralı geçerlidir:

## [2026-08-23] Test Paketi Mimarisi & İzolasyonu
- **Bağlam**: Testler üretim veri tabanını ve global durumu paylaşıyordu; paralellik veri sızıntısına yol açtı.
- **Karar**: Testlerde `:memory:` SQLite zorla; beforeEach'te DB sıfırla. vitest + RTL kur.
- **Sonuçlar**: Testler paralel ve temiz çalışır. Sıkı yapısal ve durum doğrulamaları zorunludur.

• At: Tanımlıklar (a/an/the), dolgu kelimeler (sadece, gerçekten, temel olarak, aslında), çekinceli ifadeler (“şöyle olabilir”), bağlaçlar (ayrıca, dahası).
• Aynen Koru: Kod sembolleri, dosya yolları, komutlar, HTTP durum kodları, hata dizgileri.
• Kural: Asla değil/asla/yok/yalnızca gibi olumsuzluk eklerini atma — anlamı tersine çevirmek bir token kazanmaktan sonsuz kat daha pahalıya patlar.

Yeni bir alt ajan uyandığında, mağara adamı ADR’lerini ve mimari kurallarını 300 token’dan az bir alanda okur ve 3 başarısız test denemesiyle keşfetmek zorunda kalmadan sistemin kutsal kurallarını hemen öğrenir.

4. Oku Değil, Hesapla

Atölyenin en temel ilkesi şudur: Kodla düşün — oku değil, hesapla.

Kaç rotanın yönetici yetkisi gerektirdiğini saymak için bağlama 20 dosya çekmeyin. Tek satırlık bir bash/python betiği yazın, çalıştırın, cevabı stdout’a verin ve model sadece sonucu görsün:

rg -c "adminMiddleware" server/routes | awk -F: '{s+=$2} END{print s}'

Depo yapısına sonsuz bir metin akışı yerine matematiksel bir graf muamelesi yaptığınızda; ajanlar halüsinasyon görmeyi bırakır, bağlam pencereleri tertemiz kalır ve gece 3’te sıfır jank ve sıfır token israfıyla koca bir arka ucu baştan sona refaktör edebilirsiniz.