Skip to content
Back to search

llm-wiki

SkillWorks with Claude CodeGitHub

LLM tarafından sürekli inşa edilen ve güncellenen kalıcı, birikimli bir bilgi arşivi (persistent wiki) deseni. Standart RAG'ın aksine her sorguda bilgi yeniden keşfedilmez — ajan yeni kaynakları okur, mevcut wiki'ye entegre eder, varlık/kavram sayfalarını günceller, çelişkileri işaretler, çapraz-referansları korur. Herhangi bir alan için kullanılır: araştırma, kitap okuma, ürün geliştirme, takım bilgisi, kişisel gelişim, rekabet analizi, ders notları. Obsidian + LLM ajanı (Claude Code, Codex, vb.) ile çalışır. Kullanıcı kaynakları bulur, ajan tüm bookkeeping'i yapar.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/selmakcby--knowledge-pipeline/badge.svg)](/listings/selmakcby--knowledge-pipeline)

HTML

<a href="/listings/selmakcby--knowledge-pipeline"><img src="/api/listings/selmakcby--knowledge-pipeline/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 190 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: llm-wiki
  3. description: LLM tarafından sürekli inşa edilen ve güncellenen kalıcı, birikimli bir bilgi arşivi (persistent wiki) deseni. Standart RAG'ın aksine her sorguda bilgi yeniden keşfedilmez — ajan yeni kaynakları okur, mevcut wiki'ye entegre eder, varlık/kavram sayfalarını günceller, çelişkileri işaretler, çapraz-referansları korur. Herhangi bir alan için kullanılır: araştırma, kitap okuma, ürün geliştirme, takım bilgisi, kişisel gelişim, rekabet analizi, ders notları. Obsidian + LLM ajanı (Claude Code, Codex, vb.) ile çalışır. Kullanıcı kaynakları bulur, ajan tüm bookkeeping'i yapar.
  4. ---
  5. # LLM Wiki — Kalıcı Bilgi Arşivi Deseni
  6. ## Çekirdek fikir
  7. LLM'lerle belge çalışmanın standart yolu **RAG**'tir: belgeleri yüklersin, sorduğunda ilgili parçalar çekilir, cevap üretilir. Çalışır ama her sorguda bilgi sıfırdan yeniden keşfedilir. Hiçbir şey birikmez. İncelikli bir soru sorduğunda — beş kaynağı sentezlemen gereken bir soru — LLM her seferinde parçaları yeniden bulup birleştirmek zorunda kalır.
  8. Bu skill **farklı bir yaklaşım** uygular. Ham kaynaklardan sorgu zamanında çekmek yerine, LLM seninle ham kaynaklar arasında **kalıcı bir wiki**'yi artımlı olarak inşa eder ve bakımını yapar. Yeni bir kaynak eklediğinde ajan onu sadece indekslemez — okur, çıkarımları konuşur, mevcut wiki'ye entegre eder, varlık sayfalarını günceller, yeni veri eski iddialarla çeliştiğinde işaretler, sentezi güçlendirir.
  9. **Kritik fark**: wiki, derlenmiş ve güncel tutulan **kalıcı, birikimli bir artefakt**tır. Çapraz-referanslar zaten oradadır. Çelişkiler zaten işaretlenmiştir. Sentez, okuduğun her şeyi zaten yansıtır. Her yeni kaynak ve her yeni soruyla wiki daha da zenginleşir.
  10. ## Rol dağılımı
  11. | Sen | LLM |
  12. |---|---|
  13. | Kaynakları bulur ve toplar | Okur, özetler, dosyalar |
  14. | Hangi soruları soracağını belirler | Çapraz-referansları korur |
  15. | Analizi yönlendirir | Çelişkileri işaretler |
  16. | Sonuçları okur, eleştirel düşünür | Bookkeeping (asla unutmaz, sıkılmaz) |
  17. | Şemayı evriltir | Şemaya uyar |
  18. Pratikte: bir tarafta Obsidian açık, diğer tarafta LLM ajanı. Sen sohbet ederken o vault'u düzenler, sen Obsidian'da graph view ile sonuçları takip edersin. **Obsidian = IDE, LLM = programmer, wiki = kod tabanı.**
  19. ## Üç katman mimari
  20. ### 1. Ham kaynaklar (`raw/`)
  21. Makaleler, PDF'ler, podcast notları, toplantı transkriptleri, resimler, veri dosyaları, JSONL transkriptleri. **Asla değiştirilmez.** Ajan sadece okur, yazmaz. Gerçeğin kaynağı budur.
  22. ### 2. Wiki (vault root)
  23. LLM'in tamamen sahiplendiği markdown dosyaları. Özetler, varlık sayfaları, kavram sayfaları, karşılaştırmalar, kararlar, sentez. Sayfalar `[[bağlantı]]`larla birbirine bağlanır. LLM bu katmanı tamamen yönetir — sayfa oluşturur, günceller, çapraz-referansları tutarlı tutar. Sen okursun, LLM yazar.
  24. ### 3. Şema (`CLAUDE.md` veya `AGENTS.md`)
  25. Ajana wiki'nin nasıl yapılandırıldığını, hangi konvansiyonlara uyacağını, her operasyonda hangi iş akışını izleyeceğini söyleyen doküman. **En kritik dosya budur** — ajanı disiplinli bir wiki bakımcısına dönüştürür, genel amaçlı bir chatbot olmaktan çıkarır. Sen ve ajan birlikte zamanla evriltirsiniz.
  26. ## Üç operasyon
  27. ### INGEST — kaynak emme
  28. Ham klasöre yeni bir kaynak koyarsın ve "bunu işle" dersin. Ajan adımları:
  29. 1. Kaynağı okur
  30. 2. Anahtar çıkarımları seninle tartışır
  31. 3. `sources/` altında bir özet sayfası yazar
  32. 4. `index.md`'yi günceller
  33. 5. İlgili `entities/` ve `concepts/` sayfalarını çapraz-günceller
  34. 6. Tutarsızlık varsa işaretler
  35. 7. `log.md`'ye zaman damgalı bir giriş ekler
  36. Tek bir kaynak 10-15 wiki sayfasına dokunabilir. **Tercih meselesi**: kaynakları tek tek yakın gözetimle mi, yoksa toplu halde daha az gözetimle mi ingest edersin. İkisi de geçerli — şemana yaz.
  37. ### QUERY — sorgu
  38. Wiki'ye soru sorarsın. Ajan:
  39. 1. `index.md`'yi okur
  40. 2. İlgili sayfaları bulur ve içlerini okur
  41. 3. Cevabı sentezler — cümle, tablo, slayt, grafik, canvas, ne uygunsa
  42. 4. Cevapta her iddia için kaynak referansı verir
  43. **Kritik içgörü**: İyi cevaplar wiki'ye **yeni sayfa olarak geri dosyalanır**. İstediğin bir karşılaştırma, keşfettiğin bir bağlantı, yaptığın bir analiz — bunlar değerlidir ve sohbet geçmişinde kaybolmamalı. Böylece keşiflerin de bilgi birikimini büyütür, tıpkı ham kaynaklar gibi.
  44. ### LINT — sağlık kontrolü
  45. Periyodik olarak ajana wiki sağlık kontrolü yaptırırsın. Kontrol edilenler:
  46. - Sayfalar arası **çelişkiler**
  47. - Yeni kaynaklarla geçersiz kalmış **stale claim**'ler
  48. - Hiçbir yerden link almayan **orphan** sayfalar
  49. - Wiki'de geçen ama kendi sayfası olmayan kavramlar
  50. - Eksik veya tek yönlü çapraz-referanslar
  51. - Web araması ile doldurulabilecek **veri boşlukları**
  52. LLM bu pass sırasında **araştırılacak yeni sorular ve yeni kaynaklar da önerir**. Wiki'yi büyürken sağlıklı tutar.
  53. ## index.md ve log.md
  54. Wiki büyüdükçe iki özel dosya hayati hale gelir.
  55. ### `index.md` — içerik odaklı
  56. Wiki'deki her şeyin kataloğu. Her sayfa için: link, tek satır özet, opsiyonel metadata (tarih, kaynak sayısı, durum). Kategoriye göre organize: varlıklar, kavramlar, kaynaklar, kararlar. Ajan **her ingest'te günceller**. Sorgu zamanında ajan önce index'i okur, sonra ilgili sayfalara iner.
  57. **Önemli**: orta ölçekte (~100 kaynak, ~birkaç yüz sayfa) bu yaklaşım embedding tabanlı RAG altyapısına olan ihtiyacı **ortadan kaldırır**. Büyürse `qmd` gibi yerel arama motorları eklenebilir.
  58. ### `log.md` — zamansal
  59. Append-only olay kaydı. Her ingest, query (özellikle filed-back olanlar) ve lint pass buraya zaman damgalı yazılır.
  60. **İpucu**: Her giriş tutarlı bir prefix ile başlasın:
  61. ```
  62. ## [2026-04-13] ingest | Makale Başlığı
  63. ## [2026-04-13] query | "X nasıl çalışıyor?" → filed: comparisons/x-vs-y.md
  64. ## [2026-04-14] lint | 3 stale claim, 2 orphan
  65. ```
  66. Böylece basit unix araçlarıyla parse edilir:
  67. ```bash
  68. grep "^## \[" log.md | tail -10
  69. ```
  70. ## Örnek vault yapısı
  71. ```
  72. vault/
  73. ├── CLAUDE.md # şema (anayasa)
  74. ├── index.md # içerik kataloğu
  75. ├── log.md # zamansal kayıt
  76. ├── raw/ # ham kaynaklar (DOKUNULMAZ)
  77. │ ├── articles/
  78. │ ├── papers/
  79. │ ├── transcripts/
  80. │ └── assets/ # resimler, PDF'ler
  81. ├── sources/ # her ham kaynak için bir özet sayfası
  82. ├── entities/ # kişiler, ürünler, yerler, organizasyonlar
  83. ├── concepts/ # soyut kavramlar, terimler, fikirler
  84. ├── decisions/ # kararlar ve gerekçeleri
  85. └── syntheses/ # üst düzey sentez sayfaları
  86. ```
  87. Bu yapı **zorunlu değil**. Alanına göre uyarlanır:
  88. - **Kişisel günlük**: `entries/`, `themes/`, `people/`
  89. - **Kitap okuma**: `chapters/`, `characters/`, `themes/`, `quotes/`
  90. - **Araştırma**: `papers/`, `theories/`, `methods/`, `experiments/`
  91. - **Ürün**: `features/`, `bugs/`, `decisions/`, `users/`
  92. ## Kullanım alanları
  93. - **Kişisel**: hedefler, sağlık, psikoloji, öz gelişim. Günlük girişleri, makaleler, podcast notları → zamanla kendin hakkında yapılandırılmış bir resim.
  94. - **Araştırma**: bir konuda haftalar veya aylar boyunca derinlemesine — makaleler, raporlar, evrilen bir tez.
  95. - **Kitap okuma**: bölüm bölüm dosyala, sonunda kişisel bir Tolkien Gateway. Karakterler, temalar, olay örgüsü, bağlantılar.
  96. - **İş / takım**: Slack thread'leri, toplantı transkriptleri, müşteri görüşmeleri. LLM bakımı yapar, takımda kimsenin yapmak istemediği bookkeeping'i halleder.
  97. - **Rekabet analizi, due diligence, seyahat planlama, ders notları, hobi araştırması** — zamanla bilgi biriktirmek istediğin her şey.
  98. ## Şema dosyası (CLAUDE.md) nasıl yazılır
  99. Şema dosyası wiki'nin **anayasasıdır**. En az şunları içermeli:
  100. 1. **Amaç**: Bu wiki hangi alanda? Hangi sorulara cevap arıyor?
  101. 2. **Klasör yapısı**: Her klasörün ne içerdiği ve ne içermediği.
  102. 3. **Sayfa formatı**: Frontmatter alanları (tags, source, date, status), başlık sırası, link konvansiyonları.
  103. 4. **Naming convention**: Sayfa isimleri kebab-case mi snake_case mi? Varlık isimleri nasıl kanonikleştirilir?
  104. 5. **Ingest workflow**: Yeni kaynak geldiğinde adım adım ne yapılır, hangi sayfalar otomatik güncellenir.
  105. 6. **Query workflow**: Soru geldiğinde önce hangi dosyalar okunur? Cevap nereye filed-back olur?
  106. 7. **Lint workflow**: Hangi sağlık kontrolleri ne sıklıkta? Ne otomatik düzeltilir, ne sadece raporlanır?
  107. 8. **Yasaklar**: Ajanın **asla** yapmaması gerekenler — `raw/`'a yazmak, kaynaksız iddia yaratmak, mevcut linkleri çözmeden kullanmak, sayfa silmek (sadece archive).
  108. 9. **Evrim notu**: Bu şema zamanla değişir — değişiklik geldiğinde önceki sayfalara nasıl uyarlanır.
  109. ## Pratik ipuçları
  110. - **Obsidian Web Clipper**: Tarayıcı eklentisi, web sayfalarını markdown'a çevirir → `raw/articles/`'a koy → ajana ingest ettir.
  111. - **Resimleri yerele indir**: Obsidian Settings → Files & links → "Attachment folder" = `raw/assets/`. Hotkey ata ("Download attachments for current file"). LLM sonra resimlere de bakabilir.
  112. - **Graph view**: Obsidian'ın en değerli özelliği. Wiki'nin şeklini görsel olarak görürsün — hub'lar, yetim sayfalar, kümeler. Sağlık kontrolü için vazgeçilmez.
  113. - **Marp plugin**: Wiki sayfalarından doğrudan slayt deck'i üret. Sunum için.
  114. - **Dataview plugin**: Frontmatter üzerinde sorgu çalıştır. Dinamik tablolar, listeler.
  115. - **Git**: Wiki bir git repo. Versiyon tarihi, branch'leme, çakışmasız işbirliği bedava.
  116. - **Arama**: `index.md` orta ölçekte yeter. Büyürse `qmd` gibi yerel BM25+vektör arama motorları eklenebilir.
  117. ## Neden çalışır
  118. Bir bilgi arşivi yönetmenin zor kısmı okumak ya da düşünmek değildir — **bookkeeping**'tir. Çapraz-referansları güncellemek, özetleri taze tutmak, çelişkileri yakalamak, onlarca sayfa arasında tutarlılık korumak. İnsanlar wiki'leri terk eder çünkü **bakım yükü değerden hızlı büyür**. LLM'ler sıkılmaz, bir referansı güncellemeyi unutmaz, tek bir pass'te 15 dosyaya dokunabilir. **Wiki bakımlı kalır çünkü bakımın maliyeti neredeyse sıfırdır.**
  119. Senin işin: kaynak bulmak, analizi yönlendirmek, iyi sorular sormak, ne anlama geldiğini düşünmek. LLM'in işi: diğer her şey.
  120. Bu desen ruhen Vannevar Bush'un 1945'teki **Memex** vizyonuna yakındır — kişisel, aktif olarak küratörlenmiş bilgi deposu, belgeler arasında çağrışımsal izler. Bush'un çözemediği tek şey kimin bakım yapacağıydı. LLM o kısmı halleder.
  121. ## Hard rules
  122. 1. **`raw/` immutable.** Ajan sadece okur, asla yazmaz/değiştirmez. Sadece kullanıcı ekler.
  123. 2. **Her iddia kaynaklı.** Wiki'deki her önemli cümle, hangi raw dosyadan geldiğini belirtir. Kaynaksız iddia yasaktır.
  124. 3. **Çelişki silinmez, işaretlenir.** "Kaynak A şunu derken, kaynak B bunu diyor" → görünür yere yazılır, ileride çözülür.
  125. 4. **Çift-yönlü bağlantı düşüncesi.** Bir sayfayı güncellerken ona link veren diğer sayfaları kontrol et.
  126. 5. **Her operasyon log'lanır.** Ingest, anlamlı query'ler ve lint pass'leri zaman damgalı `log.md`'ye gider.
  127. 6. **Schema co-evolves.** Bir kural çalışmıyorsa şemayı güncelle. Sonraki oturumlarda yeni kurallar geçerli olur.
  128. 7. **Filed-back her şey atomic olur.** Bir query cevabını wiki'ye dosyalarken, sentez tek bir "session özeti" değil ayrık atomik sayfalardır (her biri tek bir fikir).
  129. 8. **Sayfa silinmez, archive edilir.** Stale veya hatalı sayfa önce `archive/` altına taşınır, sonra index güncellenir. Tarih korunur.
  130. ## İlk çalıştırma adımları
  131. Yeni bir vault için ajana şunları söyle:
  132. 1. Klasör yapısını kur (`raw/`, `sources/`, `entities/`, `concepts/`, `decisions/`)
  133. 2. `index.md` ve `log.md` iskelet dosyalarını oluştur
  134. 3. `CLAUDE.md`'yi bu skill'i temel alarak yaz — alana özgü bölümleri ekle (amaç, naming, ingest workflow özellikleri)
  135. 4. Vault'u Obsidian ile aç, graph view'i kontrol et
  136. 5. İlk kaynağı `raw/` içine koy, ajana "ingest et" de
  137. 6. Sonucu Obsidian'da gez, sayfa formatını ve naming'i beğenmediysen şemayı güncelle, tekrar çalıştır
  138. Ondan sonra her yeni kaynakla wiki organik olarak büyür.
  139. ---
  140. **Bu skill alan-bağımsızdır.** vibeapp gibi bir yazılım projesi, bir doktora tezi, bir kitap kulübü, kişisel bir gelişim günlüğü, bir startup'ın takım wiki'si — hepsi için aynı pattern uygulanır. Sadece şema dosyası alana özgü olur.
