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 | Özellik | v2.0 | v2.1 | |---------|------|------| | Depolama | Global (~/.claude/homunculus/) | Proje kapsamlı (projects/<hash>/) | | Kapsam | Tüm instinct'ler her yerde geçerli | Proje kapsamlı + global | | Tespit | Yok | git remote URL / repo path | | Yükseltme | Yok | Proje → 2+ projede görülünce global | | Komutlar | 4 (status/evolve/export/import) | 6 (+promote/projects) | | Çapraz proje | Kontaminasyon riski | Varsayılan olarak izole | ## v2'deki Yenilikler (vs v1) | Özellik | v1 | v2 | |---------|----|----| | Gözlem | Stop hook (oturum sonu) | PreToolUse/PostToolUse (%100 güvenilir) | | Analiz | Ana bağlam | Arka plan agent'ı (Haiku) | | Granülerlik | Tam skill'ler | Atomik "instinct'ler" | | Güven | Yok | 0.3-0.9 ağırlıklı | | Evrim | Doğrudan skill'e | Instinct'ler -> kümeleme -> skill/command/agent | | Paylaşım | Yok | Instinct'leri dışa/içe aktar | ## Instinct Modeli Instinct küçük öğrenilmiş bir davranıştır: ```yaml --- 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: ```json { "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: ```bash # 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 ```bash /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 | Komut | Açıklama | |---------|-------------| | `/instinct-status` | Tüm instinct'leri göster (proje kapsamlı + global) güvenle | | `/evolve` | İlgili instinct'leri skill/command'lara kümele, yükseltme öner | | `/instinct-export` | Instinct'leri dışa aktar (kapsam/alana göre filtrelenebilir) | | `/instinct-import <file>` | Kapsam kontrolü ile instinct'leri içe aktar | | `/promote [id]` | Proje instinct'lerini global kapsamına yükselt | | `/projects` | Tüm bilinen projeleri ve instinct sayılarını listele | ## Konfigürasyon Arka plan gözlemcisini kontrol etmek için `config.json` dosyasını düzenleyin: ```json { "version": "2.1", "observer": { "enabled": false, "run_interval_minutes": 5, "min_observations_to_analyze": 20 } } ``` | Anahtar | Varsayılan | Açıklama | |-----|---------|-------------| | `observer.enabled` | `false` | Arka plan gözlemci agent'ını aktifleştir | | `observer.run_interval_minutes` | `5` | Gözlemcinin gözlemleri ne sıklıkla analiz ettiği | | `observer.min_observations_to_analyze` | `20` | Analiz çalışmadan önce minimum gözlem | 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 | Kalıp Tipi | Kapsam | Örnekler | |-------------|-------|---------| | Dil/framework kuralları | **project** | "React hook'ları kullan", "Django REST kalıplarını takip et" | | Dosya yapısı tercihleri | **project** | "Testler `__tests__`/ içinde", "Bileşenler src/components/ içinde" | | Kod stili | **project** | "Fonksiyonel stil kullan", "Dataclass'ları tercih et" | | Hata işleme stratejileri | **project** | "Hatalar için Result tipi kullan" | | Güvenlik uygulamaları | **global** | "Kullanıcı input'unu doğrula", "SQL'i sanitize et" | | Genel en iyi uygulamalar | **global** | "Önce testleri yaz", "Her zaman hataları işle" |