Claude Code kutudan çıktığı haliyle güçlüdür, ancak yapı olmadan doğrudan kodlamaya atlar: planlama yok, test yok, sistematik yaklaşım yok. Superpowers eklentisi, kaosu önleyen kanıtlanmış geliştirme iş akışlarını zorunlu kılarak bu sorunu çözer.

Superpowers gerçekte ne yapar

Superpowers, Claude Code'u kritik anlarda durduran bir beceri çerçevesidir. Bir şey istediğinizde hemen kod yazmak yerine durur ve önce sorular sorar. Ardından TDD'yi zorunlu kılar, uygulama planları oluşturur ve devam etmeden önce kendi çalışmasını gözden geçirir.

Temel iş akışı:

1. Beyin fırtınası: Sokratik sorgulama yoluyla fikrinizi rafine eder
2. Planlama: tam dosya yollarıyla küçük görevler (her biri 2-5 dakika) oluşturur
3. Yürütme: görev başına iki aşamalı inceleme ile alt ajanlar gönderir
4. Bitirme: testleri doğrular, PR/birleştirme seçenekleri sunar, temizlik yapar

Kurulum (10 Saniye)

bash

Eklenti menüsünü açın

/plugin

"Discover" sekmesine gidin

"superpowers" araması yapın

Seçin ve kurun

Kurulumdan sonra Claude Code'u yeniden başlatın. Eklentinin aktif olduğunu doğrulayan "SessionStart:startup hook succeeded: Success" mesajını göreceksiniz.

Neler kurulur

Eklenti ihtiyacınız olan her şeyi içerir:

| Bileşen | Dahil || |-----------|----------| | Komutlar | execute-plan, write-plan, brainstorm | | Ajanlar | code-reviewer | | Beceriler | TDD, hata ayıklama, git worktrees, kod incelemesi dahil 14 beceri | | Kancalar | SessionStart (iş akışını otomatik başlatır) |

Üç temel komut

/superpowers:brainstorm

Bunu HERHANGİ bir yeni özellikten önce kullanın. Claude:

• hedefiniz hakkında açıklayıcı sorular sorar
• düşünmediğiniz alternatifleri keşfeder
• tasarımı doğrulama için sindirilebilir parçalar halinde sunar
• referans için bir tasarım belgesi kaydeder

Ne zaman tetiklenir: Herhangi bir özellik, yeniden düzenleme veya taşıma işleminin başlangıcında.

/superpowers:write-plan

Beyin fırtınasından sonra, şu özelliklere sahip bir uygulama planı oluşturur:

• her görev maksimum 2-5 dakika sürer
• her görevin tam dosya yolları ve eksiksiz kod parçacıkları vardır
• doğrulama adımları her göreve yerleştirilmiştir
• plan, "bağlamı olmayan hevesli bir junior mühendis" tarafından yürütüleceğini varsayar

/superpowers:execute-plan

Planı alt ajan odaklı geliştirme kullanarak çalıştırır:

• görev başına yeni alt ajan oluşturulur (temiz bağlam)
• iki aşamalı inceleme: önce spesifikasyon uyumu, sonra kod kalitesi
• gruplar arasında insan kontrol noktaları
• kritik sorunlar ilerlemeyi otomatik olarak engeller

14 beceri açıklaması

| Beceri | Ne yapar | |-------|--------------|| | test-driven-development | KIRMIZI-YEŞİL-YENİDEN DÜZENLEME'yi zorunlu kılar. Testlerden önce yazılan kodu siler. | | systematic-debugging | Derinlemesine savunma ile 4 aşamalı kök neden süreci | | using-git-worktrees | İzole dal oluşturur, kurulumu çalıştırır, temiz temel çizgiyi doğrular | | using-superpowers | Beceri sistemine giriş | | dispatching-parallel-agents | Eşzamanlı alt ajan iş akışları | | executing-plans | Kontrol noktalarıyla toplu yürütme | | finishing-a-development-branch | Birleştirme/PR/tutma/silme seçenekleri, temizlik | | brainstorming | Sokratik tasarım rafine etme | | writing-plans | Detaylı uygulama planlaması | | requesting-code-review | İnceleme öncesi kontrol listesi, kritik sorunlarda engelleme | | receiving-code-review | Geri bildirimlere sistematik yanıt verme | | writing-skills | Yeni beceriler oluşturmak için meta-beceri | | verification-before-completion | Düzeltmelerin gerçekten çalıştığından emin olur | | subagent-driven-development | Görev başına iki aşamalı inceleme |

