fkare.dev

LLM (büyük dil modeli) tabanlı projelerde en büyük problemlerden biri, sürdürülebilir ve tekrar kullanılabilir bir bilgi tabanı oluşturmaktır. Her yeni projede aynı klasör yapısını kurmak, promptları yazmak ve sistemi baştan inşa etmek ciddi zaman kaybına yol açar.

Bu problemi çözmek için geliştirilen Wiki Builder, Claude Code ile entegre çalışan açık kaynaklı bir eklentidir. Amacı, LLM destekli wiki (bilgi tabanı) sistemlerinin kurulumunu otomatikleştirmek ve süreci standart hale getirmektir.

Wiki Builder Nedir?

Wiki Builder, Claude Code içerisine bir “skill” olarak eklenir ve yeni bir wiki oluşturma sürecini baştan sona otomatik hale getirir.

Eklenti kullanıldığında:

Gerekli klasör yapısı oluşturulur
Yapılandırma dosyaları hazırlanır
Temel prompt şablonları eklenir

Sistem, wiki.config.md dosyasını okuyarak nasıl davranacağını belirler. Böylece her wiki kendi kurallarına ve kullanım amacına göre şekillenir.

Desteklenen Wiki Türleri

Wiki Builder, farklı kullanım senaryolarına uygun çeşitli wiki türlerini destekler:

Research (araştırma)
Paper (makale)
Domain (alan bilgisi)
Product (ürün)
Person (kişi)
Organization (organizasyon)
Project (proje)

Bu yapı sayesinde aynı sistem farklı ihtiyaçlara kolayca uyarlanabilir.

Çalışma Mantığı

Wiki Builder’ın temel çalışma prensibi basit bir döngüye dayanır:

Ham veriler raw/ klasörüne eklenir
Agent bu verilerden wiki sayfaları üretir
Kullanıcı sorular sorar ve cevaplar wiki’ye eklenir
Sistem düzenli olarak bakım yapar:
- eksik sayfaları tespit eder
- bağlantıları kontrol eder
- işlenmemiş verileri belirler

Bu yaklaşımda eklenti, sistemi değiştirmez; sadece kurulum sürecini hızlandırır ve kolaylaştırır.

Örnek Kullanım Senaryosu

Makaledeki örnekte, “agentic engineering” konusu için bir research wiki oluşturuluyor.

Tek bir komutla sistem:

onlarca ipucu
şirket profilleri
makale özetleri
açık kaynak araç listeleri
forum içerikleri
zaman çizelgesi

gibi kapsamlı bir bilgi tabanı üretir.

Üretilen tüm içerikler kaynaklara bağlı şekilde tutulur ve doğrulanabilir yapıdadır.

Teknik Yapı

Wiki Builder üç ana bileşenden oluşur:

1. Script

Başlangıçta gerekli klasörleri ve dosyaları oluşturur.

2. Prompt Şablonları

Sayfa üretimi
İndeks oluşturma
Soru-cevap sistemi
Kalite kontrol süreçleri

3. SKILL.md

Claude’un nasıl davranacağını belirler.
Kalite standartlarını tanımlar ve tüm içeriklerin kaynaklara bağlı olmasını zorunlu kılar.

Klasör Yapısı

Örnek bir proje yapısı şu şekildedir:

wiki/
raw/
prompts/
logs/
sources.md

Bu yapı sabit değildir ve projeye göre esnetilebilir.

Kurulum ve Kullanım

Wiki Builder, Claude Code plugin marketplace üzerinden kurulabilir. Kurulumdan sonra aşağıdaki işlemler kolayca yapılabilir:

Yeni wiki oluşturma
İçerik ekleme
Otomatik sayfa üretimi

Neden Bu Yaklaşım?

Geleneksel LLM sistemleri genellikle:

embedding
vector database
RAG

gibi yapılar kullanır.

Wiki Builder ise daha basit bir yaklaşım benimser:

Markdown tabanlı wiki
Agent destekli içerik üretimi

Bu yaklaşımın avantajları:

Üretilen içerikler kalıcıdır
Bilgi tabanı zamanla büyür
Aynı bilgiler tekrar tekrar üretilmez
Uzun vadede maliyet düşer

Sonuç

Wiki Builder, LLM tabanlı bilgi tabanı oluşturma sürecini sadeleştirir ve hızlandırır. Tekrar eden kurulum işlemlerini ortadan kaldırarak geliştiricilerin doğrudan içerik üretimine odaklanmasını sağlar.

Açık kaynaklı olması sayesinde farklı projelere kolayca entegre edilebilir ve geliştirilebilir bir yapı sunar.

Wiki Builder: Claude Code Plugin ile LLM Bilgi Tabanı Oluşturma