continuous-learning-v2

name continuous-learning-v2 description Hook'lar aracılığıyla oturumları gözlemleyen, güven skorlaması ile atomik instinct'ler oluşturan ve bunları skill/command/agent'lara evriltiren instinct tabanlı öğrenme sistemi. v2.1 çapraz proje kontaminasyonunu önlemek için proje kapsamlı instinct'ler ekler. origin ECC version 2.1.0 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/ /) 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: --- 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: CLAUDE_PROJECT_DIR env var (en yüksek öncelik) 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) git rev-parse --show-toplevel -- repo path kullanan yedek (makineye özgü) 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 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: { "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"