Continuous Learning V2

Sürekli Öğrenme v2.1 - Instinct Tabanlı Mimari

Claude Code oturumlarınızı güven skorlaması ile atomik "instinct'ler" - küçük öğrenilmiş davranışlar - aracılığıyla yeniden kullanılabilir bilgiye dönüştüren gelişmiş bir öğrenme sistemi.

v2.1 proje kapsamlı instinct'ler ekler — React kalıpları React projenizde kalır, Python kuralları Python projenizde kalır ve evrensel kalıplar (örneğin "her zaman input'u doğrula") global olarak paylaşılır.

Ne Zaman Aktifleştirmelisiniz

• Claude Code oturumlarından otomatik öğrenme ayarlarken
• Hook'lar aracılığıyla instinct tabanlı davranış çıkarmayı yapılandırırken
• Öğrenilmiş davranışlar için güven eşiklerini ayarlarken
• Instinct kütüphanelerini incelerken, dışa veya içe aktarırken
• Instinct'leri tam skill'lere, command'lara veya agent'lara evriltirken
• Proje kapsamlı vs global instinct'leri yönetirken
• Instinct'leri projeden global kapsamına yükseltirken

v2.1'deki Yenilikler

v2'deki Yenilikler (vs v1)

Instinct Modeli

Instinct küçük öğrenilmiş bir davranıştır:

---
id: prefer-functional-style
trigger: "yeni fonksiyonlar yazarken"
confidence: 0.7
domain: "code-style"
source: "session-observation"
scope: project
project_id: "a1b2c3d4e5f6"
project_name: "my-react-app"
---

# Fonksiyonel Stili Tercih Et

## Aksiyon
Uygun olduğunda sınıflar yerine fonksiyonel kalıpları kullan.

## Kanıt
- 5 fonksiyonel kalıp tercihinin gözlemlenmesi
- Kullanıcı 2025-01-15'te sınıf tabanlı yaklaşımı fonksiyonele düzeltti

Özellikler:

• Atomik -- bir tetikleyici, bir aksiyon
• Güven ağırlıklı -- 0.3 = geçici, 0.9 = neredeyse kesin
• Alan etiketli -- code-style, testing, git, debugging, workflow, vb.
• Kanıt destekli -- hangi gözlemlerin oluşturduğunu takip eder
• Kapsam farkında -- project (varsayılan) veya global

Nasıl Çalışır

Oturum Aktivitesi (bir git repo'sunda)
      |
      | Hook'lar prompt'ları + tool kullanımını yakalar (%100 güvenilir)
      | + proje bağlamını tespit eder (git remote / repo path)
      v
+---------------------------------------------+
|  projects/<project-hash>/observations.jsonl  |
|   (prompt'lar, tool çağrıları, sonuçlar, proje)   |
+---------------------------------------------+
      |
      | Gözlemci agent okur (arka plan, Haiku)
      v
+---------------------------------------------+
|          KALIP TESPİTİ                      |
|   * Kullanıcı düzeltmeleri -> instinct      |
|   * Hata çözümleri -> instinct              |
|   * Tekrarlanan iş akışları -> instinct     |
|   * Kapsam kararı: project mi global mi?   |
+---------------------------------------------+
      |
      | Oluşturur/günceller
      v
+---------------------------------------------+
|  projects/<project-hash>/instincts/personal/ |
|   * prefer-functional.yaml (0.7) [project]   |
|   * use-react-hooks.yaml (0.9) [project]     |
+---------------------------------------------+
|  instincts/personal/  (GLOBAL)               |
|   * always-validate-input.yaml (0.85) [global]|
|   * grep-before-edit.yaml (0.6) [global]     |
+---------------------------------------------+
      |
      | /evolve kümeleme + /promote
      v
+---------------------------------------------+
|  projects/<hash>/evolved/ (proje kapsamlı)   |
|  evolved/ (global)                           |
|   * commands/new-feature.md                  |
|   * skills/testing-workflow.md               |
|   * agents/refactor-specialist.md            |
+---------------------------------------------+

Proje Tespiti

Sistem mevcut projenizi otomatik olarak tespit eder:

1. CLAUDE_PROJECT_DIR env var (en yüksek öncelik)
2. git remote get-url origin -- taşınabilir proje ID'si oluşturmak için hash'lenir (farklı makinelerde aynı repo aynı ID'yi alır)
3. git rev-parse --show-toplevel -- repo path kullanan yedek (makineye özgü)
4. Global yedek -- proje tespit edilemezse, instinct'ler global kapsamına gider

Her proje 12 karakterlik bir hash ID alır (örn. a1b2c3d4e5f6). ~/.claude/homunculus/projects.json dosyasındaki kayıt dosyası ID'leri insanların okuyabileceği isimlerle eşler.

Hızlı Başlangıç

1. Gözlem Hook'larını Aktifleştirin

~/.claude/settings.json dosyanıza ekleyin.

Plugin olarak kuruluysa (önerilen):

~/.claude/settings.json içine ek hook bloğu eklemeyin. Claude Code v2.1+ eklentinin hooks/hooks.json dosyasını otomatik yükler; observe.sh zaten orada kayıtlıdır.

Daha önce observe.sh satırlarını ~/.claude/settings.json içine kopyaladıysanız, yinelenen PreToolUse / PostToolUse bloğunu kaldırın. Yinelenen kayıt hem çift çalıştırmaya yol açar hem de ${CLAUDE_PLUGIN_ROOT} çözümleme hatası üretir; bu değişken yalnızca eklentiye ait hooks/hooks.json girdilerinde genişletilir.

~/.claude/skills dizinine manuel kuruluysa, aşağıdakini ~/.claude/settings.json içine ekleyin:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh"
      }]
    }],
    "PostToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh"
      }]
    }]
  }
}