Beceriler otomatik olarak nasıl tetiklenir

Beceriler çağırdığınız komutlar değildir, bağlama göre etkinleşirler:

• yeni bir özellik tartışmaya başlayın → brainstorming etkinleşir
• tasarım onaylanır → using-git-worktrees etkinleşir
• uygulama başlar → test-driven-development etkinleşir
• görev tamamlanır → requesting-code-review etkinleşir
• tüm görevler biter → finishing-a-development-branch etkinleşir

Claude herhangi bir görevden önce ilgili becerileri kontrol eder. Bunlar öneri değil, zorunlu iş akışlarıdır.

Git worktree entegrasyonu

Superpowers izole geliştirme için git worktrees kullanır: bash

Arka planda olan:

git worktree add ../project-feature feature-branch cd ../project-feature

Claude burada çalışır, ana dal temiz kalır

Faydaları:

• farklı özellikler üzerinde birden fazla Claude örneği çalıştırın
• deneyler sırasında ana dalı kararlı tutun
• işler ters giderse kolay temizlik

Alt ajan odaklı geliştirme

En güçlü model. Tek bir uzun Claude oturumu yerine:

1. Ana ajan planı oluşturur
2. Yeni alt ajan her görevi yürütür
3. İnceleme ajanı (code-reviewer) çalışmayı kontrol eder
4. Ana ajan devam eder veya düzeltme talep eder

Neden işe yarar: her alt ajan TEK bir göreve odaklanmış temiz bağlamla başlar. Uzun oturumlardan biriken karışıklık yok.

TDD uygulaması

Superpowers TDD'yi ciddiye alır. Beceri:

• uygulamadan ÖNCE başarısız test gerektirir
• testin başarısız olmasını izler (bir şeyi test ettiğini kanıtlar)
• geçmek için minimal kod uygular
• yeşilde commit yapar
• sadece yeşilden sonra yeniden düzenler

Claude testlerden önce kod yazarsa, beceri o kodu silmesini ve baştan başlamasını söyler.

Pratik örnek

Siz: Express uygulamam için kullanıcı kimlik doğrulaması lazım

Claude (Superpowers ile): → Beyin fırtınası becerisini etkinleştirir → Sorar: OAuth mu şifre mi? Oturum mu JWT mi? Hangi sağlayıcılar? → Keşfeder: Hız sınırlama? Hesap kilitleme? Şifre gereksinimleri? → Onayınız için tasarımı bölümler halinde sunar

Siz: İyi görünüyor, planlayalım

Claude: → Plan yazma becerisini etkinleştirir → Her biri 2-5 dakika olan 12 görev oluşturur → Görev 1: /signup endpoint'i için başarısız test oluştur → Görev 2: Testi geçmek için signup handler'ı uygula → Her görevin tam dosya yolları ve kodu var

Siz: Yürüt

Claude: → Görev 1 için alt ajan oluşturur → code-reviewer ajanı çıktıyı doğrular → Görev 2 için alt ajan oluşturur → İlerlemeyi raporlar, devam için onay ister

Eklentiyi yönetme

/plugin menüsünden şunları yapabilirsiniz:

• Eklentiyi devre dışı bırak: geçici olarak kapat
• Güncelleme için işaretle: sonraki güncelleme döngüsü için işaretle
• Şimdi güncelle: en son sürümü hemen al
• Kaldır: tamamen sil
• GitHub'da görüntüle: kaynak kodunu gör

Superpowers'ı NE ZAMAN kullanmamalısınız

• hızlı tek seferlik sorular
• basit dosya düzenlemeleri
• 5 dakikanın altındaki görevler

Bunlar için ek yük buna değmez. Superpowers, sistematik yürütme gerektiren çok dosyalı özellikler, yeniden düzenlemeler ve taşımalarda parlıyor.

Hızlı Referans

Superpowers, Claude Code'u "bazen raydan çıkan yardımcı asistan"dan "kanıtlanmış süreçleri takip eden sistematik geliştirme ortağı"na dönüştürür. Yapılandırılmış iş akışı en yaygın başarısızlık modlarını önler: atlanan testler, eksik uç durumlar ve gereksinimlerden sapan özellikler.