---
name: GİSK İkincil Beyin Şeması
description: Bu Obsidian vault'unu yöneten LLM için işletim talimatları
---

# GİSK İkincil Beyin — Şema

Bu vault, **GİSK Yönetim Paneli** projesi etrafında biriken bilgiyi (modül kararları, iş kuralları, araştırmalar, kişisel notlar) tutan **kalıcı bir wiki**'dir. LLM Wiki paradigmasını izler: ham kaynaklar değişmez, türetilmiş wiki sayfaları LLM tarafından üretilir ve bakımı yapılır.

> **Önemli:** Vault sahibi (kullanıcı) sayfaları nadiren elle yazar. LLM olarak sen yazarsın, çapraz bağlarsın, çelişkileri işaretlersin. Kullanıcının işi: kaynak sağlamak, soru sormak, yön vermek.

## Üç Katman

1. **Ham kaynaklar** (`kaynaklar/`) — Kullanıcının yapıştırdığı makaleler, transkriptler, ekran görüntüleri, kod parçacıkları, toplantı notları. **Asla değiştirme.**
2. **Wiki** (`ozetler/`, `varliklar/`, `kavramlar/`, `kararlar/`, `sorgular/`) — Senin ürettiğin türetilmiş içerik. Her şey burada birikir.
3. **Navigasyon** (`index.md`, `log.md`) — Wiki'nin içindekiler tablosu ve kronolojik aktivite akışı.

## Klasör Yapısı

```
Gisk/
├── CLAUDE.md              ← bu dosya (şema)
├── index.md               ← içerik kataloğu (kategoriye göre)
├── log.md                 ← kronolojik aktivite günlüğü
├── kaynaklar/             ← ham kaynaklar (immutable)
├── ozetler/               ← her kaynak için bir özet sayfası
├── varliklar/             ← entity sayfaları (kişiler, modüller, tablolar, harici sistemler)
├── kavramlar/             ← iş kuralları, terimler, prensipler, formüller
├── kararlar/              ← mimari/iş kararları (ADR tarzı)
└── sorgular/              ← saklanmış sorgu/analiz sonuçları
```

## İş Akışları

### 1. Kaynak Aktarımı (Ingest)

Kullanıcı `kaynaklar/` altına bir dosya bıraktığında veya bir metin yapıştırdığında:

1. **Oku** — kaynağı tamamen oku, ana fikri ve önemli ayrıntıları çıkar.
2. **Konuş** — kullanıcıyla 2-3 cümlelik bir özet paylaş, neyi vurgulayacağını sor.
3. **Özetle** — `ozetler/{kaynak-adi}.md` dosyası oluştur. Frontmatter zorunlu (aşağıya bak).
4. **Entegre et** — wiki'deki ilgili `varliklar/`, `kavramlar/`, `kararlar/` sayfalarını güncelle. Yeni bir entity geçiyorsa sayfa aç. Eski bir iddiayla çelişiyorsa **çelişkiyi işaretle**, üzerine yazma.
5. **İndeksle** — `index.md`'ye yeni sayfaları ekle.
6. **Logla** — `log.md` dosyasına aşağıdaki formatla bir satır ekle:
   ```
   ## [YYYY-MM-DD] ingest | {kaynak başlığı}
   - Yeni: [[ozetler/...]]
   - Güncellendi: [[varliklar/...]], [[kavramlar/...]]
   - Notlar: ...
   ```

### 2. Sorgu (Query)

Kullanıcı bir soru sorduğunda:

1. **Önce indeksi oku** (`index.md`). Embedding/RAG yok — vault küçükken indeks yeterli.
2. İlgili görünen wiki sayfalarını oku (özet > entity > kavram > karar sırasıyla).
3. Sentezle, **alıntılar** ile yanıt ver. Her iddianın yanında [[wikilink]] olsun.
4. **Eğer yanıt yeni bir sentez içeriyorsa** → `sorgular/{tarih}-{başlık}.md` olarak dosyala. Sohbet kaybolur, wiki kalır.
5. `log.md` dosyasına `query` kaydı ekle.

### 3. Lint (Sağlık Kontrolü)

Kullanıcı `lint` veya "vault sağlığı" istediğinde:

