Mevcut oturumda bağımsız görevlerle uygulama planlarını yürütürken kullanın
cd ~/.claude/skills
git clone https://github.com/obra/superpowers.git superpowers mkdir -p ~/.claude/skills/subagent-driven-development
curl -fsSL https://raw.githubusercontent.com/obra/superpowers/HEAD/skills/subagent-driven-development/SKILL.md \
-o ~/.claude/skills/subagent-driven-development/SKILL.md Planı, her görev için taze bir uygulayıcı alt ajanı göndererek, her birinden sonra bir görev incelemesi (spec uygunluğu + kod kalitesi) ve sonunda geniş bir dal incelemesi yaparak yürütün.
Alt ajanlar neden kullanılır: Görevleri izole bağlamla uzmanlaşmış ajanlara devredersiniz. Talimatlarını ve bağlamını kesin bir şekilde hazırlayarak, onları odaklanmış ve görevde başarılı olmaları için sağlarsınız. Asla oturumunuzun bağlamını veya geçmişini devralmamalıdırlar — ihtiyaç duydukları şeyin tam olarak neresini inşa edeceğini belirtirsiniz. Bu aynı zamanda koordinasyon çalışması için kendi bağlamınızı koruyor.
Temel ilke: Görev başına taze alt ajan + görev incelemesi (spec + kalite) + geniş final inceleme = yüksek kalite, hızlı iterasyon
Anlatı: Araç çağrıları arasında en fazla bir kısa satır söyleyin — defter ve araç sonuçları kaydı taşır.
Sürekli yürütme: Görevler arasında insan ortağınızla kontrol etmek için durmayın. Plandan tüm görevleri durmadan çalıştırın. Durmanız gereken tek nedenler: Çözemeyeceğiniz BLOCKED durumu, ilerlemeyi engelleyen gerçek belirsizlik veya tüm görevler tamamlandığında. "Devam etmeli miyim?" soruları ve ilerleme özetleri onların zamanını boşa harcar — sizi planı çalıştırması için istediler, öyleyse çalıştırın.
digraph when_to_use {
"Have implementation plan?" [shape=diamond];
"Tasks mostly independent?" [shape=diamond];
"Stay in this session?" [shape=diamond];
"subagent-driven-development" [shape=box];
"executing-plans" [shape=box];
"Manual execution or brainstorm first" [shape=box];
"Have implementation plan?" -> "Tasks mostly independent?" [label="yes"];
"Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"];
"Tasks mostly independent?" -> "Stay in this session?" [label="yes"];
"Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"];
"Stay in this session?" -> "subagent-driven-development" [label="yes"];
"Stay in this session?" -> "executing-plans" [label="no - parallel session"];
}
vs. Planları Yürütme (paralel oturum):
digraph process {
rankdir=TB;
subgraph cluster_per_task {
label="Per Task";
"Dispatch implementer subagent (./implementer-prompt.md)" [shape=box];
"Implementer subagent asks questions?" [shape=diamond];
"Answer questions, provide context" [shape=box];
"Implementer subagent implements, tests, commits, self-reviews" [shape=box];
"Write diff file, dispatch task reviewer subagent (./task-reviewer-prompt.md)" [shape=box];
"Task reviewer reports spec ✅ and quality approved?" [shape=diamond];
"Dispatch fix subagent for Critical/Important findings" [shape=box];
"Mark task complete in todo list and progress ledger" [shape=box];
}
"Read plan, note context and global constraints, create todos" [shape=box];
"More tasks remain?" [shape=diamond];
"Dispatch final code reviewer subagent (../requesting-code-review/code-reviewer.md)" [shape=box];
"Use superpowers:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen];
"Read plan, note context and global constraints, create todos" -> "Dispatch implementer subagent (./implementer-prompt.md)";
"Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?";
"Implementer subagent asks questions?" -> "Answer questions, provide context" [label="yes"];
"Answer questions, provide context" -> "Dispatch implementer subagent (./implementer-prompt.md)";
"Implementer subagent asks questions?" -> "Implementer subagent implements, tests, commits, self-reviews" [label="no"];
"Implementer subagent implements, tests, commits, self-reviews" -> "Write diff file, dispatch task reviewer subagent (./task-reviewer-prompt.md)";
"Write diff file, dispatch task reviewer subagent (./task-reviewer-prompt.md)" -> "Task reviewer reports spec ✅ and quality approved?";
"Task reviewer reports spec ✅ and quality approved?" -> "Dispatch fix subagent for Critical/Important findings" [label="no"];
"Dispatch fix subagent for Critical/Important findings" -> "Write diff file, dispatch task reviewer subagent (./task-reviewer-prompt.md)" [label="re-review"];
"Task reviewer reports spec ✅ and quality approved?" -> "Mark task complete in todo list and progress ledger" [label="yes"];
"Mark task complete in todo list and progress ledger" -> "More tasks remain?";
"More tasks remain?" -> "Dispatch implementer subagent (./implementer-prompt.md)" [label="yes"];
"More tasks remain?" -> "Dispatch final code reviewer subagent (../requesting-code-review/code-reviewer.md)" [label="no"];
"Dispatch final code reviewer subagent (../requesting-code-review/code-reviewer.md)" -> "Use superpowers:finishing-a-development-branch";
}
Bulduğunuz her şeyi insan ortağınıza, planı onu zorunlu kılan metin yanında, her birinin ne yönettiğini sorarak — yürütme başlamadan önce, bir soruda — sunun, plan ortasında keşif başına bir kesinti değil. Tarama temizse, yorum yapılmadan devam edin. İnceleme döngüsü, yalnızca uygulamadan ortaya çıkan çelişkiler için ağ olarak kalır.
Her rolü işleyebilen en az güçlü modeli kullanarak maliyeti ve hızı koruyun.
Mekanik uygulama görevleri (izole fonksiyonlar, net specler, 1-2 dosya): hızlı, ucuz model kullanın. Plan iyi belirtilmişse çoğu uygulama görevi mekaniktir.
Entegrasyon ve yargı görevleri (çok dosyalı koordinasyon, pattern matching, hata ayıklama): standart model kullanın.
Mimari ve tasarım görevleri: mevcut en yetenekli modeli kullanın. Son dal incelemesi bunlardan biridir — oturum varsayılanında değil, mevcut en yetenekli modelde gönderin.
İnceleme görevleri: diff'in boyutu, karmaşıklığı ve riski ölçeğinde aynı yargıya sahip modeli seçin. Küçük mekanik bir diff en yetenekli modele ihtiyaç duymaz; ince bir eşzamanlılık değişikliği yapar.
Bir alt ajanı gönderirken her zaman modeli açıkça belirtin. Atlanmış model, oturumunuzun modelini devralır — çoğu zaman en yetenekli ve en pahalı — bu sessizce bu bölümü başarısız kılar.
Dönüş sayısı token fiyatından daha iyidir. Duvar saati ve bağlam maliyeti alt ajanın kaç dönüş aldığıyla ölçeklenir ve en ucuz modeller rutin olarak çok adımlı iş için 2-3× dönüş alır — genel olarak daha fazla maliyete neden olur. İnceleyenler ve nesne açıklamalarından çalışan uygulayıcılar için bir taban olarak orta seviye model kullanın. Görevin plan metni yazılacak tam kodu içerdiğinde, uygulama transkripsiyon ve testtir: bu uygulayıcı için en ucuz seviyeyi kullanın. Tek dosya mekanik düzeltmeler de en ucuz seviyeyi alır.
Görev karmaşıklığı sinyalleri (uygulama görevleri):
Uygulayıcı alt ajanları dört durumdan birini bildirirler. Her birini uygun şekilde işleyin:
DONE: İnceleme paketini oluşturun (scripts/review-package BASE HEAD, bu becerinin dizininden — kaydetmiş olduğunuz commit öncesi BASE'i yazıyorsa benzersiz dosya yolunu yazdırır — asla HEAD~1 değil, bu sessizce multi-commit görevinin dışında hepsini bırakır), sonra yazdırılan yolla görev inceleyiciyi gönderin.
DONE_WITH_CONCERNS: Uygulayıcı işi tamamladı ama endişeler işaretledi. Devam etmeden önce endişeleri okuyun. Endişeler doğruluk veya kapsam hakkındaysa, gözden geçirmeden önce ele alın. Gözlemlerse (örneğin, "bu dosya büyülüyor"), not alın ve incelemesine devam edin.
NEEDS_CONTEXT: Uygulayıcının sağlanmayan bilgileri var. Eksik bağlamı sağlayın ve yeniden gönderin.
BLOCKED: Uygulayıcı görevi tamamlayamıyor. Engeli değerlendirin:
Asla bir yükseltmeyi yok saymayın veya aynı modeli değişiklik yapılmadan yeniden denemeye zorlamamayın. Uygulayıcı takılı olduğunu söyledi, bir şeyler değişmeli.
Görev inceleyici, "⚠️ Diff'ten doğrulanamıyor" öğelerini bildirebilir — değiştirilmemiş kodda yaşayan veya görevler arasında yayılan gereksinimler. Bunlar incelemenin geri kalanını bloke etmez, ancak görevi tamamlanmış olarak işaretlemeden önce her birini kendiniz çözmelisiniz: planı ve inceleyicinin eksik olduğu görev arası bağlamı tutarsınız. Bir öğeyi gerçek bir boşluk olarak onayladıysanız, başarısız spec incelemesi olarak yapın — uygulayıcıya geri gönderin ve yeniden gözden geçirin.
Görev başına incelemeler görev kapsamı kapılarıdır. Geniş inceleme bir kez, son dal incelemesinde gerçekleşir. Bir inceleyici şablonunu doldururken:
scripts/review-package BASE HEAD'ini çalıştırın ve inceleyiciye yazdırdığı dosya yolunu verin (veya bash olmadan: git log --oneline, git diff --stat ve aralık için git diff -U10, benzersiz adlandırılmış bir dosyaya yönlendirilir). Çıktı asla kendi bağlamınıza girmez ve inceleyici commit listesini, stat özetini ve tam diffi bağlamla birlikte bir Read çağrısında görür. Uygulayıcıyı göndermeden önce kaydettiğiniz BASE'ı kullanın — multi-commit görevleri sessizce kesenler HEAD~1 değil.scripts/review-package MERGE_BASE HEAD çalıştırın (MERGE_BASE = dalın başladığı commit, örneğin git merge-base main HEAD) ve yazdırılan yolu final inceleme dispatchına ekleyin, böylece final inceleyici git komutlarıyla yeniden türetmek yerine bir dosyayı okur.Bir dispatch komutuna yapıştırdığınız her şey — ve bir alt ajan geri yazdırdığı her şey — oturum geri kalanında ikamet eder ve her sonraki turda yeniden okunur. Yapıtları dosya olarak el değiştirin:
scripts/task-brief PLAN_FILE N'unu çalıştırın — görevin tam metnini benzersiz adlandırılmış bir dosyaya çıkarır ve yolu yazdırır. Briefin tek gereksinimler kaynağı kalması için dispatchi oluşturun. Dispatchınız şunları içermelidir: (1) bu görevin projede nereye sığdığına dair bir satır; (2) brief yolu, "bunu ilk oku — gereksinimlerindir, kelimesi kelimesine kullanacağınız tam değerleri" olarak tanıtılır; (3) briefin bilemeyeceği önceki görevlerden arayüzler ve kararlar; (4) briefte fark ettiğiniz belirsizliğin çözümü; (5) rapor dosyası yolu ve rapor sözleşmesi. Tam değerler (sayılar, magic string'ler, imzalar, test durumları) yalnızca brief'de görünür.…/task-N-brief.md → rapor …/task-N-report.md) ve dispatch komutuna koyun. Uygulayıcı orada tam raporu yazar ve yalnızca durum, commits, bir satırlık test özeti ve endişeleri döndürür.Konuşma belleği sıkıştırmada hayatta kalmaz. Gerçek oturumlarında, yerlerini kaybeden denetçiler tamamlanmış görev dizilerini yeniden gönderdiler — gözlenen tek en pahalı hata. İlerlemeyi yalnızca yapılacaklar listesinde değil, defter dosyasında takip edin.
cat "$(git rev-parse --git-path sdd)/progress.md". Orada tamamlanmış olarak listelenen görevler DONE'dır — onları yeniden göndermez; işaretlenmeyen ilk görevde devam edin.Task N: complete (commits <base7>..<head7>, review clean).git log'u kendi hatırlamanız üzerinde güvenin.You: Alt Ajan Yönlendirilen Geliştirme kullanarak bu planı yürütüyorum.
[Plan dosyasını bir kez okuyun: docs/superpowers/plans/feature-plan.md]
[Tüm görevler için yapılacaklar oluşturun]
Task 1: Hook kurulum betiği
[Task 1 için task-brief çalıştırın; brief + rapor yolları + bağlamla uygulayıcıyı gönderin]
Implementer: "Başlamadan önce - hook kullanıcı veya sistem düzeyinde kurulmalı mı?"
You: "Kullanıcı düzeyi (~/.config/superpowers/hooks/)"
Implementer: "Anladım. Şimdi uyguluyorum..."
[Daha sonra] Implementer:
- install-hook komutu uygulandı
- Testler eklendi, 5/5 geçti
- Kendi incelemesi: --force bayrağını kaçırdığımı buldum, ekledim
- Commit yapıldı
[review-package çalıştırın, yazdırılan yolla görev inceleyiciyi gönderin]
Task reviewer: Spec ✅ - tüm gereksinimler karşılandı, fazlası yok.
Güçlü taraflar: İyi test kapsamı, temiz. Sorunlar: Yok. Görev kalitesi: Onaylı.
[Task 1'i tamamlanmış olarak işaretleyin]
Task 2: Kurtarma modları
[Task 2 için task-brief çalıştırın; brief + rapor yolları + bağlamla uygulayıcıyı gönderin]
Implementer: [Sorular yok, ilerlemeye başlar]
Implementer:
- Doğrulama/onarım modları eklendi
- 8/8 testler geçti
- Kendi incelemesi: Hepsi iyi
- Commit yapıldı
[review-package çalıştırın, yazdırılan yolla görev inceleyiciyi gönderin]
Task reviewer: Spec ❌:
- Eksik: İlerleme raporlaması (spec diyor "her 100 öğede rapor et")
- Extra: --json bayrağı eklendi (talep edilmedi)
Issues (Important): Magic number (100)
[Tüm bulgularla fix alt ajanı gönderin]
Fixer: --json bayrağını kaldırdı, ilerleme raporlaması ekledi, PROGRESS_INTERVAL sabitini çıkarttı
[Görev inceleyici yeniden inceliyor]
Task reviewer: Spec ✅. Görev kalitesi: Onaylı.
[Task 2'yi tamamlanmış olarak işaretleyin]
...
[Tüm görevlerden sonra]
[Final code-reviewer'ı gönderin]
Final reviewer: Tüm gereksinimler karşılandı, birleştirmeye hazır
Bitti!
vs. Manual yürütme:
vs. Planları Yürütme:
Verimlilik kazanları:
Kalite kapıları:
Maliyeti:
Asla:
scripts/task-brief — verin)scripts/review-package BASE HEAD) ve dispatch komutunda yazdırılan yolu adlandırıngit log) kontrol edinAlt ajan soru sorarsa:
İnceleyici sorunlar bulursa:
Alt ajan görevde başarısız olursa:
Gerekli iş akışı beceriler:
Alt ajanların kullanması gerekir:
Alternatif iş akışı:
2 veya daha fazla bağımsız görevin paralel olarak yürütülebileceği ve aralarında state paylaşımı ya da sıralı bağımlılık olmadığı durumlarda kullanın.
Ayrı bir oturumda inceleme kontrol noktaları ile yürütülecek yazılı bir uygulama planınız olduğunda kullanın.
Herhangi bir hata, test başarısızlığı veya beklenmeyen davranışla karşılaştığınızda, çözüm önerisi sunmadan önce kullanın.
Herhangi bir feature ya da bugfix uygulamaya başlamadan önce kullanın.
Yeni beceriler oluştururken, mevcut becerileri düzenlerken veya dağıtımdan önce becerileri doğrularken kullanın.
Claude API / Anthropic SDK için referans — model kimlikleri, fiyatlandırma, parametreler, streaming, tool use, MCP, agents, caching, token sayma ve model migration hakkında bilgiler içerir. ÖNEMLİ — hedef dosyayı açmadan önce okuyun; Claude/Anthropic ile ilgili herhangi bir isim geçtiğinde (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*` vb.) bu referansı atlayın.