oh-my-openagent-toolkit - Claude Code’dan başlayıp OpenCode/oh-my-openagent üzerinde yerleşik hale gelen yerel operasyon araç seti
(github.com/HanTechnology)Merhaba.
Claude Code’u yoğun kullandığım dönemden beri, yapay zeka kodlama ajanlarını projeye gerçekten entegre edip kullanınca, eninde sonunda kodun kendisinden çok “bu projede nasıl çalışılması gerektiğini” anlatan bir katmana ihtiyaç olduğunu hissettim.
Örneğin şöyle şeyler:
- Hangi isteğin nereye yönlendirilmesi gerektiği
- Hangi built-in helper’ın eklenmesinin doğru olduğu
- Şu anda güçlü biçimde söylenebilecek destek kapsamının nereye kadar uzandığı
- Yeni işlerin nerede oluşturulacağı ve mevcut projelerin nasıl ele alınacağı
- UI tarafındaki refinement çalışmalarının nereden başlayıp nasıl eklenmesi gerektiği
İlk başta Claude Code tarafında bunu kendi tarzıma göre sürekli iyileştiriyordum, sonra bir ara OpenCode tarafına taşımayı denedim; şimdi ise oh-my-openagent üzerinde karar kılıp bunu yerel projelerde daha tutarlı kullanılabilecek bir biçimde bir araya getirdim.
Bu kez bunu oh-my-openagent-toolkit adıyla yayımladım.
GitHub:
https://github.com/HanTechnology/oh-my-openagent-toolkit
Bu nedir?
Tek cümleyle,
OpenCode + oh-my-openagent üzerinde kullanılan project-local companion toolkit’tir.
Biraz daha somut söylersek,
upstream harness’ın yerini almak yerine onun üstüne eklenip yerel operasyon katmanını daha net hale getiren bir yapıya daha yakındır.
Bu repo’nun eklediği şeyler ağırlıklı olarak şunlardır.
- thin routing
- İsteklerin nereye gönderilmesi gerektiğini düzenler
- Hangi category / helper’ın uygun olduğu konusunda daha net yönlendirme sağlar
- skill surface
- .opencode/skills/ altında top-level entrypoint’leri düzenler
- Şu anda 43 entrypoint var; bunların 40’ı core surface, 3’ü ise planned adjacent pack
- support boundary
- validated / guided / planned ayrımını yapar
- Böylece “çalışıyor gibi görünüyor” ile “şu anda kamuya açık biçimde güçlü şekilde söyleyebileceğimiz şey”i ayırır
- workspace convention
- Repo root’tan nasıl okunacağı ve hangi temele göre çalışılacağı konusunu düzenler
- UI refinement layer
- impeccable ailesini yerelde bir araya getirir
- UI işi yapılırken primary route üzerine ek olarak bir refinement layer eklenebilmesini sağlar
Neden yapıldı?
Yapay zeka kodlama ajanlarını gerçek projelere bağladığınızda, bir noktada “ajan ne kadar zeki” olduğundan çok “bu proje içinde hangi kurallarla hareket etmesi gerektiği” daha önemli hale geliyor.
Özellikle birden fazla domain iç içe geçtiğinde bu daha da belirginleşiyor.
- frontend / backend / systems / data / security / QA
- Uygulama ile doğrulama arasındaki sınır
- Dokümantasyon ile gerçekten validated olan surface’in ayrımı
- Agent helper’ın ne zaman eklenip ne zaman eklenmeyeceği
Bunları her seferinde prompt içine uzun uzun yazmak ya da sadece insanların zihninde tutmak yerine,
projenin içinde ince bir operasyon katmanı olarak bırakmanın daha iyi olacağını düşündüm ve bunu bu yüzden yaptım.
Bu repo’nun yapmamayı hedeflediği şeyleri de açıkça yazdım.
Bu, aşağıdaki üç şey değildir.
- (X) oh-my-openagent’ın resmî upstream dağıtımı
- (X) harness’ın yerini alan yeni bir runtime
- (X) yerelde bir kontrol düzlemi daha
Yani bu, upstream’in üstüne eklenen bir companion toolkit’tir;
yeni bir framework daha yapma yönünde değildir.
Şu anda nereye kadar çalışıyor?
Burada da gereğinden fazla kısıt koymamaya çalıştım.
Bu repo şu anda broad skill surface’e sahip olsa da (genel geliştirme alanını kapsayan 43 beceri),
şu anda validated olarak tuttuğum 4 tanesi şunlar.
- frontend-product-delivery
- backend-service-delivery
- cloud-release-readiness
- ai-data-product-delivery
Diğerleri guided veya planned olarak ayrılmış durumda.
Kimler için uygun?
Şu kişiler için uygun olabilir.
- OpenCode’u zaten kullanan ya da kullanmayı düşünenler
- oh-my-openagent üzerinde yerel proje operasyon katmanını daha net kurmak isteyenler
- Yapay zeka kodlama ajanlarını gerçekten repo/worktree bazında çalıştırırken
routing / support boundary / workspace rule yapılarını düzenlemek isteyenler - Sadece uzun prompt’lar yazmak yerine, proje içinde operasyon bilgisini bırakmak isteyenler
Hızlı deneme
Bu repo için kabaca şu sırayı izleyebilirsiniz.
- OpenCode kurun
- oh-my-openagent ayarlarını yapın
- Repo’yu clone edin
- opencode’u çalıştırın
- oh-my-openagent’ın Sisyphus ya da Prometheus + Atlas kombinasyonuyla vibe coding yapın
Son olarak
Bu henüz tamamlanmış nihai bir ürün olmaktan ziyade,
benim Claude Code → OpenCode → oh-my-openagent geçişim sırasında gerçekten ihtiyaç duyduğum için düzenlediğim yerel operasyon araç setine daha yakın.
Benzer konularda aynı dertleri yaşamış olanlar varsa geri bildirimlerinizi beklerim.
Henüz yorum yok.