CodeAlmanac - Yapay zeka kodlama ajanları için kod tabanı vikisi

• Yalnızca kodun taşıyamadığı kararlar, akışlar, değişmez koşullar, tuzakları (gotchas) kaydederek yapay zeka ajanlarına bağlam sağlayan yaşayan bir viki
  • Sistemin neden mevcut şeklinde olduğu, geçmişte nelerin bozulduğu, iş akışlarının dosya/hizmetler arasında nasıl yayıldığı kaydediliyor
• Viki, depo içindeki Markdown dosyaları olarak saklanıyor; yerelde indekslendikten sonra kod gibi Git üzerinde incelemeden geçirilebiliyor
• Ajanlar ve insanlar aynı yerel okuma komutlarını kullanıyor: search, show, topics, health, validate
  • search --mentions src/checkout/ ile dosya yolu tabanlı arama destekleniyor, --wiki <name> ile başka bir viki görüntülenebiliyor
• Vikiyi sürekli güncel tutan yaşam döngüsü işleri, üç açık ajan olan build / ingest / garden ile çalıştırılıyor
  • Ayrı olarak yayımlanan Yoke SDK kullanılıyor
  • ingest: dosyaları, dizinleri, Git diff'lerini, commit aralıklarını, GitHub PR/issue'larını, URL'leri ve yerel ajan transkriptlerini vikiye entegre eder
  • garden: eski sayfaları, zayıf bağlantıları, konuları ve yinelenen sayfaları temizler
• Bakım komutlarını hatırlamaya gerek kalmaması için yerel macOS launchd arka plan görevlerinin 3 türü sunuluyor
  • Sync (her 5 saatte bir): son Codex/Claude konuşmalarını tarar ve ilgili vikilere ingest işi olarak kuyruğa alır
  • Garden (her 24 saatte bir): kayıtlı tüm vikilerde eskiyen/yinelenen/zayıf bağlı bilgileri gözden geçirir
  • Update (her 24 saatte bir): CLI'yi yalnızca güvenli anlarda otomatik günceller, yaşam döngüsü işleri sürüyorsa atlar
• Barındırılan hizmet veya bulut senkronizasyonu değil, tamamen yerelde çalışır; loglar ~/.codealmanac/logs/ içinde saklanır
• Çalışma geçmişi yerel iş kayıtları olarak tutulur; bu sayede terminal kapatılsa bile görüntülenebilir
  • jobs, jobs show, jobs logs, jobs attach, jobs cancel
  • --json ile script entegrasyonu mümkündür
• Provider olarak tek giriş noktası almanac-yoke kullanılır; Codex için app-server, Claude için Python Agent SDK kullanılır
  • Mevcut Codex/Claude Code OAuth oturumları yeniden kullanılır
• serve ile açılan yerel görüntüleyici salt okunurdur; sayfa/arama/konu/backlink/dosya referansı gezinmesini render eder
• Yaşam döngüsü ajanları, geniş kapsamlı ve etkileşimsiz dosya sistemi izinleriyle çalışır
  • almanac/ klasörü bir OS sandbox'ı değil, yönerge/commit politikasıdır; bu nedenle yalnızca güvenilir depolarda çalıştırılmalıdır
• Telemetri isteğe bağlıdır. Kod/yol/prompt/transkript/kimlik bilgileri gönderilmez, GeoIP devre dışıdır ve DO_NOT_TRACK=1 ile de engellenebilir
• Apache-2.0 lisansı