2. Dizin Yapısını Başlatın

Sistem ilk kullanımda dizinleri otomatik oluşturur, ancak manuel olarak da oluşturabilirsiniz:

# Global dizinler
mkdir -p ~/.claude/homunculus/{instincts/{personal,inherited},evolved/{agents,skills,commands},projects}

# Proje dizinleri hook bir git repo'sunda ilk çalıştığında otomatik oluşturulur

3. Instinct Komutlarını Kullanın

/instinct-status     # Öğrenilmiş instinct'leri göster (proje + global)
/evolve              # İlgili instinct'leri skill/command'lara kümele
/instinct-export     # Instinct'leri dosyaya aktar
/instinct-import     # Başkalarından instinct'leri içe aktar
/promote             # Proje instinct'lerini global kapsamına yükselt
/projects            # Tüm bilinen projeleri ve instinct sayılarını listele

Komutlar

Konfigürasyon

Arka plan gözlemcisini kontrol etmek için config.json dosyasını düzenleyin:

{
  "version": "2.1",
  "observer": {
    "enabled": false,
    "run_interval_minutes": 5,
    "min_observations_to_analyze": 20
  }
}

Diğer davranışlar (gözlem yakalama, instinct eşikleri, proje kapsamı, yükseltme kriterleri) instinct-cli.py ve observe.sh içindeki kod varsayılanları aracılığıyla yapılandırılır.

Dosya Yapısı

~/.claude/homunculus/
+-- identity.json           # Profiliniz, teknik seviye
+-- projects.json           # Kayıt: proje hash -> isim/path/remote
+-- observations.jsonl      # Global gözlemler (yedek)
+-- instincts/
|   +-- personal/           # Global otomatik öğrenilmiş instinct'ler
|   +-- inherited/          # Global içe aktarılan instinct'ler
+-- evolved/
|   +-- agents/             # Global oluşturulan agent'lar
|   +-- skills/             # Global oluşturulan skill'ler
|   +-- commands/           # Global oluşturulan komutlar
+-- projects/
    +-- a1b2c3d4e5f6/       # Proje hash (git remote URL'den)
    |   +-- project.json    # Proje başına metadata yansıması (id/name/root/remote)
    |   +-- observations.jsonl
    |   +-- observations.archive/
    |   +-- instincts/
    |   |   +-- personal/   # Projeye özgü otomatik öğrenilmiş
    |   |   +-- inherited/  # Projeye özgü içe aktarılan
    |   +-- evolved/
    |       +-- skills/
    |       +-- commands/
    |       +-- agents/
    +-- f6e5d4c3b2a1/       # Başka bir proje
        +-- ...

Kapsam Karar Kılavuzu

Instinct Yükseltme (Project -> Global)

Aynı instinct birden fazla projede yüksek güvenle göründüğünde, global kapsamına yükseltme adayıdır.

Otomatik yükseltme kriterleri:

• 2+ projede aynı instinct ID
• Ortalama güven >= 0.8

Nasıl yükseltilir:

# Belirli bir instinct'i yükselt
python3 instinct-cli.py promote prefer-explicit-errors

# Tüm uygun instinct'leri otomatik yükselt
python3 instinct-cli.py promote

# Değişiklik yapmadan önizle
python3 instinct-cli.py promote --dry-run

/evolve komutu ayrıca yükseltme adaylarını önerir.

Güven Skorlaması

Güven zamanla evrimleşir:

Güven artar şu durumlarda:

• Kalıp tekrar tekrar gözlemlenir
• Kullanıcı önerilen davranışı düzeltmez
• Diğer kaynaklardan benzer instinct'ler hemfikirdir

Güven azalır şu durumlarda:

• Kullanıcı davranışı açıkça düzeltir
• Kalıp uzun süre gözlemlenmez
• Çelişkili kanıt ortaya çıkar

Neden Gözlem için Skill'ler Yerine Hook'lar?

"v1 gözlem için skill'lere güveniyordu. Skill'ler olasılıksaldır -- Claude'un yargısına göre zamanın ~%50-80'inde tetiklenirler."

Hook'lar %100 deterministik olarak tetiklenir. Bu şu anlama gelir:

• Her tool çağrısı gözlemlenir
• Hiçbir kalıp kaçırılmaz
• Öğrenme kapsamlıdır

Geriye Dönük Uyumluluk

v2.1, v2.0 ve v1 ile tamamen uyumludur:

• ~/.claude/homunculus/instincts/ içindeki mevcut global instinct'ler hala global instinct olarak çalışır
• v1'den ~/.claude/skills/learned/ skill'leri hala çalışır
• Stop hook hala çalışır (ama şimdi v2'ye de beslenir)
• Kademeli geçiş: her ikisini de paralel çalıştırın

Gizlilik

• Gözlemler makinenizde yerel kalır
• Proje kapsamlı instinct'ler proje başına izoledir
• Sadece instinct'ler (kalıplar) dışa aktarılabilir — ham gözlemler değil
• Gerçek kod veya konuşma içeriği paylaşılmaz
• Neyin dışa aktarılacağını ve yükseltileceğini siz kontrol edersiniz

İlgili

• ECC-Tools GitHub App - Repo geçmişinden instinct'ler oluştur
• Homunculus - v2 instinct tabanlı mimariye ilham veren topluluk projesi (atomik gözlemler, güven skorlaması, instinct evrim hattı)
• The Longform Guide - Sürekli öğrenme bölümü

Instinct tabanlı öğrenme: Claude'a kalıplarınızı öğretmek, her seferinde bir proje.

Source: affaan-m/ECC → docs/tr/skills/continuous-learning-v2/SKILL.md