oh-my-customcode — Claude Code ajanlarını "yapılandırmak" değil "derlemek" için bir araç

 (github.com/baekenough)
1 puan yazan baekenough 2026-04-18 | 1 yorum | WhatsApp'ta paylaş

Claude Code ile birden fazla ajanı birlikte kullanınca sürekli aynı duvara çarpıyorsunuz.
Yetenek dokümanları yaz, ajan YAML’leri ekle, kurallar yerleştir, yönlendirmeyi bağla,
çakışma çıkarsa CLAUDE.md dosyasını elle düzenle. Proje her değiştiğinde bunu yeniden yaptığımı fark ettim.

Bu yüzden oh-my-customcode’u yaptım.
README’nin en üstündeki tek satır, ürünün kimliğini olduğu gibi anlatıyor.

Your AI Agent Stack. Compiled, Not Configured.

İki temel ekseni var.

1) Ajan, yapılandırma değil derlenmiş bir çıktıdır.

  • .claude/skills/ = kaynak kodu (yeniden kullanılabilir bilgi ve iş akışları)
  • .claude/agents/ = build çıktısı (yeteneklerle birleştirilmiş uzmanlar)
  • mgr-sauron = derleyici (yapı doğrulama)
  • .claude/rules/ = spesifikasyon (kısıtlar ve build kuralları)
  • yönlendirme yeteneği = linker (iş ile ajanı birbirine bağlar)

Yetenekler bağımsız olarak gelişir ve ajanlar, güncellenmiş yeteneklerle her an yeniden derlenebilir. Bu ayrım, runtime’ın başlangıç noktasıdır.

2) Uzman yoksa anında oluşturur.

"Terraform modülünü incele" dediniz ama kayıtlı bir uzman yoksa, sistem başarısız olmak yerine şöyle çalışır.

  • yönlendirme: terraform uzmanının olmadığını doğrular
  • mgr-creator: infra-aws-expert yeteneği + docker-best-practices rehberini tarar
  • infra-terraform-expert.md oluşturur
  • incelemeyi hemen çalıştırır
  • oluşturulan ajan, sonraki çağrılar için saklanır

Bu bir fallback değil, tasarımın kendisi. Uzmanlık eksikliğini bir build problemi olarak ele alıyor.

Varsayılan olarak gelenler

omcustom init komutunu bir kez çalıştırmanız yeterli; 48 agents / 107 skills / 22 rules / 39 guides sağlanıyor.

  npm install -g oh-my-customcode  
  cd your-project  
  omcustom init

Bazı tasarım kararları

  • Ana konuşma singleton bir orkestratördür (R010).
    Dosyalara doğrudan yazmaz; tüm işler yönlendirme üzerinden geçerek özel ajanlara devredilir.
    Context birbirine karışmaz.

  • Model katmanlamasını açıkça tanımladım.
    Mimari ve araştırma için opus, uygulama ve ajan oluşturma için sonnet
    Arama ve sayım doğrulaması için haiku. reasoning-sandwich deseni (opus → sonnet → haiku) temel biçimdir.

  • Bağımsız işler paralel çalışır (R009).
    Her mesaj başına en fazla 4 tane.

  • Güvenlik hook’ları advisory niteliğinde.
    secret-filter, audit-log, schema-validator, PostCompact (sıkıştırma sonrası kuralların yeniden enjekte edilmesi)
    Engellemez, yalnızca uyarı bırakır.

  • CLI çıktı tokenlarını %60~90 azaltmak için RTK varsayılan olarak kurulur.

Dürüstçe söylemek gerekirse

"oh-my-zsh benzeri Claude Code eklentisi" kategorisinde zaten epey şey var.
Ben de birkaçını kullandım ve onlara içtenlikle saygı duyuyorum.
Bu yüzden oh-my-customcode’da ağırlığı şablon koleksiyonuna değil, derleyici·yönlendirici·yöneticilerin çalıştığı runtime tarafına verdim.
Aynı konsepte sahip diğer uygulamalarla karşılaştırıldığında neyi farklı çözdüğümü merak ediyorsanız, sorarsanız yanıtlarım.

Neden singleton orkestratör seçildiği, neden sauron’un ayrı bir ajan olarak ayrıldığı, model katmanlama sezgisinin nasıl belirlendiği, ...

Merak ettiğiniz noktaları yorumlarda bırakın.
İlk geri bildirimler özellikle çok değerli.

İlgili okumalar

1 yorum

 
moderator 2026-04-19

Show GN'ye taşındı.
Bu arada, moderatörün sınıflandırmasını ayarladığı gönderilerin ana sayfada görünürlüğü kısıtlanabilir; bu yüzden göndermeden önce kategoriyi bir kez daha kontrol etmenizi rica ederiz.