README.md · README · 49 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Knowledge Pipeline
  2. > Türkçe sunum + LLM-Wiki skill'i. Ham sohbetleri, bir şemayla disipline edilen, aranabilir ve büyüyen bir wiki'ye dönüştürme deseni.
  3. ## İçerik
  4. - **[index.html](./index.html)** — Terminal/matrix estetiğiyle tek dosyalık sunum. 8 sahne, SPACE ile sahne sahne ilerler. YouTube videoları için hazır.
  5. - **[SKILL.md](./SKILL.md)** — `llm-wiki` skill'i. Claude Code veya başka bir LLM ajanıyla kalıcı, birikimli bir bilgi arşivi inşa etmek için genel-amaçlı desen.
  6. - **[PROMPTS.md](./PROMPTS.md)** — Üç hazır prompt (INGEST / QUERY / LINT). Placeholder'larla configurable. Kopyala-yapıştır hazır.
  7. - **[CLAUDE.md](./CLAUDE.md)** — Vault anayasası şablonu. Şema dosyasının kopyala-uyarla hazır örneği: katmanlar, sayfa formatı, workflow'lar, yasaklar.
  8. ## Sunumu aç
  9. Canlı versiyon (GitHub Pages):
  10. ```
  11. https://selmakcby.github.io/knowledge-pipeline/
  12. ```
  13. Lokalde:
  14. ```bash
  15. open index.html
  16. ```
  17. Kontroller: `SPACE` / `CLICK` ile ilerlet · `R` ile sıfırla · `←` ile geri al
  18. ## Skill'i kullanma
  19. `SKILL.md`'yi LLM ajanına göster (Claude Code, Codex, vb.) ve "bu desen'e göre bana bir vault kur" de. Ajan klasör yapısını, `CLAUDE.md` şemasını, `index.md` ve `log.md` iskeletini üretir. Şemanın hazır bir örneği için bu repodaki [CLAUDE.md](./CLAUDE.md) şablonunu kopyalayıp uyarlayabilirsin.
  20. Alan-bağımsız: araştırma, kitap okuma, ürün geliştirme, kişisel gelişim, takım wiki'si — hepsi için aynı pattern.
  21. ## Desen özeti
  22. ```
  23. RAW (immutable) → WIKI (LLM writes) ← SCHEMA (disciplines)
  24. ↓ ↓ ↓
  25. ham kaynaklar markdown graf anayasa dosyası
  26. ```
  27. Üç operasyon:
  28. - **INGEST** — yeni kaynak geldiğinde wiki'ye entegre et, çapraz-referansları güncelle
  29. - **QUERY** — soruları wiki üzerinden cevapla, iyi cevapları yeni sayfa olarak geri-dosyala
  30. - **LINT** — periyodik sağlık kontrolü: çelişkiler, orphan'lar, eksik bağlantılar
  31. Daha fazla detay için [SKILL.md](./SKILL.md)'ye bak.
  32. ## Lisans
  33. MIT. İstediğin gibi kullan, değiştir, paylaş.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.