Prompt'u yazdın. Enter'a bastın.
Agent daha sen elini klavyeden çekmeden kod yazmaya başladı. Senin istemediğin bir kütüphaneyi seçti, dosyaları yanlış yere koydu, iki gereksinimi atladı — çünkü ne istediğini hiç sormadı.
Fark ettiğinde iş şuraya geliyor: tasarlamadığın bir çıktıyı debug ediyorsun.
Superpowers tam olarak bunu düzeltmek için yapılmış. Modeli akıllandırarak değil — modelin, codebase'e dokunmadan önce her kıdemli mühendisin uyguladığı disiplini atlamasını imkânsız kılarak.
Bu yazıdaki bilgiler resmî repo ve sürüm notları üzerinden Ağustos 2026 itibarıyla kontrol edildi.
Tek paragrafta Superpowers
Superpowers, coding agent'lar için açık kaynak bir agentic skills çerçevesi. Jesse Vincent ve Prime Radiant ekibi geliştiriyor.
Bir dizi birleştirilebilir "skill" kuruyor — SKILL.md dosyaları olarak yazılmış, agent'ın harekete geçmeden önce okumak ve uymak zorunda olduğu zorunlu davranış kılavuzları. Varsayılan skill yığını yapılandırılmış bir akış dayatıyor: önce tasarımı birlikte konuş, izole bir git worktree aç, doğrulama adımları olan mikro görev planı yaz, sonra subagent'larla çalıştır.
GitHub'da MIT lisansıyla mevcut ve Ağustos 2026 itibarıyla 270 binin üzerinde yıldıza sahip. Yıldız sayısı ilgiyi gösterir, kaliteyi değil — ama bu ölçekte bir sayı, en azından çok sayıda geliştiricinin aynı sorunu yaşadığını söylüyor.
Çözdüğü problem: agent'lar neden doğrudan koda dalıyor
Hedeflediği hata modu spesifik ve production'da coding agent kullanan herkesin bildiği bir şey. Yukarıda yazdım: istek veriyorsun, agent anında kod yazmaya başlıyor.
Kök neden zekâ değil, varsayılan davranış. Dil modelleri anında yardımcı olmaya eğitiliyor. O eğitim içgüdüsü onları mümkün olduğunca hızlı çıktı üretmeye itiyor. Atlanan şey ise kıdemli bir mühendisin ilk yaptığı her şey: doğru soruları sormak, mimariyi çizmek, ne inşa edeceğini inşa etmeden önce yazmak.
Superpowers bu içgüdüyü oturum düzeyinde yakalıyor ve yapılandırılmış kapılardan geçiriyor.
Kim yaptı
Jesse Vincent, Request Tracker'ın (Perl topluluğunda ve ötesinde yaygın kullanılan açık kaynak ticket sistemi) yaratıcısı, Perl 5 dil sürümlerinden sorumluydu ve Keyboardio'nun kurucu ortağı.
Superpowers'ın ilk sürümünü Ekim 2025'te — Anthropic'in Claude Code için plugin sistemini duyurduğu hafta — yazdı ve o zamandan beri aktif geliştirmede kullanıyor. 2026 başında kurduğu Prime Radiant şimdi projenin kurumsal evi.
Skill sistemi nasıl çalışıyor
Skill'ler ne ve nasıl tetikleniyor
Superpowers'ta bir "skill", yapılandırılmış bir davranış kılavuzu içeren bir SKILL.md dosyası: ne zaman devreye gireceği, hangi adımların izleneceği, hangi doğrulamanın yapılacağı. Agent ilgili skill'i okuyor ve uyguluyor. Mekanizmanın tamamı bu. Özel model yok, özel çıkarım katmanı yok — sadece agent'ın danışmak zorunda olduğu yapılandırılmış talimatlar.
Anahtar kelime "zorunda". Ana skill (using-superpowers SKILL.md) her oturum başında bir session hook ile enjekte ediliyor. Metninde şu geçiyor: "IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT." Model, herhangi bir yanıttan önce — açıklayıcı soruları cevaplamadan önce bile — ilgili skill var mı diye bakıyor.
Skill'ler kullanıcı komutlarıyla değil, bağlam tespitiyle otomatik tetikleniyor. Bir özelliğe başlıyormuş gibi bir şey tarif ettiğinde ("şunu yapmama yardım et", "şunu eklemek istiyorum") brainstorming skill'i devreye giriyor. Tasarımda anlaştıktan sonra worktree skill'i devreye giriyor.
Session-start hook'u bunu görünmez kılan şey: Superpowers'ı çalıştırmak için komut yazmıyorsun, oturum açıldığı andan itibaren zaten çalışıyor.
Önemli bir öncelik hiyerarşisi var: CLAUDE.md, GEMINI.md veya AGENTS.md içindeki kullanıcı talimatları skill'lerin önüne geçiyor. Proje dosyan "TDD kullanma" diyorsa, TDD'yi dayatan skill senin talimatına uyuyor. Skill'ler varsayılan model davranışını geçersiz kılıyor, senin açık yapılandırmanı değil.
Çekirdek akış
Superpowers'ın dayattığı tam akış dört zorunlu aşama:
Brainstorm — Kod öncesi, agent gerçekte ne yapmaya çalıştığını soruyor. Tasarımı seninle okunabilir uzunlukta parçalar hâlinde işliyor, kenar durumları çıkarıyor, alternatifleri araştırıyor ve ancak sen açıkça onay verdiğinde yazılı bir tasarım dokümanı üretiyor.
İzole çalışma alanı — Tasarım onaylandıktan sonra worktree skill'i izole bir worktree'de yeni bir branch açıyor. Main branch'ine dokunulmuyor. Agent proje kurulumunu çalıştırıyor ve bir şey yazılmadan önce temiz bir test taban çizgisi doğruluyor.
Plan — writing-plans skill'i, kendi tanımıyla "hevesli ama zevksiz, muhakemesiz, proje bağlamı olmayan ve test yazmaktan hoşlanmayan bir junior mühendis" için yazılmış bir mikro görev planı üretiyor. Her görev 2–5 dakikalık iş, tam dosya yolları, beklenen kodun tamamı ve bir doğrulama adımı içeriyor.
TDD ile çalıştırma — Subagent'lar planı katı kırmızı/yeşil/refactor disipliniyle işliyor: önce testi yaz, başarısız olduğunu gör, kodu yaz, geçtiğini gör. Her subagent temiz başlıyor ve çıktısı kabul edilmeden önce iki gözden geçirmeden geçiyor — önce spec uyumu, sonra kod kalitesi.
Yaz aylarında bu akışta iki değişiklik oldu ve ikisi de pratikte hissediliyor. "Üç görev çalıştır, sonra review için dur" örüntüsü kaldırıldı — planlar artık sürekli çalışıyor, sadece bir engel çıktığında duruyor. Ve /brainstorm, /write-plan, /execute-plan komutları kullanımdan kaldırılıyor; artık karşılık gelen skill'lere yönlendiriyorlar.
Varsayılan yığındaki temel skill'ler
brainstorming — koddan önceki tasarım kapısı
Yeni bir şeye başladığını tespit ettiğinde devreye giriyor. İşi, belirsiz bir istek talebini Sokratik diyalogla doğrulanmış bir tasarım dokümanına çevirmek. Agent sadece "ne istiyorsun?" diye sormuyor — mimari ödünleşimleri ortaya koyuyor, senin söylemediğin kenar durumları soruyor ve oluşan tasarımı onayın için sindirilebilir bölümler hâlinde sunuyor.
Sen onaylamadan hiçbir şey ilerlemiyor. Bu kapı, en pahalı hata modunu engelliyor: yanlış şeyi inşa etmeye başlamak.
using-git-worktrees — izole çalıştırma ortamı
Her geliştirme oturumu kendi git worktree'sini alıyor — kendi branch'inde, ana çalışma ağacından ayrı bir dizin. Skill akıllı dizin seçimi, güvenlik doğrulaması ve proje kurulumunu üstleniyor. Agent bir worktree'de özellik üzerinde çalışırken sen main'de geliştirmeye devam edebiliyorsun. İş bittiğinde finishing-a-development-branch skill'i merge/PR/temizlik seçeneklerinde yol gösteriyor.
Not: SDD sırasında üretilen geçici dosyalar artık .git/ altında değil, çalışma ağacındaki kendi kendini yok sayan .superpowers/sdd/ dizininde tutuluyor. Sebebi somut — Claude Code .git/ dizinini korumalı sayıyor ve agent yazımını reddediyordu, bu da bir subagent'ı iş ortasında bloke ediyordu.
writing-plans — doğrulama adımlı küçük görevler
Agent'ın yazdığı plan kasıtlı olarak fazla spesifik. Her görev tam dosya yolları, beklenen kodun tamamı ve açık doğrulama adımları içeriyor — çalıştıranın proje hakkında sıfır bağlamı olsa bile gerekecek ayrıntı düzeyi.
Bu ilk bakışta gereksiz yük gibi duruyor. Neden işe yaradığını fark edene kadar: planlama aşamasını, çalıştırma başlamadan önce her varsayımı ortaya çıkarmaya zorluyor. Uygulamanın ortasında yeniden işe yol açacak belirsizlikler, ucuz metin biçiminde planlama sırasında çözülüyor.
subagent-driven-development — paralel çalıştırma
Subagent destekleyen platformlarda her plan görevi, ana agent kendi bağlamında devam etmek yerine taze bir subagent tarafından yürütülüyor. Bu, bağlam kaymasını çözüyor — uzun süren agent'ların, bağlam penceresi alakasız geçmişle dolarken orijinal spec'ten yavaşça sapma eğilimi.
Her subagent sadece tamamlaması gereken görevi ve ilgili plan bölümünü alıyor. Ardından iki gözden geçirme: önce spec uyumu, sonra kod kalitesi.
Subagent desteği olmayan platformlarda executing-plans skill'i sıralı bir alternatif sunuyor. Sürüm notlarına göre writing-plans artık ikisi arasında seçim sunmuyor — subagent yeteneği tespit edilirse subagent-driven-development zorunlu.
Superpowers ne değil
Yeni bir model ya da araç değil — mevcut agent'ların üstünde bir davranış katmanı
Superpowers model ağırlıklarını değiştirmiyor, özel bir çıkarım katmanı eklemiyor, modelin akıl yürütme şeklini değiştirmiyor. Bir dizi SKILL.md dosyası ve bir session hook'undan ibaret. İşi yapan agent hâlâ Claude, Codex ya da hangi platformu çalıştırıyorsan o — Superpowers sadece o agent'ın kod yazmaya başlamadan önce ne yapacağını belirliyor.
Çerçeve tasarım gereği model-bağımsız: Anthropic daha iyi bir Claude çıkardığında Superpowers otomatik olarak faydalanıyor. Dayatılan kısıt prosedürel, mimari değil.
Şunu söyleyeyim: benimseme kararı açısından bu ayrım önemli. Yeni bir model sağlayıcısına ya da tescilli bir çıkarım yığınına bahis oynamıyorsun. Yapılandırılmış prompt'lar olarak kodlanmış bir geliştirme metodolojisi benimsiyorsun. Metodoloji ekibin için işe yaramazsa plugin'i kaldırıyorsun. Altyapında hiçbir şey değişmiyor.
Bir yapısal değişiklik daha: skill'ler artık plugin'in içinde yaşamıyor. Ayrı bir repoya taşındılar (obra/superpowers-skills), oturum başında otomatik güncelleniyorlar ve isterse fork edebiliyorsun. Yani skill setini kendi ekibine göre değiştirmek artık plugin'i çatallamayı gerektirmiyor.
Seni nerede yavaşlatıyor
Brainstorm → plan → çalıştır hattı gerçek bir yük getiriyor: kod başlamadan önce yapılandırılmış diyalog. İki satırlık bir bug fix için bu yük saçma. Net bir spec olmadan kasıtlı olarak bir şeyler denediğin keşif amaçlı prototiplemede ise zorunlu brainstorming aşaması yapmak istediğin şeyle kavga ediyor.
Gerçekçi olalım: Superpowers, elinde net bir özellik ya da refactor varken ve bunun güvenilir şekilde yapılmasını isterken en iyi çalışıyor. "Şunu bir deneyeyim de ne olacak görelim" için yanlış araç.
Bununla birlikte, bu eleştiriye yaz aylarında somut bir cevap geldi: seremoni artık göreve göre ölçekleniyor. İstekler spike, bounded ve architectural olarak sınıflandırılıyor; küçük görevler iki dokümanlı ritüeli atlıyor. Ama her yolda uygulama öncesi senin onayın için duruluyor. Yani "küçük iş için çok ağır" itirazı tamamen ortadan kalkmıyor, ancak eskisi kadar keskin değil.
Desteklenen platformlar
Superpowers birden fazla coding agent platformunu destekliyor, entegrasyon düzeyi değişiyor:
Claude Code — birincil platform, tam subagent desteği, Ocak 2026'dan beri Anthropic'in resmî marketplace'inde listeleniyor (claude plugin add obra/superpowers), session-start hook tam destekli.
Codex (CLI ve uygulama) — tam subagent desteği.
Cursor — plugin desteği, sıralı executing-plans.
OpenCode ve Copilot CLI — destekleniyor; Copilot CLI yakın bir sürümde session-start hook desteği aldı.
Factory Droid, Devin CLI ve Hermes Agent — kurulum dokümanlarına eklendi. Devin tarafında devin plugins install obra/superpowers çalışıyor ve skill'ler oturum başında otomatik tetikleniyor. Grok Build CLI da kurulum dokümanlarında yer alıyor.
Gemini CLI — artık desteklenmiyor. Google, Gemini CLI'yi 18 Haziran 2026'da EOL etti; eklenti kurulamıyor ve güncellenemiyor. Gemini kurulum dokümanlarından, subagent-yetenekli platform listelerinden ve eval açıklamasından çıkarıldı, tool-mapping referansı da silindi. Nisan tarihli kaynaklarda hâlâ destekleniyormuş gibi görünüyor — görmezden gel.
Platform yetenekleri hangi çalıştırma modunun mevcut olduğunu belirliyor: subagent destekleyenlerde subagent-driven-development, diğerlerinde sıralı executing-plans.
Ne zaman değer
Kullan, eğer:
- Spec'siz başlamanın sonradan debug zamanına mal olacağı kapsamda bir özellik geliştiriyorsan
- Agent'ların uygulama ortasında orijinal gereksinimden saptığını yaşadıysan ve bunun yapısal olarak engellenmesini istiyorsan
- Her görevde hatırlatmak zorunda kalmadan TDD'nin dayatılmasını istiyorsan
- Yanlış başlangıç varsayımlarının geri alınmasının pahalı olduğu bir codebase'de çalışıyorsan
- Uzun bir oturum boyunca otonom çalışmasını istediğin bir agent'a ciddi iş devrediyorsan
Atla (ya da skill'leri seçerek çağır), eğer:
- Görev, problemi zaten tanımlanmış bir iki satırlık düzeltmeyse
- Kararlı bir yön olmadan kasıtlı olarak çözüm alanını araştırıyorsan
- Planlama aşamasının zaman maliyeti, o iş için yapılandırılmamış çalıştırmanın olası maliyetini aşıyorsa
Sorulacak doğru soru yük sorusu. Superpowers, planlama maliyetini karmaşık görevlerde çıkarıyor — yapılandırılmamış agent'ların ciddi düzeltme gerektiren yanlış çıktı üreteceği yerlerde. Önemsiz görevlerde çıkarmıyor.
SSS
Claude Code ile çalışıyor mu?
Evet — Claude Code birincil platform. Kurulum Anthropic'in resmî plugin marketplace'i üzerinden (claude plugin add obra/superpowers) ya da doğrudan GitHub reposundan yapılabiliyor. Session-start hook tam entegre, skill'ler otomatik tetikleniyor ve Claude Code yerel subagent desteklediği için subagent-driven-development kullanılabiliyor.
Hızlı bug fix'lerde yük kendini amorti ediyor mu?
Genel olarak hayır. Brainstorming ve planlama aşamaları özellik düzeyinde iş için tasarlandı, hedefli bug fix için değil. Küçük ve iyi tanımlanmış bir düzeltme için Superpowers gereksiz süreç ekliyor. Çerçevenin kendisi de bunun farkında: using-superpowers ana skill'i bir şey çağırmadan önce bağlama bakıyor ve "bir şey inşa ediyorum" örüntüsüne uymayan basit istekler tam akışı tetiklemeyebiliyor. Ayrıca istekler artık spike / bounded / architectural olarak sınıflandırılıyor ve küçük görevler iki dokümanlı süreci atlıyor. Yine de küçük işlerde kesin olarak yolundan çekilmesini istiyorsan, o oturumu plugin olmadan çalıştır.
Ücretsiz mi, açık kaynak mı?
MIT lisansı, tamamen ücretsiz. Kullanım limiti yok, abonelik yok, oturumlarından veri toplama yok. Skill reposu (obra/superpowers-skills) da MIT ve topluluk tarafından düzenlenebiliyor — fork edebilir, kendi projen için skill'leri değiştirebilir ya da katkı gönderebilirsin. Plugin'in kendisi, skill reposunun yerel bir kopyasını yöneten hafif bir katman; skill'ler oturum başında otomatik güncelleniyor.
CLAUDE.md veya AGENTS.md'den farkı ne?
CLAUDE.md ve AGENTS.md proje bazlı talimat dosyaları — projen, tercihlerin ve kısıtların hakkında kalıcı bağlam vermek için onları sen yazıyorsun. Oturum başında agent'ın okuduğu dokümantasyon. Superpowers skill'leri ise prosedürel akışlar: sadece projenin ne olduğunu söylemiyorlar, belirli görev tiplerinde hangi sürecin izleneceğini belirtiyorlar. İki sistem birbirini tamamlıyor ve birlikte çalışacak şekilde tasarlanmış. Çakışma olduğunda Superpowers skill'leri CLAUDE.md talimatlarına yol veriyor — proje dosyan bir skill davranışını geçersiz kılıyorsa, proje dosyası kazanıyor.
Sonuç
Net konuşmak gerekirse: Superpowers işe yarıyor. Ama herkese göre değil.
Değeri şurada: agent'ın atladığı disiplini geri koyuyor ve bunu senin her seferinde hatırlatmana gerek kalmadan yapıyor. Yeni bir modele bahis oynamıyorsun — metodolojiyi markdown olarak kuruyorsun, işe yaramazsa kaldırıyorsun.
Kapsamı belirsiz bir özellik geliştiriyorsan, ya da agent'ın spec'ten saptığını daha önce yaşadıysan — bir bak. Kurulum tek komut, lisans MIT, geri almak plugin'i kaldırmak kadar kolay.
İki satırlık bir düzeltme için ise açma. O iş için tasarlanmadı, kendisi de bunu söylüyor.
İyi kodlamalar.