- Çelişkili iddialar
- Eski/güncellenmemiş bilgiler
- Yetim sayfalar (kimse linklemiyor)
- Bahsedilip de sayfası olmayan kavramlar
- Eksik çapraz bağlar
- Doldurmaya değer bilgi boşlukları (web araması önerebilirsin)

Bul ve raporla. Kullanıcı onaylarsa düzelt.

## Sayfa Sözleşmeleri

### Frontmatter (her wiki sayfasında zorunlu)

```yaml
---
type: ozet | varlik | kavram | karar | sorgu
baslik: {başlık}
olusturuldu: YYYY-MM-DD
guncellendi: YYYY-MM-DD
kaynak: [[kaynaklar/...]] # sadece ozet için, türetildiği kaynağa link
etiketler: [proje/gisk, modul/aidat, ...]
---
```

### Bağlantı Kuralları

- Her wikilink `[[klasör/dosya]]` formatında. Obsidian otomatik çözer.
- Bir entity ilk kez geçtiğinde `varliklar/` altında sayfası açılır ve linklenir.
- Karşılıklı bağlama: A → B linklediyse B sayfasına da A geri-linki düşür.

### Adlandırma

- Türkçe, küçük harf, tireli: `varliklar/aidat-modulu.md`, `kavramlar/qr-yoklama-akisi.md`
- Tarih içeren dosyalar `YYYY-MM-DD-{slug}.md`
- Türkçe karakterler dosya adında **kullanılmaz** (slug'a çevir): "şehir" → "sehir"

### index.md Düzeni

Kategoriye göre bölümlendirilmiş, her satır `- [[link]] — bir cümle özet`. ~150 karakter sınırı. Yeni sayfa eklendikçe LLM günceller.

### log.md Düzeni

Append-only, ters kronolojik (en yenisi üstte). Her giriş:
```
## [YYYY-MM-DD] {ingest|query|lint|edit} | {kısa başlık}
- ...
```
`grep "^## \[" log.md | head -20` ile son 20 aktivite okunabilir — bu sözleşmeyi koru.

## Domain Bağlamı (önemli)

Bu vault **GİSK Yönetim Paneli** (Türkçe spor kulübü yönetim sistemi) projesi etrafında dönüyor. Aşağıdaki bağlam her zaman geçerli:

- Proje kök dizini: `C:\Project\giskpanel`
- Tech stack: PHP 7.0+ procedural, MariaDB/SQLite, Bootstrap 5.3.3, Obsidian + Claude Code
- Domain dili: Türkçe (oyuncular, antrenörler, aidat, kasa, devam, yoklama, vb.)
- Asıl kod CLAUDE.md: `C:\Project\giskpanel\CLAUDE.md` — kod konvansiyonları orada.

Kod hakkında konuşurken **her zaman** kod CLAUDE.md kurallarına uy (Türkçe identifier, prosedürel PHP, PDO, ob_start/sablon.php pattern'i).

## Yapma Listesi

- ❌ Ham kaynakları (`kaynaklar/`) **asla** düzenleme. Yalnız oku.
- ❌ Wiki sayfalarını silme — eskiyse "Eski" başlık altına taşı veya frontmatter'a `durum: arsiv` ekle.
- ❌ Çelişkiyi sessizce çözme — her iki kaynağı da aktar, ayrımı belirt.
- ❌ Çoklu kaynak özetini tek dosyada birleştirme — her kaynak kendi `ozetler/` sayfasına gider.
- ❌ Frontmatter'sız sayfa yazma.
- ❌ `index.md` veya `log.md`'yi atlama — her ingest/query bunlara dokunmalı.

## Yapılır Listesi

- ✅ Yeni bir konu ortaya çıktığında `kavramlar/` veya `varliklar/` sayfası aç.
- ✅ Sayfaları küçük tut (~200-400 satır), büyürse alt sayfalara böl.
- ✅ Cevaplarını [[wikilink]]'lerle desteklendir.
- ✅ Önemli sentezi `sorgular/` altına dosyala — sohbette kaybolmasın.
- ✅ Belirsizlikte kullanıcıya sor; varsayım yapma.
- ✅ Türkçe konuş, Türkçe yaz.
