---
name: knowledge-hub
description: "Şirket içi bilgi tabanında arama. Önceki kararlar, teknik docs, market intel, ürün spec'leri, ops runbook'ları ve içerik kütüphanesi. Tüm agent'lar kullanabilir."
---

# Knowledge Hub — RAG Search

## Ne Zaman Kullan (ZORUNLU)
- **HER yeni task'a başlamadan ÖNCE:** 1 dakikalık hızlı search yap. Daha önce buna benzer bir şey yapılmış mı?
- Önceki karar veya tartışmaları ararken
- Teknik dokümantasyon gerektiğinde
- Market intelligence verilerine erişirken
- Bir issue'yu "nasıl yaparım?" diye değerlendirirken — önce search, sonra yap
- Aynı sorun ikinci kez geliyorsa — muhtemelen knowledge hub'da çözümü var

## Nasıl Kullan

Terminal tool ile `search.py` çalıştır:

```bash
python3 ~/.hermes/skills/knowledge-hub/search.py "arama sorgusu" "collection-adı"
```

## Hangi Collection'ı Seçmeliyim? — Karar Ağacı

Sorun ilk olarak görevinin doğasına bak:

| Görev Tipi | Birincil Collection | Yedek Collection |
|------------|-------------------|------------------|
| Yeni feature geliştirme | `tech-docs` + `product-specs` | `ops-runbooks` |
| Bug fix / hata çözümü | `tech-docs` | `ops-runbooks` |
| Deployment / altyapı | `ops-runbooks` | `tech-docs` |
| Pazarlama / kampanya | `content-library` | `market-intel` |
| Strateji / karar alma | `company-knowledge` | `market-intel` |
| Rakip / pazar araştırması | `market-intel` | `company-knowledge` |
| İçerik üretimi | `content-library` | `product-specs` |
| SEO / keyword araştırması | `content-library` | `tech-docs` |
| Ürün roadmap / spec | `product-specs` | `company-knowledge` |
| Güvenlik / CVE | `ops-runbooks` + `tech-docs` | — |
| Müşteri desteği / FAQ | `company-knowledge` | `product-specs` |

**Emin değilsen:** Birden fazla collection'da ara. Maliyet düşük, yanlış yerde aramak = "bilgi yok" varsayımı.

## Collection Rehberi (Detaylı)

### `company-knowledge` — Stratejik kararlar
CEO/Board kararları, bütçe, organizasyon değişiklikleri, politikalar, FAQ'lar.
```bash
# Örnek sorgular:
python3 ~/.hermes/skills/knowledge-hub/search.py "bütçe kararı Q2" "company-knowledge"
python3 ~/.hermes/skills/knowledge-hub/search.py "yeni agent işe alım politikası" "company-knowledge"
python3 ~/.hermes/skills/knowledge-hub/search.py "müşteri şikayeti pattern" "company-knowledge"
```

### `tech-docs` — Teknik dokümantasyon
Mimari kararlar, API değişiklikleri, DB şema değişiklikleri, bug fix root cause, code convention'lar, test stratejileri.
```bash
# Örnek sorgular:
python3 ~/.hermes/skills/knowledge-hub/search.py "authentication middleware" "tech-docs"
python3 ~/.hermes/skills/knowledge-hub/search.py "database migration prosedürü" "tech-docs"
python3 ~/.hermes/skills/knowledge-hub/search.py "React component best practice" "tech-docs"
```

### `market-intel` — Pazar istihbaratı
Rakip analizleri, trend raporları, pazar boşlukları, Mimir brief'leri.
```bash
# Örnek sorgular:
python3 ~/.hermes/skills/knowledge-hub/search.py "rakip ürün karşılaştırma" "market-intel"
python3 ~/.hermes/skills/knowledge-hub/search.py "AI agent market trend 2026" "market-intel"
python3 ~/.hermes/skills/knowledge-hub/search.py "fiyatlandırma stratejisi" "market-intel"
```

### `product-specs` — Ürün spesifikasyonları
Feature spec'ler, roadmap, PRD'ler, user feedback, UX araştırma sonuçları.
```bash
# Örnek sorgular:
python3 ~/.hermes/skills/knowledge-hub/search.py "dashboard feature spec" "product-specs"
python3 ~/.hermes/skills/knowledge-hub/search.py "kullanıcı onboarding akışı" "product-specs"
python3 ~/.hermes/skills/knowledge-hub/search.py "API endpoint tasarım kararı" "product-specs"
```

