Knowledge Auto Update

---
name: knowledge-auto-update
description: "Agent-local knowledge dosyalarini gorev sonunda ogrenilenlerle guncelle. Triggers: knowledge update, agent knowledge refresh, ogrendigini kaydet."
argument-hint: "[agent-id] [--auto]"
---

# /knowledge-auto-update — Per-Agent Knowledge-First Auto-Update

Bir agent non-trivial bir gorevi bitirdikten sonra kendi `knowledge/` dizinini (sadece kendisininkini) ogrendikleriyle gunceller. Patterns, trial-and-error dersleri, domain bulgulari — hepsi ekleme (additive patch) seklinde.

## Kapsam (zorunlu)

**Agent-local only.** Bu skill SADECE `~/Projects/claude-config/agents/<agent>/knowledge/*.md` altinda yazar.

- Global skill olusturma **YASAK** (SessionStart sisirir — Video 1 / Video 4 uyarisi)
- Baska agent'in knowledge'ini degistirme
- `~/.claude/` altina dogrudan yazma — install.sh ile mirror edilecek
- CLAUDE.md / charter / harness — dokunma

Manuel muadiller: `agent-sharpen` (web'den arastir), `agent-refine-knowledge` (Opus ile kalite review). Bu skill otomatik "gorevden ogrenilen" yakalayici; onlarin yerini tutmaz.

## Tetikleme modlari

| Mod | Nasil |
|-----|-------|
| Manuel | `/knowledge-auto-update <agent-id>` — kullanici veya Jarvis cagirir |
| Auto | Agent kendini `>10 tool call` sonrasi self-trigger — opsiyonel hook wiring (su an devre disi) |

Auto hook wiring bu skill kapsamina **dahil degil** — ayri karar. Su an sadece manuel + explicit trigger.

## Akis

### 1. Agent tespit

- Argument verildiyse `<agent-id>` onu kullan
- Yoksa son dispatch edilen agent'i `/tmp/watchdog/current_dispatch.json`'dan oku
- Hic yoksa → kullaniciya sor, dur

### 2. Gorev ozeti cikar

Son turn'deki (veya son dispatch'teki) tool call'lari ve sonuclari tara:
- Hangi dosyalara dokunuldu?
- Hangi komutlar basarisiz oldu, neden?
- Hangi non-obvious pattern kullanildi?
- Hangi domain gercegi kesfedildi? (API quirk, lib davranisi, repo yapisi)

Max 8 tool call bu adimda.

### 3. Kategorize et

Bulgulari 3 bucket'a ayir:

| Bucket | Ornek |
|--------|-------|
| **Patterns** | "Bu tur task'ta once X, sonra Y yap" |
| **Trial-and-error** | "Z denedim, W yuzunden patladi, V ile calisti" |
| **Domain facts** | "Library A'nin method B'si default'u C degil D" |

Trivial olani at (1 satirlik obvious seyleri kaydetme).

### 4. Safety guard

Her bulguyu yazmadan once kontrol et — asagidakilerden biri varsa **reddet**:

- `rm -rf`, `sudo rm`, `dd if=` gibi destructive komut ornekleri
- `curl ... | bash`, `wget ... | sh` gibi remote-exec patterns
- API key, token, password, secret deger (env var adi OK, deger DEGIL)
- Musteri/kisisel veri (email, telefon, kimlik)
- Baska kullanici/agent isimleri + kisisel yorumlar

Reddet = kaydetme + kullaniciya tek satir bildir: `[GUARD] rejected N entries (reason: secret|destructive|pii).`

### 5. Additive patch

`~/Projects/claude-config/agents/<agent>/knowledge/` altinda:

- Uygun dosya varsa (ornek `patterns.md`, `lessons.md`, `domain.md`) → dosyanin sonuna **ekle**, ustune yazma
- Yoksa yeni dosya olustur: `knowledge/<kategori>.md`
- Her yeni entry'e tarih + gorev kisa ozeti prefix'i: `<!-- 2026-04-23 — task: {ozet} -->`

### 6. Index guncelle

`knowledge/_index.md` dosyasini ac:
- Yeni dosya eklendiyse → index'e 1 satir ekle
- Mevcut dosyaya entry eklendiyse → (opsiyonel) entry count guncelle
- 200 satir limitini koru — asarsa kullaniciya `agent-refine-knowledge` oner

### 7. Rapor

```
## Knowledge Auto-Update — <agent-id>

- Patterns: +N entries → patterns.md
- Lessons: +M entries → lessons.md
- Domain: +K entries → domain.md
- Rejected by guard: R (reasons: ...)
- Index: updated

Next: install.sh gerekirse calistir (runtime mirror icin).
```

## Kurallar

- Max 15 tool call toplam
- ASLA global skill/agent/plugin olusturma
- ASLA baska agent'in klasorune yazma
- Safety guard **opt-out edilemez**
- Dil: entries Turkce+Ingilizce karisik OK (mevcut knowledge stiline uy)
- Duplicate kontrolu yap — ayni pattern zaten varsa ekleme, skip

## When NOT to Use
- Trivial gorev (<10 tool call, cok net yol) — ogrenilecek yeni birsey yok
- Sadece okuma yapan gorev (investigation) — patterns disinda kayit sey yok
- Hatali/yarida kalan gorev — yanlis dersler yazmaktansa atla

## Red Flags
- Ayni entry iki iterasyonda tekrar ekleniyor → duplicate check calismiyor, dur
- Guard > actual saves oranı yuksek → prompt secret/dangerous icerikle kirli
- Knowledge dosyasi 500 satiri astı → `agent-refine-knowledge` oner, ekleme yapma

## Error Handling
- Agent klasoru yok → dur, `agent-setup` oner
- Write izni yok → dur, path'i kullaniciya goster
- Guard tetiklendi → entry'yi sessizce at, final raporda say

## Verification
- [ ] Sadece hedef agent'in knowledge/ altina yazildi
- [ ] Safety guard calisti, reject sayisi raporlandi
- [ ] _index.md guncel
- [ ] Global scope'a dokunulmadi (skill/plugin/agent yaratilmadi)
- [ ] Duplicate kontrol yapildi