Dual-Brain — Codex/Claude Code’a ‘sol beyin/sağ beyin tarzı tartışma iş akışı’ ekleyen bir beceri

Merhaba. Son dönemde Codex veya Claude Code’u gerçek işlerde kullanırken, LLM’lerin karmaşık kod yazarken kolayca aşırı yüklenmesi ya da geçmiş kararları geri alması sorununu azaltmak için açık kaynak olarak geliştirilmekte olan genişletilmiş beceri protokolü Dual-Brain’i tanıtmak istiyorum.

Dual-Brain, yapay zekaya “PM / geliştirici / QA” gibi unvanlar vermekten ziyade, probleme bakıştaki düşünme işlevlerini ayırmaya daha yakındır.

Tek bir ajan hemen cevap üretmek yerine, sağ beyin rolündeki bağlam sorgulaması ile sol beyin rolündeki mantık doğrulamasından sırasıyla geçmeye zorlanır; ardından orchestrator nihai sonucu sentezler.

1. Mevcut tek ajanlı çalıştırmanın 3 başarısızlık modu

Terminalde LLM’e tek seferde karmaşık mimari tasarımı ya da refactoring işi verdiğinizde genellikle şu sorunlarla sık karşılaşırsınız.

• Metni olduğu gibi kabul etme tuzağı
  Belirsiz gereksinimleri aynen kabul edip, alakasız kodu kendinden emin biçimde üretir.
• Detay cehennemi
  Mikro düzeyde kod sözdizimi ve edge case’lere gömülerek, daha basit ve daha iyi bir mimari yolu kaçırır.
• Hafıza kaybı döngüsü
  Oturum bitince önceki bağlam kaybolur; böylece geçen hafta zaten kararlaştırılmış mimari yönü bir sonraki oturumda tekrar geri alır.

2. Çözüm: iki düşünme işlevi

Dual-Brain yüklendiğinde ana ajan orchestrator rolünü üstlenir ve hemen cevap vermez. Bunun yerine, belirlenmiş sırayla iki iç inceleme adımını çalıştırır.

• Sağ beyin, Right Brain: bağlam / örüntü / sorgulama
  Kullanıcının gereksinimlerini hemen uygulamak yerine önce onlardan şüphe eder. “Bu gereksinimin kör noktası nedir?”, “Geçmiş kararlarla çelişiyor mu?”, “Terimler belirsiz mi?” gibi soruları inceler.
• Sol beyin, Left Brain: mantık / doğrulama / kod
  Sağ beynin oluşturduğu problem tanımını gerçek kod tabanı, resmi belgeler ve proje hafızasıyla karşılaştırır. Hallucinated API’leri, eski varsayımları ve uygulanamaz tasarımları ayıklayıp uygulanabilir hale getirir.

Son aşamada orchestrator bu iki sonucu birleştirir; kod değişiklikleri, dokümantasyon ve hafıza güncellemesine kadar süreci devam ettirir.

3. Hafıza kademelendirme sistemi

Bu beceri, uzun süreli hafızayı proje kökündeki .dual-brain/MEMORY.md dosyasına kaydeder.

Ancak proje büyüdükçe, çok eski kararlarla geçen haftanın aktif kısıtlarının aynı ağırlıkta karışması gibi bir sorun ortaya çıkabilir. Bunu çözmek için memory düz bir belge olarak değil, katmanlı hafıza olarak ele alınır.

• Hot Memory
• Warm Memory
• Cold Memory
• Archived Decisions

Hot Memory, mevcut işe güçlü biçimde etki eden aktif kararlar ve kısıtlardır.

Warm Memory, yalnızca ilgili işlerde okunan faydalı bağlamdır.

Cold Memory ve Archived Decisions ise varsayılan olarak tamamen okunmaz; yalnızca anahtar kelime araması ya da çakışma doğrulaması gerektiğinde başvurulur.

refs, sadece okunmuş olduğu için artmaz; yalnızca gerçek soru / doğrulama / sentez / uygulamayı etkilediğinde artar.

Eskiyen veya yinelenen hafıza otomatik olarak sıkıştırılır; çelişkili ya da terk edilmiş kararlar Archived bölümüne taşınır.

Hassas bilgiler, token’lar, anahtarlar ve kişisel veriler kaydedilmez ya da özetlenmez; silinecek/kaydedilmeyecek içerik olarak işlenir.

Önemli nokta, memory’nin gerçeğin tek kaynağı olmamasıdır. Dual-Brain’de memory danışman niteliğinde bağlamdır; güncel kod ve resmi belgeler, eskiyebilen memory’den önceliklidir.

4. Benchmark

Repo içinde, Codex temel alınarak single-agent yaklaşımı ile Dual-Brain yaklaşımını karşılaştıran küçük bir benchmark harness bulunuyor.

Dual-Brain hızlı bir yaklaşım değildir. Hatta ön tarafta daha fazla düşünmeye zorlayarak, insanların sonradan tekrar düzeltip açıklama yapmak zorunda kaldığı döngüyü azaltmayı hedefler.

5. Kurulum

SkillsGate kullanırsanız skill’i Codex CLI ve Claude Code ortamlarına kurup yönetebilirsiniz.

npx skillsgate add sleeplesshan/dual-brain -g  
Elle kurulum da mümkündür.  
 - Codex  
Bash  
git clone [https://github.com/sleeplesshan/dual-brain.git](https://github.com/sleeplesshan/dual-brain.git) ~/.codex/skills/dual-brain  
 - Claude Code  
Bash  
git clone [https://github.com/sleeplesshan/dual-brain.git](https://github.com/sleeplesshan/dual-brain.git) ~/.claude/skills/dual-brain  
Kurulumdan sonra her zamanki gibi doğal dille çağırabilirsiniz.  
  
6. Ne zaman kullanmak iyi olur  
Dual-Brain basit düzenlemeler için fazladır. Değişken adı değiştirme, tek satırlık hata düzeltmeleri veya net boilerplate işleri için özellikle gerekmez.  
Bunun yerine şu durumlarda iyi uyum sağlar.  
- Gereksinimleri belirsiz refactoring işleri  
- Mimari kararlar  
- Yabancı API veya SDK entegrasyonu  
- Geçmiş kararlarla çakışabilecek değişiklikler  
- hallucinated API’nin gerçek arızaya yol açabileceği işler  
- “Şu anda doğru soruyu sorup sormadığımı bile bilmiyorum” dedirten işler  
  
Açık kaynak (MIT lisansı) olarak tüm SKILL.md ve benchmark harness’i yayımladım.  
LLM orchestration, prompt engineering ve agent memory tasarımıyla ilgilenenlerden geri bildirim almak isterim.