// 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.
[HINT] تحميل مجلد المهارة الكامل بما في ذلك SKILL.md وجميع الملفات المرتبطة
| 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 |
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.
| Ö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 |
| Ö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 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:
project (varsayılan) veya globalOturum 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 |
+---------------------------------------------+
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ü)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.
~/.claude/settings.json dosyanıza ekleyin.
Plugin olarak kuruluysa (önerilen):
{
"hooks": {
"PreToolUse": [{
"matcher": "*",
"hooks": [{
"type": "command",
"command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh"
}]
}],
"PostToolUse": [{
"matcher": "*",
"hooks": [{
"type": "command",
"command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh"
}]
}]
}
}
~/.claude/skills dizinine manuel kuruluysa:
{
"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"
}]
}]
}
}
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
/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
| 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 |
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.
~/.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
+-- ...
| 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" |
| Tool iş akışı tercihleri | global | "Edit'ten önce Grep", "Write'tan önce Read" |
| Git uygulamaları | global | "Conventional commit'ler", "Küçük odaklı commit'ler" |
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:
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 zamanla evrimleşir:
| Skor | Anlamı | Davranış |
|---|---|---|
| 0.3 | Geçici | Önerilir ama zorunlu değil |
| 0.5 | Orta | İlgili olduğunda uygulanır |
| 0.7 | Güçlü | Uygulama için otomatik onaylanır |
| 0.9 | Neredeyse kesin | Temel davranış |
Güven artar şu durumlarda:
Güven azalır şu durumlarda:
"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:
v2.1, v2.0 ve v1 ile tamamen uyumludur:
~/.claude/homunculus/instincts/ içindeki mevcut global instinct'ler hala global instinct olarak çalışır~/.claude/skills/learned/ skill'leri hala çalışırInstinct tabanlı öğrenme: Claude'a kalıplarınızı öğretmek, her seferinde bir proje.