WUPHF: AI Ajanları Kendi Wikisini Yazıyor - Markdown ve Git ile

Yine Bir Başarısızlık Hikayeleri Devri mi?

Şu sektördeki trend şu: Bir problem çıkıyor, hemen Postgres'e vektör ekleniyor. Sonra Neo4j geliyor. Ardından Kafka, Redis, ve tamamen yeni bir dashboard ekran yapısı. Sonuç? Sistem ağırlaşıyor, yazılım mühendisleri sadece altyapı bakıyor, AI ajanları hemen kaybolup gidiyor.

Işte WUPHF geliştirici buna bakıp "Yok canım, çok karışık" dedi. Ve basit bir çözümü uygulamaya koydu - Andrej Karpathy'nin sürekli bahsettiği konsepti, çoktan uygulandığı gibi değil, temel prensiplerine geri dönerek.

Markdown ve Git - Yeterli mi?

Acikcasi, bu kadar basit bir yapının işleyeceğini tahmin etmek zor. Ama hesaplar tutmuş.

Sistem şöyle çalışıyor: Her AI ajanı kendi özel not defterine (agents/{slug}/notebook.md) yazıyor. Bu tamamen özel. Paylaşılan bilgiler ise ekip wikisine (team/) gidiyor - ama atıştıkça değil, denetim aşamasından geçerek. Bir taslak yazar, insan veya başka bir ajan bunu inceler, eğer uygunsa, daha kalıcı wikiye terfi eder.

Bu "taslak-to-wiki promosyon akışı" denen şey aslında çok zekice tasarlanmış - bir durum makinesi yönetiyor, otomatik arşivleme yapıyor, bağlantıları takip ediyor.

Arama İşlemi: Yüksek Sesle Hızlı

Bilgi saklı kaldığı sürece hiçbir anlam taşımaz. WUPHF burada Bleve isimli bir arama kütüphanesi kullanıyor - BM25 algoritmasını içeriyor (bilgi getirme dünyasının klasik yöntemi). Basit sorgular doğrudan buraya gidiyor.

Benchmark sonuçları: 500 yapı, 50 sorgu üzerinden %85'lik başarı oranı. Ama dikkat - bu sistem henüz vektör veritabanını kullanmıyor. SQLite kullaniyor sadece. Eğer arama kalitesi düşerse, sqlite-vec adlı bir fallback hazırlanmış durumda.

Aslina bakarsan, bu çok akıllıca bir karar: "Basit şeyi ne zaman karmaşık yapacağımızı biliyor musun? Kesinlikle ihtiyaç duyduğumuzda."

Gerçek İnsan Açısından: Verilerin Sahibi Kim?

Bence işte bu özel taraf: Wiki, bilgisayarındaki ~/.wuphf/wiki/ klasöründe yaşıyor. Yani tamamen sana ait. Bir gün aklına eserse git clone komutu ile tüm bilgini başka bir yere taşıyabilirsin. Bulut hizmetlerine mahkûm değilsin.

Sistem MIT lisansı ile açık kaynak, kendini barındırıyorsun, kendi anahtarlarını sağlıyorsun. Obsidian kötü mü? Hayır. Ama bu, ajanlarla birlikte çalışması için tasarlanmış.

Bilgi Çıktısı: "Pam the Archivist" Sistemi

Burada en ilginç taraf: Her gerçek ekleme için, sistem Pam adında bir git kimliğini kullanıyor. Neden? Çünkü sonra git log'a bakıp "bu bilgiyi kim ekledi, ne zaman" diye sormak istiyorsun. Provenance değişimini görmek için.

Yapılar için de benzer işlem: Append-only JSONL dosyaları (yani sadece ekleme yapılıyor, silme yok) depo ediliyor. Her N gerçekten sonra, bir sentez işçisi tüm bilgiyi toparlar ve özet bir form oluşturur.

Wikilink'ler ([[bu gibi]]) ve kırık bağlantı tespiti de var. GÜnlük bir lint kontrolü çelişkileri, eski girdileri, kopmuş bağlantıları tarıyor.

Sınırlandırma: Gerçekçi Şekilde

Geliştirici burada samimi: %85 başarı oranı "evrensel garanti" değil. Sadece bu test serisinde çalıştı. Kalite, ajanların ne kadar iyi gözlem yaptığına bağlı - galibiyet, garbaj giriş garbajdır, çıkış da. Sistemin hüküm verici olmadığını da vurguluyor.

