## Render when `LANG == "tr"` - Türkçe rehber ``` +----------------------------------+ | Multi-Agent Görev Orkestratörü | +----------------------------------+ 5 farklı girdi tipi desteklenir - hepsi aynı akışa girer: /multi-agent "{JIRA_KEY}-XXXXX" -> Jira ID /multi-agent "https://{JIRA_HOST}/browse/..." -> Jira URL /multi-agent "https://github.com/.../issues/N" -> GitHub Issue URL /multi-agent "#316" -> GitHub Issue # /multi-agent "bug/özellik açıklaması" -> Serbest metin ------------------------------ Nasıl Çalışır (Phase 0 - İnteraktif Akış): 1. PARSE Girdiyi sınıflandır, Jira/GitHub'dan bilgi çek 2. PROJECT $HOME taranır, projeler listelenir -> numarayla seç 3. BRANCH Remote branch'ler çekilir (develop* önde) -> seç 4. DESIGN? Figma URL'si ya da screenshot var mı? (opsiyonel) 5. BRANCH NAME bugfix/{jiraId} veya feature/{jiraId} -> onayla 6. GIT ID Kimlik seç (prefs'ten; birden fazla desteklenir) 7. INSTRUCTION .instructions/ varsa otomatik algıla (figma vs.) 8. WORKSPACE Branch nerede yaşayacak: worktree (default) ya da proje kökü ------------------------------ Pipeline (Phase 0'dan sonra) - terminalde görsel kart olarak görünür: Phase 0: Init -> Yukarıdaki 8 adım Phase 1: Plan -> Stack tespiti + codebase taraması, task kırılımı, mimari inceleme, Plan Onay Kapısı (Opus; max 2 clarification turu, sadece etkileşimli - autopilot'ta soracak kimse yok) Phase 2: Dev -> TDD: test -> kod -> build (Sonnet) + build queue, sonra Verify çıkış kapısı: build, lint, test, sır taraması. Build koşu başına BİR kez çalışır, log'u Review'a devreder Phase 3: Review -> Paralel AI review + Fable triage, sonra opsiyonel kullanıcı testi (Claude Code: Fable + Opus + Sonnet · Copilot: GPT-5.4 + Opus + Sonnet; kullanıcı testi etkileşimli yarısı: branch'e geç, Xcode'da test) Phase 4: Commit -> Commit -> push -> PR + issue body güncelleme (hiç auto-close yok) Phase 5: Report -> Channels dispatcher (PR · Jira · Confluence · Wiki, multi-select) + internal capture (agent-log · knowledge · memory) Autopilot Phase 5'teki channels menüsünde HER ZAMAN durur (30 dk timeout → session temiz biter). Tek pipeline. Her mod kendi faz setinin tamamını koşar: Plan -> Dev(Sonnet) -> Review -> Commit -> Report Bir koşunun maliyeti, kanıt oluşmadan alınan bir cevaba değil, görevin taşıdığı kanıta göre belirlenir. Her adım loglanır. Herhangi bir fazdaki hata -> pause -> resume ile devam et. ------------------------------ Modlar: Pipeline girişleri: /multi-agent "task" Worktree var /multi-agent:autopilot "task" Worktree var, soru yok Faz 0 Adım 5b branch'in nerede yaşayacağını sorar; bayrağı yok. autopilot plan kapısı ve çalışma alanı sorusu dahil her onayı atlar, otomatik commit/PR açar - İSTİSNA: Faz 5 channels menüsü, o her zaman durur. /multi-agent:resume [#id|jira-id] [autopilot] Yarım kalan işi sürdür: duran koşu ya da arkasında koşu olmayan branch (Review → Commit/PR → Report) ------------------------------ Status & Resume: /multi-agent:status Tüm projelerdeki task'ları listele (id, faz, branch, durum) /multi-agent:log [#id] Task log'unu göster (varsayılan: en son task) /multi-agent:resume [#id] Duraklamış / hata almış task'ı kaldığı yerden devam ettir /multi-agent:kill [#id] Task'ı durdur + worktree'yi sil (log'lar korunur) /multi-agent:steer #id "..." Koşan task'ı durdurmadan düzelt (sonraki fazda uygulanır) /multi-agent:prune-logs Task bazlı proje log'larını sil (audit + metrics korunur; yaş/proje/task filtresi, önce dry-run) /multi-agent:prune-prompts Sıfır-tabanlı prompt incelemesi: sürekli yüklü talimat yükünü ölç, kural başına tut/dene/sil öner (önce rapor, onayla uygula) /multi-agent:garbage-collect Koşu artığını süpür; --abandoned durmuş koşuları toplar /multi-agent:purge Worktree + log'lar - tam reset (çift onay) /multi-agent:autopilot-on Bu makinede sürekli mod: repo seç, etiketli maddeler PR'a kadar koşar /multi-agent:autopilot-status Koşan, sıradaki, cevap bekleyen, bugünkü PR'lar /multi-agent:autopilot-off Yeni madde alma (koşan iş biter; --now onu da durdurur) /multi-agent:serve İstemci için sözleşme sunucusu: 127.0.0.1, token, boşta durur Post-Hoc & Side-Channel: /multi-agent:channels Multi-channel rapor gönder (Jira / Confluence / Wiki / PR description) /multi-agent:feedback "mesaj" Bakımcıya bir şeyin bozulduğunu bildir; yalnızca yazdığın metin gider /multi-agent:review PR veya branch diff'ini paralel review et; URL yoksa -> açık GitHub/Bitbucket PR'larını seçtir /multi-agent:review-jira Jira maddesinin pipeline'a hazırlığını değerlendir -> eksikleri yorum olarak ekle /multi-agent:review-issue GitHub issue'nun pipeline'a hazırlığını değerlendir -> eksikleri yorum olarak ekle /multi-agent:analysis ["analysis-name"] Feature-spec analizi (Figma + Swagger + Confluence + repolar). Önce standardı sorar: global (23 bölümlük geliştirme dokümanı) veya kurumsal (IG→UC→FG gereksinim dokümanı). Stack opsiyonel; Referanslar kanıt kaydından üretilir /multi-agent:analysis-resolve [doc] Analiz dokümanının Bölüm 20 açık sorularını kaynak etiketli adaylarla teker teker çözer /multi-agent:research Maddenin boşluklarını sormadan önce tracker, doküman ve repoda araştırır; neyin kapandığına gate karar verir /multi-agent:review-analysis [doc] Yazılmış analizi review eder; bulgular ihlal edilen kuralı gösterir /multi-agent:analysis-jira [doc] Nihai analiz -> Jira story ağacı; kapsam iki yönlü kontrol edilir, var olan düğümler atlanır /multi-agent:complaint-analysis ["run-adı"] Müşteri şikayeti triyajı: trx/conv id ile Graylog kanıtı + salt-okunur repo eşleştirme → kök neden + fix planı, veya core'a yönlendirme /multi-agent:build-optimize iOS-only Xcode build performance wrapper → benchmark + analiz + recommend-first .build-benchmark/optimization-plan.md /multi-agent:create-jira ["açıklama"] [figma-url] [swagger-url] Takım standartlarına uygun Jira Task/Bug/Story oluştur (tip, sprint, önizleme + onay) /multi-agent:diff-explain Phase 3 triage bulgusunu diff satırlarına eşle /multi-agent:estimate Benzer kapanmış işlerden efor aralığı: rol başına P25-P75, dayandığı ticket'larla /multi-agent:scenario-audit Test senaryolarını koda karşı denetle: VAR / KISMEN / YOK / BELİRSİZ, her VAR çözülen bir dosya:satır ile /multi-agent:graph Repo kod grafiğini kur ve sorgula (semboller, import'lar, referanslar), LLM'siz /multi-agent:search Task log'larında akıllı arama; --semantic triage corpus'unu sorgular /multi-agent:scan Skill güvenlik taraması (tiered pattern catalog) /multi-agent:security-review Bağımsız savunma amaçlı statik güvenlik incelemesi: tehdit modeli, OWASP + CWE + CVSS bulguları, bağımlılık envanteri. Canlı hedef yok. /multi-agent:doctor Burada bir koşu çalışır mı? Yerleşim, prefs, kimlik bilgileri, hook'lar; çıkış kodu kararı verir /multi-agent:refactor Uyarlanmış best-practice + bug avı + upstream-drift + multi-agent-toolkit MCP araştırması -> tek plan, onay, dev + sync /multi-agent:refactor backlog Pipeline'ın kendisi hakkında kaydedilmiş sürtünmeyi karara bağlar, sıfırdan türetmez /multi-agent:store-ready [repo] [flags] Yükleme öncesi store hazırlığı, iOS + Android, yalnızca lokal; atlanan kapı asla pass sayılmaz; build'i asla yayına göndermez. /multi-agent:testflight-validation [repo] [--ipa=|--archive=] :store-ready'nin iOS alias'ı. Aynı 3 kapı, tek implementasyon. /multi-agent:ios-coding-standard [modül] Bir iOS modülünü 99 kurallık kodlama-standardı registry'sine göre denetler -> düzeltme planı + tek sayfalık onboarding özeti -> /multi-agent'a devreder. Read-only, kaynağı hiç düzenlemez. Setup & Maintenance: /multi-agent:setup İlk kurulum sihirbazı - Keychain token + Git kimliği + dil /multi-agent:language [en|tr] outputLanguage'ı göster veya ayarla (promptLanguage İngilizce kalır) /multi-agent:model [on|off] Üst model basamağını (fable) aç/kapat; costBudget.pricingModel'i birlikte taşır /multi-agent:route-on Politika güdümlü model yönlendirmesini açar: strateji, kapsam, kurallar. Varsayılan kapalı /multi-agent:route-off Yönlendirmeyi kapatır, kuralları SAKLAR; route-on aynı şeyi tekrar sormaz /multi-agent:route-status Ne açık, hangi kural nerede geçerli, ve sınır: subagent'lar Anthropic'te kalır /multi-agent:stack [ids...] Stack plugin'lerini etkinleştir; çoklu seçim: id'ler yan yana (ios backend) ya da argümansız -> native picker (common hep açık) /multi-agent:scaffold Toolkit'in scaffold skill'i ile yeni proje; ilk commit'ten önce yeşil, uzak repo yok /multi-agent:sync Ekosistemi senkronize et (Claude Code + Copilot CLI + pipeline + website + multi-agent-toolkit MCP) /multi-agent:update En son pipeline'ı çek + reinstall + migration çalıştır /multi-agent:uninstall Pipeline'ı tüm CLI'lerden kaldır (--all-data ayar, log, hafıza + bilgi tabanını da siler; token'a dokunulmaz) ------------------------------ Plugin'ler ve tool'lar (doğrudan çağrılır, sarmalayıcı yok): Stack plugin ai--toolkit:, örn. ai-ios-toolkit:create-component Katalog: ai--toolkit:help Repo bazında aç: /multi-agent:stack (common + analyst hep açık) Toolkit MCP multi-agent-toolkit - ÇALIŞAN uygulama için 80+ tool, pipeline koşusu gerektirmez: ios_* / android_* (başlat, tap, screenshot, ui ağacı, log, crash, locale, koyu mod), web_*, design_* (yukarıdaki Design Check), ve denetimler (ios_app_store_audit, ios_testflight_validate, android_apk_audit, *_accessibility_audit). Ekrandaki durumu tahmin etmek yerine bunları kullan. Kaydı uninstall'dan sağ çıkar. Kayıtlı değilse sessizce devre dışı. ------------------------------ Rutinler (kendi tekrar eden işlerin): /multi-agent:save [ad] Sık yaptığın bir işi yeniden kullanılabilir /multi-agent: komutu olarak kaydet /multi-agent:routines Kayıtlı rutinlerini ve ne yaptıklarını listele /multi-agent:forget [ad] Kayıtlı bir rutini kaldır ------------------------------ İnteraktif Launcher'lar: /multi-agent:jira BENİM açık Jira issue'larımı listele → seç → branch → mode → başla /multi-agent:issue ATANMAMIŞ GitHub issue'ları listele → seç → auto-assign → başla İkisi de seçim sonrası aynı akışı takip eder: 1. Branch seçimi (develop/release/main) 2. Autopilot: evet/hayır 3. Pipeline seçilen issue ile başlar ------------------------------ UI Testing (standalone - pipeline fazlarından bağımsız): /multi-agent:test Tam simulator testi (tüm ekran screenshot'ları) Sabit-senaryo komutları - tırnak gerekmez, `test-` ile autocomplete'e düşer: /multi-agent:test-dark-mode Dark mode bug testi /multi-agent:test-accessibility Erişilebilirlik denetimi (label/tap-target/kontrast) /multi-agent:test-dynamic-type Büyük metin boyutu testi /multi-agent:test-screenshots [tr] Belirtilen dilde App Store screenshot seti (default tr) Senaryo etiketli form çalışır; yukarıdaki her komut onun alias'ı. /multi-agent:test "dark mode" | "accessibility" | "dynamic type" | "screenshot " `store-ready` bir UI testi DEĞİL: üretilmiş paketi platform başına üç kapıdan geçirerek doğrular, iOS + Android, ve /multi-agent:store-ready altında. Eski /multi-agent:test "store-ready" [path] etiketi çalışır ve oraya devreder. /multi-agent:bug-bash [kapsam] Charter ve persona başına bütçeli paralel keşif oturumları; bulgu, sebebiyle fail olan bir repro testi varsa raporlanır xcrun simctl / adb kullanır (harici app gerekmez). Booted simulator/emulator şart. Bundle ID proje'den otomatik algılanır. Manuel Test (Phase 3 kullanıcı-testi adımı, standalone - Xcode hint akışı): /multi-agent:manual-test Task branch'ine checkout, Xcode/SourceTree hint basar, /multi-agent:manual-test #N "ok" / "fix: ..." yanıtını bekler. Design Check (mock-mod vs Figma, yalnızca lokal): /multi-agent:design-check Tüm modül denetimi: her state sürücüsünü sayılabilir hedef kümesine çıkar, worktree'de Debug derle, her hedefi mock modda sür, Figma frame'iyle diff'le, HTML+PDF raporu ~/DesignChecks'e yaz. /multi-agent:design-check Tek ekrana kapsa (örn. order-status). /multi-agent:design-check Tek varyanta kapsa (örn. order-status@expired). /multi-agent:design-check URL'lerin işaret ettiği frame'lere kapsa. /multi-agent:design-check --resume Son koşunun denetlenmemiş kalanını denetle. # KAPSAM GEÇİDİ: her hedef ya denetlenir ya da SOMUT gerekçeyle atlanır; başka her durum eksik hedef # id'leriyle EKSİK raporlanır. "Senaryo/launch-arg gerektirir" gerekçe değil, oraya ulaşmak koşunun işi. ------------------------------ Setup: /multi-agent:setup İnteraktif onboarding: 1. Dynamic Keychain Discovery - mevcut token'ları keyword ile bulur 2. Token Mapping - bulunanları servislere eşler (prefs) 3. Jira Project Key - takımının key'i (MOBILE, APP, ENG vb.) 4. Git Kimliği - kurumsal + kişisel (prefs'e kaydedilir) 5. Eksik Token'lar - standart key isimleri + ready-to-paste komutlar 6. Doğrulama - yeniden tarama, hazır mı kontrol ------------------------------ Temel Özellikler: Multi-Platform iOS, Android, Backend, Web - otomatik tespit Build Queue xcodebuild/Gradle lock file ile seri - parallel güvenli Stack Aware iOS/Android/Python/Node/Go/Docker algılanır, etkin stack plugin'inin skilleri kullanılır Det. Gates AI review'dan ÖNCE build + lint + test + secret scan Multi-Repo Repo başına worktree, repo başına identity, commit öncesi entegrasyon build'i Identity Routing Repo origin URL'sinden git kimliği seçimi (kurumsal vs kişisel) Issue Safety Issue'lar asla auto-close edilmez (GitHub + Jira için 4 onay gerekir) Store Compliance /multi-agent:test "store-ready" - iOS 18 kurallık audit (ITMS / Privacy Manifest / signing / debug leak / IPv6 / SDK) + Android 21 kurallık audit Bilingual EN + TR - outputLanguage assistant açıklamasını değiştirir; promptLanguage en kilitli Quality & Telemetry (advisory, default açık - prefs.global.* ile kapatılabilir): Diff Risk Score Phase 3 Step 1.75 reviewer dispatch'tan önce dosyaları sıralar - heuristik: güvenlik path'i, schema migration, testsiz değişiklik, complexity delta Test Gap Report Phase 3 - bu branch'te eklenmiş public sembol + eşleşen test yoksa raporlar Cost Breakdown Phase 5 agent-log.md'ye faz başına token (in/out) + tahmini USD ekler Triage Memory Phase 5 accepted/deferred/rejected bulguları repo başına corpus'a yazar Prior-Art Lookup Phase 1 + Phase 3 corpus'tan benzer geçmiş bulgu sorgular, ek context olarak enjekte Per-Persona Dispatch persona dosyasından `preferredModel` okur; per-call override PHASE_MODEL_OVERRIDE; merdiven fable -> opus -> sonnet -> haiku ------------------------------ Örnekler: # Jira ile tam pipeline (key setup'ta yapılandırıldı) /multi-agent "MOBILE-12345" # İnteraktif launcher'lar - göz at ve seç /multi-agent:jira # Jira issue'larımdan seç /multi-agent:issue # Atanmamış GitHub issue'lardan seç # Serbest metin - herhangi bir platform /multi-agent:autopilot "LoginView dark mode fix" # iOS /multi-agent "Add pagination to /api/users endpoint" # Backend /multi-agent "Fix bottom nav recomposition in HomeScreen" # Android /multi-agent "Responsive layout broken on tablet" # Web # Sadece mevcut diff'i review et /multi-agent:review # Takım standartlarına uygun Jira issue oluştur (oluşturmadan önce önizleme + onay) /multi-agent:create-jira "Profil ekranı empty state" https://figma.com/design/abc?node-id=1-2 ------------------------------ Log'lar: $HOME/.claude/logs/multi-agent/{project}/{task-id}/ ```