- Son birkaç haftada Claude Code tabanlı kodlama ajanı sistemini sistematik hale getirerek “Superpowers” adlı yeni bir genişletme aracı oluşturdum.
- Superpowers, eklenti biçiminde kurulur ve Claude’a “Skill”ler öğretir; bu Skill’ler üzerinden çalışma biçimini otomatikleştiren ve iyileştiren işlevler sunar.
- Anthropic’in Claude Code eklenti sistemini kullanarak ajan; iş akışı otomasyonu, TDD yürütme, kod inceleme, Git worktree yönetimi gibi işleri otonom biçimde yapar.
- Yeni iş akışı otomatik olarak beyin fırtınası → planlama → uygulama adımlarından geçer, işleri paralel yürütür ve RED/GREEN TDD yaklaşımıyla test odaklı geliştirme yapar.
- Temel kavram olan “Skill”, Claude’un belirli bir görevi yerine getirirken başvurması gereken bilgi birimidir; kullanıcı bunu doğrudan yazabilir ya da Claude’un öğrenme dokümanlarına dayanarak üretmesini sağlayabilir.
- Bu yapının gelecekte yapay zeka kodlama ajanlarının öz-iyileştirme ve iş birliği standardı haline gelebileceğini düşünüyorum; Superpowers paylaşım özelliği ile bellek sistemini tamamlamak ise bir sonraki hedef.
Superpowers genel bakış
- Superpowers, Claude Code 2.0.13 ve üzeri sürümlerde çalışır; kullanıcılar
/plugin marketplace add obra/superpowers-marketplace komutuyla kurabilir.
- Kurulumdan sonra Claude,
SKILL.md belgesini otomatik olarak okuyarak “eğer Skill varsa mutlaka kullanılmalıdır” kuralını öğrenir.
- Böylece Claude, beyin fırtınası ve planlama aşamalarından geçerek uygulama öncesi tartışmayı yönlendirir; iş tamamlandığında GitHub PR oluşturma veya birleştirme önerisi de sunar.
Kodlama iş akışı
- Claude, proje ya da görev başlangıcını algıladığında uygulamadan önce otomatik olarak beyin fırtınası ve planlama aşamalarından geçer.
- Git deposunda çalışırken otomatik olarak worktree oluşturur ve paralel işler arasında çakışmaları önler.
- İki farklı çalışma modu sunulur.
- Mevcut yöntem: Kullanıcı ikinci bir Claude oturumu açar ve mimar ile uygulayıcı arasında arabuluculuk yapan PM rolünü üstlenir.
- Yeni yöntem: Görevleri alt ajanlara ayrı ayrı dağıtır ve her görevde kod incelemesinden sonra ilerler.
- RED/GREEN TDD yaklaşımıyla başarısız test yazma → minimum uygulama → testi geçme döngüsü tekrar eder.
- Uygulama tamamlandıktan sonra GitHub PR oluşturma, yerel dalı birleştirme veya sonlandırma seçenekleri sunulur.
Skill sisteminin temel prensibi
- Superpowers’ın merkezi unsuru Skill’dir; bu, Claude’un belirli bir problemi çözmek için okuyup uygulayabildiği Markdown tabanlı bir bilgi modülüdür.
- Anthropic, Office belge oluşturma özelliğini duyurduğunda Skill kavramını ilk kez tanıttı.
- Benzer desenler Microsoft Amplifier gibi çeşitli kodlama ajanı çerçevelerinde de ortaya çıktı.
- Skill, Claude’un “yeni yetenekler” öğrenmesini sağlayan birimdir; kullanıcılar Claude’dan kitapları ya da kod tabanlarını analiz ederek yeni Skill’ler çıkarmasını isteyebilir.
- Ajan, Skill arama betiğini çalıştırır ve ilgili etkinlik için bir Skill varsa bunu mutlaka kullanmalıdır.
- İlk meta Skill olan "nasıl Skill yazılır" sayesinde Claude’un yeni Skill’ler üretmesini otonom hale getiren bir iş akışı desteklenir.
- Modele "bu kitabı oku, düşün ve öğrendiklerini kaydet" dendiğinde yeniden kullanılabilir bilgiyi otomatik olarak yapılandırır.
- Claude, üretilen Skill’leri test etmek için alt ajanları (subagents) simüle eder ve her Skill’in gerçekten geçerli olup olmadığını TDD yaklaşımıyla doğrular.
- İlk denemelerde yarışma programı tarzı quiz formatıyla doğrulama yapılmıştı, ancak bu yeterince etkili olmadı.
- İyileştirmeden sonra “pressure test” senaryoları kurularak Skill’lerin gerçek ortama benzer koşullarda geçerliliği denetlenmeye başlandı.
Pressure test senaryosu örnekleri
- Senaryo 1: zaman baskısı + özgüven
- Durum: Production’da yaşanan arıza nedeniyle dakikada 5.000 dolar kayıp var ve kimlik doğrulama servisinin debug edilmesi gerekiyor.
- Seçenekler: Hemen debug etmek (5 dakika) vs Skill aramasından sonra debug etmek (7 dakika)
- Amaç: Acil durumda bile önce Skill aramasını teşvik etmek
- Senaryo 2: batık maliyet + çalışan kod
- Durum: 45 dakikada yazılan asenkron test altyapısı zaten çalışıyor.
- Seçenekler: Skill kontrolü sonrası yeniden çalışma olasılığı (3 dakika) vs mevcut kodu commit etmek
- Amaç: Çalışan kod olsa bile Skill’e uyumu zorunlu kılmak
- Robert Cialdini’nin ikna psikolojisi ilkeleri (otorite, bağlılık, beğeni, kıtlık vb.) LLM’lere uygulandı.
- Kısa süre önce Dan Shapiro ve diğerlerinin ortak yazdığı bir araştırma, Cialdini ilkelerinin LLM’lerde de geçerli olduğunu bilimsel olarak gösterdi.
- Sonradan fark edildi ki Superpowers Skill sistemi zaten ikna tekniklerini bilinçsizce kullanıyordu.
- Otorite çerçevesi ("IMPORTANT: gerçek durum"), bağlılık yönlendirmesi ("A, B, C arasından seç"), kıtlık ("18:00, 18:30")
Bellek (Memories) özelliği
- Superpowers, Claude’un önceki konuşmaların bağlamını koruyup kullanabilmesi için “remembering-conversations” Skill’ini içerir.
- Bu Skill, konuşma günlüklerini SQLite tabanlı bir vektör veritabanında saklar ve Claude Haiku kullanarak özet üretir.
.claude dışında konuşma kayıtlarını otomatik olarak kopyalayarak Anthropic’in otomatik silme davranışını önler.- Claude, ihtiyaç duyduğunda alt ajanlar aracılığıyla geçmiş konuşmalardan ilgili bilgileri arar; gereksiz aramalarla context window’un kirlenmemesi için sistem buna göre tasarlanmıştır.
- Henüz tüm bağlantılar tamamlanmış değil, ancak tüm bileşenler zaten uygulanmış durumda.
Paylaşım (Sharing) özelliği
- Superpowers’ın hedefi bir Skill paylaşım ekosistemi kurmaktır.
- Kullanıcılar, Claude’un öğrendiği Skill’leri GitHub Pull Request biçiminde göndererek başkalarıyla paylaşabilir.
- Yeni Claude eklenti sistemiyle entegre olurken, kullanıcı onayı olmadan Skill paylaşılmaması için güvenlik önlemleri bulunur.
- İlk kurulum yöntemi yalnızca Claude’a belirli bir URL okutmaya dayanıyordu, ancak şimdi eklenti marketplace yapısına geçildi.
Kurulum ve kullanım
- Claude Code 2.0.13 ve üzeri gerekir.
- Eklenti marketplace üzerinden kurulum komutlarını çalıştırın.
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplace
- Yeniden başlatmanın ardından bootstrap prompt enjekte edilerek Skill sistemi otomatik olarak etkinleştirilir.
- Claude ve Superpowers ile gerçek bir Todo uygulamasının baştan sona uygulanma kaydı da paylaşıldı; burada Claude’un sorularını, test odaklı geliştirme sürecini ve git yönetimini görmek mümkün.
Henüz yorum yok.