--- name: multi-agent-help language: en description: "Multi-agent pipeline usage guide - renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatibility). Use when asked what the pipeline can do, which mode to pick, or what a command means." user-invocable: true argument-hint: "[topic] - optional; calling with no argument prints the full guide in the user's language" --- # multi-agent-help Called with no args or `help`, show the usage guide in the user's preferred language. ## Language resolution Help is the assistant's own explanation to the user - render it in `prefs.global.outputLanguage`. Fall back to `prefs.global.promptLanguage` for prefs written before v8.2.0. Two valid values: `"en"` (default) and `"tr"`. If both are missing / malformed → treat as `"en"`. ```bash PREFS="$HOME/.claude/multi-agent-preferences.json" LANG=$(jq -r '.global.outputLanguage // .global.promptLanguage // "en"' "$PREFS" 2>/dev/null || echo "en") ``` Render **exactly one** of the two blocks below - the one matching `LANG`. Do not print both. --- ## Render when `LANG == "en"` - English guide ``` +----------------------------------------------------------+ | Multi-Agent Task Orchestrator | +----------------------------------------------------------+ 5 different input types supported - all enter the same flow: 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/feature description" -> Free-text (Copilot CLI uses the dash form: multi-agent-local, multi-agent-channels, etc. Claude Code uses colon form: /multi-agent:local, /multi-agent:channels, etc.) ------------------------------------------------------------ How It Works (Phase 0 - Interactive Flow): 1. PARSE Classify input, fetch info from Jira/GitHub 2. PROJECT $HOME scanned, projects listed -> select by number 3. BRANCH Remote branches fetched (develop* first) -> select 4. DESIGN? Any Figma URL or screenshot? (optional) 5. BRANCH NAME bugfix/{jiraId} or feature/{jiraId} -> confirm 6. GIT ID Select identity from preferences (multiple supported) 7. INSTRUCTION Auto-detect if .instructions/ exists (figma etc.) 8. WORKSPACE Create worktree (default) or local branch (--local) ------------------------------------------------------------ Pipeline (after Phase 0): Phase 0: Init -> The 8 steps above Phase 1: Analysis -> Stack detection + codebase scan (Fable) Phase 2: Planning -> Task breakdown + architecture review + Plan Approval Gate Phase 3: Dev -> TDD: test -> code -> build (Sonnet) + build queue Phase 4: Review -> Deterministic gates + parallel AI review + Fable triage (Claude Code: Fable + Sonnet · Copilot CLI: GPT-5.4 + Opus + Sonnet) Phase 5: Test -> Optional: switch to branch, test in Xcode Phase 6: Commit -> Commit -> push -> PR + issue body update (never auto-closes) Phase 7: Report -> Channels dispatcher (PR · Jira · Confluence · Wiki, multi-select) + internal capture (agent-log · knowledge · memory) Autopilot always pauses at the Phase 7 channels menu (30-min timeout → session ends). ------------------------------------------------------------ Modes: Depth is asked at Phase 0 Step 7.5, not passed as a flag: Full Analysis -> Plan -> Dev(Sonnet) -> Review -> Test -> Commit -> Report Short Dev(Opus, self-contained) -> Review -> Test -> Commit -> Report Recommended from taskType. Review is never skipped either way. --local No worktree - works directly on local branch autopilot Skip all confirmations, including the depth question, so it always runs Full (EXCEPT Phase 7 channels menu) Dedicated dash commands (Copilot): multi-agent-local, multi-agent-autopilot, multi-agent-local-autopilot Removed in v16.0.0: multi-agent-dev -> multi-agent + Short; multi-agent-dev-local -> multi-agent-local + Short; the two dev autopilot names have no equivalent (fast-plus-unattended no longer exists). ------------------------------------------------------------ Utility Commands (dash form on Copilot, colon form on Claude Code): /multi-agent:status List tasks across all projects /multi-agent:log [#id] Show task log /multi-agent:resume [#id] Resume a paused task /multi-agent:kill [#id] Delete worktree (logs preserved) /multi-agent:prune-logs Delete per-task logs (audit + metrics kept; dry-run first) /multi-agent:garbage-collect Sweep leftover /tmp scratch + worktree residue (dry-run first) /multi-agent:purge Worktree + logs - full reset (double confirm) /multi-agent:channels Post multi-channel report (Jira/Confluence/Wiki/PR) /multi-agent:review Review a PR or branch diff; no URL -> pick open GitHub/Bitbucket PRs /multi-agent:review-jira Grade a Jira issue's pipeline-readiness -> comment the gaps /multi-agent:review-issue Grade a GitHub issue's pipeline-readiness -> comment the gaps /multi-agent:analysis ["name"] Feature-spec analysis. Asks the standard first: global (23-section dev handoff) or corporate (IG→UC→FG requirements doc). Stack optional /multi-agent:analysis-resolve [doc] Resolve an analysis doc's open questions one at a time, with source-labeled candidates /multi-agent:review-analysis [doc | page | KEY] Review a written analysis: gates first, then parallel model review; findings cite the rule /multi-agent:feedback "msg" Tell the maintainer something broke; only your text is sent, shown before it goes /multi-agent:create-jira ["desc"] [figma-url] [swagger-url] Create a Jira Task/Bug/Story matching team conventions (asks type + preview + approval) /multi-agent:sync Sync ecosystem (Claude + Copilot + website) /multi-agent:setup Keychain tokens + Git identity + language onboarding /multi-agent:language [en|tr] Show or set prompt language /multi-agent:store-ready [repo] [--archive=|--ipa=|--aab=|--apk=] Pre-submission store readiness, iOS + Android, local-only. Three symmetric gates per platform: static package audit, the store's own validator, policy review vs source. Plus the running-app sweep. A skipped gate is never counted as a pass. Never uploads. /multi-agent:testflight-validation [repo] [--ipa=|--archive=] iOS-pinned alias of :store-ready. /multi-agent:ios-coding-standard [module] Audit an iOS module against the 99-rule coding-standard registry -> remediation plan + onboarding summary -> hand off to dev. ------------------------------------------------------------ Interactive Launchers: /multi-agent:jira List MY open Jira issues → pick → branch → mode → go /multi-agent:issue List UNASSIGNED GitHub issues → pick → auto-assign → go ------------------------------------------------------------ UI Testing (standalone): /multi-agent:test Full simulator test (screenshot all screens) Fixed-scenario commands - no quoting, and they autocomplete off `test-`: /multi-agent:test-dark-mode Dark mode bug test /multi-agent:test-accessibility Accessibility audit /multi-agent:test-dynamic-type Large text size test /multi-agent:test-screenshots [tr] App Store screenshot set in a locale (default tr) The scenario-tag form still works and is not deprecated - each command above is an alias for it. /multi-agent:test "dark mode" | "accessibility" | "dynamic type" | "screenshot " `store-ready` is NOT a UI test: it validates a built package, on iOS and Android, and lives at /multi-agent:store-ready. The old /multi-agent:test "store-ready" tag still works and hands off there. Manual Test (Phase 5 standalone - Xcode hint flow): /multi-agent:manual-test [#N] Checkout task branch, print Xcode/SourceTree hints. (Renamed from :test in v5.7.4.) Design Check (mock-mode vs Figma, local-only - multi-agent-toolkit-mcp design_* tools): /multi-agent:design-check Whole-module design audit: enumerate every state driver into a target set, /multi-agent:design-check drive each one in mock mode via idb, compare vs Figma (padding/width/spacing/ /multi-agent:design-check --resume font/color/component/localization), export HTML+PDF to ~/DesignChecks. Scope: empty=module / screen / screen@variant / target-id / Figma URL(s). COVERAGE GATE: a target is audited or skipped WITH a reason, else the run is reported INCOMPLETE. --resume covers the remainder of the last run. Unresolved frame → shows you the screenshot and asks for the node-id. Drives multi-agent-toolkit design_* : design_mock_detect / _scenario_inventory / _mock_launch / _ui_geometry / _visual_compare / _report. ------------------------------------------------------------ Setup: /multi-agent:setup 1. Dynamic Keychain Discovery 2. Token Mapping 3. Jira Project Key 4. Git Identity 5. Missing Tokens 6. Verify ------------------------------------------------------------ Key Features: Multi-Platform iOS, Android, Backend, Frontend - auto-detected Build Queue xcodebuild/Gradle serialized - parallel safe Stack Aware Auto-detects iOS/Android/Python/Node/Go/Docker Det. Gates Build + lint + test + secret scan BEFORE AI review Dual Submodule Multiple submodules simultaneously Issue Safety Never auto-closes issues Bilingual EN + TR - prompts, banners, and this help render in your language ------------------------------------------------------------ Logs: $HOME/.copilot/logs/multi-agent/{project}/{task-id}/ (Copilot) $HOME/.claude/logs/multi-agent/{project}/{task-id}/ (Claude) ``` --- ## 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 (Copilot CLI dash form kullanır: multi-agent-local, multi-agent-channels vb. Claude Code colon form kullanır: /multi-agent:local, /multi-agent:channels vb.) ------------------------------------------------------------ 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 8. WORKSPACE Worktree yarat (default) ya da local branch (--local) ------------------------------------------------------------ Pipeline (Phase 0'dan sonra): Phase 0: Init -> Yukarıdaki 8 adım Phase 1: Analysis -> Stack tespiti + codebase taraması (Fable) Phase 2: Planning -> Task kırılımı + mimari inceleme + Plan Onay Kapısı Phase 3: Dev -> TDD: test -> kod -> build (Sonnet) + build queue Phase 4: Review -> Deterministik kapılar + paralel AI review + Fable triage (Claude Code: Fable + Sonnet · Copilot CLI: GPT-5.4 + Opus + Sonnet) Phase 5: Test -> Opsiyonel: branch'e geç, Xcode'da test Phase 6: Commit -> Commit -> push -> PR + issue body güncelleme (hiç auto-close yok) Phase 7: Report -> Channels dispatcher (PR · Jira · Confluence · Wiki, multi-select) + internal capture (agent-log · knowledge · memory) Autopilot Phase 7 channels menüsünde HER ZAMAN durur (30 dk timeout → session biter). ------------------------------------------------------------ Modlar: Derinlik Faz 0 Adım 7.5'te sorulur, bayrakla geçilmez: Tam Analiz -> Plan -> Dev(Sonnet) -> Review -> Test -> Commit -> Report Kısa Dev(Opus, kendi kendine yeten) -> Review -> Test -> Commit -> Report taskType'a göre önerilir. Review iki durumda da atlanmaz. --local Worktree yok - doğrudan local branch'te çalışır autopilot Derinlik sorusu dahil tüm onayları atlar, bu yüzden her zaman Tam koşar (İSTİSNA: Phase 7 channels menüsü) Dedicated dash komutlar (Copilot): multi-agent-local, multi-agent-autopilot, multi-agent-local-autopilot v16.0.0'da kaldırıldı: multi-agent-dev -> multi-agent + Kısa; multi-agent-dev-local -> multi-agent-local + Kısa; iki dev autopilot adının birebir karşılığı yok (hızlı+gözetimsiz artık yok). ------------------------------------------------------------ Utility Komutları: /multi-agent:status Tüm projelerdeki task'ları listele /multi-agent:log [#id] Task log'unu göster /multi-agent:resume [#id] Duraklamış task'ı devam ettir /multi-agent:kill [#id] Worktree'yi sil (log'lar korunur) /multi-agent:prune-logs Task bazlı log'ları sil (audit + metrics korunur; önce dry-run) /multi-agent:garbage-collect /tmp artıkları + worktree residue süpür (önce dry-run) /multi-agent:purge Worktree + log'lar - tam reset (çift onay) /multi-agent:channels Multi-channel rapor gönder (Jira/Confluence/Wiki/PR) /multi-agent:review PR veya branch diff'ini review et; URL yoksa -> açık GitHub/Bitbucket PR seç /multi-agent:review-jira Jira maddesinin pipeline hazırlığını değerlendir -> eksikleri yorumla /multi-agent:review-issue GitHub issue hazırlığını değerlendir -> eksikleri yorumla /multi-agent:create-jira ["açıklama"] [figma-url] [swagger-url] Takım standartlarına uygun Jira Task/Bug/Story oluştur (tip sorar + önizleme + onay) /multi-agent:sync Ekosistemi senkronize et /multi-agent:setup Keychain token + Git kimliği + dil onboarding /multi-agent:language [en|tr] Prompt dilini göster veya ayarla /multi-agent:store-ready [repo] [--archive=|--ipa=|--aab=|--apk=] Yükleme öncesi store hazırlığı, iOS + Android, yalnızca lokal. Platform başına 3 simetrik kapı: statik paket denetimi, store'un kendi doğrulayıcısı, kaynağa karşı politika incelemesi. Artı çalışan-app sweep'i. Atlanan kapı asla pass sayılmaz. Asla yüklemez. /multi-agent:testflight-validation [repo] [--ipa=|--archive=] :store-ready'nin iOS'a sabitlenmiş alias'ı. /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ı + onboarding özeti -> dev'e devreder. ------------------------------------------------------------ İnteraktif Launcher'lar: /multi-agent:jira BENİM açık Jira issue'larımı listele → seç → başla /multi-agent:issue ATANMAMIŞ GitHub issue'ları → seç → auto-assign → başla ------------------------------------------------------------ UI Testing (standalone): /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 /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ışmaya devam eder, kaldırılmadı - yukarıdaki komutların her biri onun alias'ı. /multi-agent:test "dark mode" | "accessibility" | "dynamic type" | "screenshot " `store-ready` bir UI testi DEĞİL: üretilmiş paketi doğrular, iOS + Android, ve /multi-agent:store-ready altında. Eski /multi-agent:test "store-ready" etiketi çalışmaya devam eder ve oraya devreder. Manuel Test (Phase 5 standalone - Xcode hint akışı): /multi-agent:manual-test [#N] Task branch'ine checkout, Xcode/SourceTree hint basar. (v5.7.4'te :test'ten :manual-test'e rename.) Design Check (mock-mod vs Figma, yalnızca lokal - multi-agent-toolkit-mcp design_* tool'ları): /multi-agent:design-check Tüm modül tasarım denetimi: her state sürücüsünü hedef kümesine çıkar, /multi-agent:design-check her birini mock modda idb ile sür, Figma ile karşılaştır (padding/genişlik/ /multi-agent:design-check --resume spacing/font/renk/component/localization), HTML+PDF rapor ~/DesignChecks. Kapsam: boş=modül / ekran / ekran@varyant / target-id / Figma URL(leri). KAPSAM GEÇİDİ: hedef ya denetlenir ya da GEREKÇEYLE atlanır; aksi hâlde koşu EKSİK raporlanır. --resume son koşunun kalanını kapatır. Figma karşılığı bulunamazsa SANA screenshot'ı gösterip node-id sorar. Sürdüğü multi-agent-toolkit design_* : design_mock_detect / _scenario_inventory / _mock_launch / _ui_geometry / _visual_compare / _report. ------------------------------------------------------------ Setup: /multi-agent:setup 1. Dynamic Keychain Discovery 2. Token Mapping 3. Jira Project Key 4. Git Kimliği 5. Eksik Token'lar 6. Doğrulama ------------------------------------------------------------ Temel Özellikler: Multi-Platform iOS, Android, Backend, Frontend - otomatik tespit Build Queue xcodebuild/Gradle seri - parallel güvenli Stack Aware iOS/Android/Python/Node/Go/Docker otomatik Det. Gates AI review'dan ÖNCE build + lint + test + secret scan Dual Submodule Birden çok submodule eş zamanlı Issue Safety Issue'lar asla auto-close edilmez Bilingual EN + TR - prompt'lar, banner'lar ve bu help dilinize göre ------------------------------------------------------------ Log'lar: $HOME/.copilot/logs/multi-agent/{project}/{task-id}/ (Copilot) $HOME/.claude/logs/multi-agent/{project}/{task-id}/ (Claude) ```