Şu anda tek ofis için çalışıyor, ofisler arası federasyon yok - yani birden fazla ekibi birleştirmek henüz mümkün değil.

Teknik Derinlik: /lookup ve MCP Araçlar

Ajanlar başka ajanları çağırabiliyor veya insan arayüzü üzerinden /lookup slash komutunu kullanabiliyor. Kısa sorgular BM25'e gidiyor, detaylı hikaye sorguları ise bir "alıntılı cevap döngüsü" üzerinden işleniyor.

MCP (Model Context Protocol) araçları ile entegrasyon da yaşanan - yani Claude ve benzer ajanlar direkt bu wikiyi çağırabiliyor.

Kurulum ve Demo

Yüklemek çocuk oyuncağı: npx wuphf@latest. WUPHF'ın tamamını kullanmak zorunda değilsin, sadece wiki katmanını da ekleyebilirsin. Zaten var olan ajan kurulumunun üzerine bağlayabilirsin.

Demo için 5 dakikalık bir terminal kaydı var - Asciinema'da - beş gerçek ekleniyor, sentez çalıştırılıyor, LLM CLI'ına gönderiliyor, sonra git altında Pam'in kimliği ile commit ediliyor. ./scripts/demo-entity-synthesis.sh'de bulunuyor.

Bir Örnek Senaryo

Düşün ki Claude Code uygulaması üzerinde çalışırken bir API entegrasyonunu keşfediyor. Bunu kendi notebook'una yazıyor. Ertesi gün başka bir ajan bu notu görüyor, "Bu ekip için önemli" diye karar veriyor, wikiye promove ediyor - bu sefer kalıcı bir sayfa haline geliyor, yalınızda ön link koparıyor. Diğer ajanlar onu bulabiliyor. Hafta sonra, bir üçüncü ajan benzer bir sorguya soruyor - sistem wikiyi arıyor, işte bu entegrasyonun adresini bulup vermesi 85 olasılıkla çalışıyor.

Konteks durmaktan çıkıyor. Bilgi oturum arası birikmesi başlıyor.

Şu Obsidian Vault Sorusu

Açıkçası, bir Obsidian kasasına eklenti yazıp aynı şeyi başaramaz mısın? Evet yapabilirsin. Ama WUPHF, ajanlar için inşa edilmiş - Git revizyon kontrol, append-only fact logs, otomatik promosyon akışları, synthesis işçileri. Obsidian daha çok insan kullanıcı için tasarlanmış.

Neden Şimdi?

Karpathy'nin LLM-native bilgi altyapısı konsepti bir süredir konuşuluyor, ama çoğu implementasyon kompleks ağırlıyor. Bu, basit, hafif, fakat işlevsel bir alternatif. Open source, self-hosted, MIT license. Demir tavında dovuluyordu, işte sonuç.

Sık Sorulan Sorular

Kurulum ne kadar uzun sürer?

Beş dakika. npx wuphf@latest ve özellikle zaten bir ajan kurulumun varsa, WUPHF directiğini işaret et. Eklentisi otomatik olarak aktive oluyor.

Büyük veri setlerinde BM25 yeterli mi?

Bu, geliştirici tarafından açıkça belirtilmiş: %85 başarı oranı bu benchmark'te çalıştı, evrensel değil. Eğer sorgu kalitesi düşerse, sqlite-vec'e geçişin altyapısı hazır. Kırmızı hat bulundu, ama veri büyüdükçe tekrar değerlendirilecek.

Claude Code dışındaki ajanlarla çalışır mı?

Evet. Codex, OpenClaw, hatta OpenCode üzerinden lokal LLM'ler destekleniyor. WUPHF'ı bağla, herhangi bir ajan yapıştırabilirsin.

Özet: Bu proje, karmaşık altyapıyı atıp, basit düzencelerle ne kadar ileri gidebileceğini gösteriyor. Git, Markdown, SQLite, Bleve - hepsi mevcud teknoloji. Yani yeni çağ değil, akılca tasarım. İnsan bulunun, yazılım açık kaynak, MIT altında, self-hosted. Eğer AI ajanlarla çalışıyorsan ve bilginin birikmesini istiyorsan, bakılmaya değer.

Kaynak: Hacker News (Show HN)