### `ops-runbooks` — Operasyon kılavuzları
Deployment prosedürleri, incident post-mortem'ler, sistem konfigürasyonları, güvenlik bulguları.
```bash
# Örnek sorgular:
python3 ~/.hermes/skills/knowledge-hub/search.py "deployment rollback prosedürü" "ops-runbooks"
python3 ~/.hermes/skills/knowledge-hub/search.py "SSL sertifika yenileme" "ops-runbooks"
python3 ~/.hermes/skills/knowledge-hub/search.py "incident post-mortem" "ops-runbooks"
```

### `content-library` — İçerik kütüphanesi
Kampanya sonuçları, SEO verileri, sosyal medya performansı, brand guide, tone of voice kararları.
```bash
# Örnek sorgular:
python3 ~/.hermes/skills/knowledge-hub/search.py "Instagram engagement oranları" "content-library"
python3 ~/.hermes/skills/knowledge-hub/search.py "blog SEO keyword performans" "content-library"
python3 ~/.hermes/skills/knowledge-hub/search.py "brand tone of voice" "content-library"
```

## Skor Rehberi

Arama sonuçlarında `score` alanı sonucun ne kadar ilgili olduğunu gösterir:

| Skor | Anlam | Aksiyon |
|------|-------|---------|
| **> 0.6** | Yüksek eşleşme | Doğrudan kullan |
| **0.3 — 0.6** | İlişkili | Oku, ilgili olup olmadığını değerlendir |
| **< 0.3** | Düşük ilgi | Muhtemelen alakasız, farklı sorgu veya collection dene |

Sonuç boş dönerse → farklı kelimelerle tekrar ara veya başka collection'da dene.

## Collection Yönetimi

Mevcut collection'lar bilgi ihtiyacını karşılamıyorsa yeni collection oluşturabilirsin.

### Adım 1 — Mevcut collection'ları kontrol et
```bash
python3 ~/.hermes/skills/knowledge-hub/collections.py list
```

### Adım 2 — Karar ver: Mevcut mi, yeni mi?
Kaydetmek istediğin bilgiyi mevcut collection'larla karşılaştır:
- Bilgi mevcut bir collection'ın kapsamına giriyorsa → o collection'a yaz
- Bilgi hiçbir mevcut collection'a uymuyorsa → yeni collection oluştur

**Yeni collection oluşturma kriterleri:**
- Tekrarlayan bir bilgi kategorisi olmalı (tek seferlik bilgi için yeni collection açma)
- İsim kısa, anlamlı ve İngilizce olmalı (kebab-case: `agent-logs`, `customer-feedback` gibi)

### Adım 3 — Yeni collection oluştur
```bash
python3 ~/.hermes/skills/knowledge-hub/collections.py create yeni-collection-ismi
```

### Adım 4 — Collection detaylarını gör
```bash
python3 ~/.hermes/skills/knowledge-hub/collections.py info collection-ismi
```

## Bilgi Ekleme (Ingest)

```bash
python3 ~/.hermes/skills/knowledge-hub/ingest.py "collection-adı" "PREFIX: metin" "kaynak-adı"
```

### Kayıt Formatı Standardı

Tutarlı ve aranabilir veri için şu format'ı kullan:

```
[TARİH] [TİP]: Başlık — Detay ve bağlam
```

**Tip etiketleri:**
- `KARAR:` — Alınan stratejik/teknik karar
- `BİLGİ:` — Öğrenilen bilgi, bulgu
- `OLAY:` — Incident, değişiklik, milestone
- `SONUÇ:` — Kampanya/test/analiz sonucu
- `SPEC:` — Feature spec, API tanımı

**Örnekler:**
```bash
# Doğru — yapılandırılmış, aranabilir
python3 ~/.hermes/skills/knowledge-hub/ingest.py "tech-docs" "2026-04-06 KARAR: Auth middleware JWT'den session-based'e geçiş — Compliance gereksinimleri nedeniyle. Tüm API endpoint'leri etkilenecek." "thor-cto"

# Doğru — sonuç verisi
python3 ~/.hermes/skills/knowledge-hub/ingest.py "content-library" "2026-04-06 SONUÇ: Instagram Reel kampanyası — 45K görüntülenme, %3.2 engagement, en iyi saat 19:00-21:00" "loki-social"

# YANLIŞ — yapılandırılmamış, aranamaz
python3 ~/.hermes/skills/knowledge-hub/ingest.py "tech-docs" "bugün auth'u değiştirdik" "thor"
```

## Kurallar
1. Her önemli karar, brief veya doküman knowledge hub'a eklenmelidir.
2. Kayıt yaparken tarih + tip etiketi + bağlam ZORUNLU.
3. Mimir market brief yazdığında → `market-intel`'e ekle.
4. Odin karar aldığında → `company-knowledge`'a ekle.
5. Aynı bilgiyi tekrar ekleme — önce search yap, varsa ekleme.
