@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/commands/multi-agent/help.md

@@ -0,0 +1,422 @@
+---
+description: "Multi-agent pipeline usage guide — renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatibility)."
+---
+
+# 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 legacy prefs files where `outputLanguage` did not exist yet. Two valid values: `"en"` (default) and `"tr"`. If both fields 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; the user asked for a display, not a bilingual dump.
+
+---
+
+## 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
+
+------------------------------------------------------------
+
+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) — shown as visual cards in terminal:
+
+  Phase 0:   Init       -> The 8 steps above
+  Phase 1:   Analysis   -> Stack detection + codebase scan (Opus)
+  Phase 2:   Planning   -> Task breakdown + architecture review + Plan Approval Gate
+                          (clarification max 2 rounds + approval loop — normal mode only;
+                           skipped for --dev, autopilot, --dev autopilot)
+  Phase 3:   Dev        -> TDD: test -> code -> build (Sonnet) + build queue
+  Phase 4:   Review     -> Deterministic gates + parallel AI review + Opus triage
+                          (Claude Code: Opus + Sonnet · Copilot CLI: GPT-5.4 + Opus + Sonnet)
+  Phase 5:   Test       -> Optional: switch to branch, test in Xcode (skipped in --dev / autopilot)
+  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 cleanly).
+
+  Every step is logged. Error in any phase -> pause -> resume to continue.
+
+------------------------------------------------------------
+
+Modes:
+
+  (normal)             Full 8 phases, Sonnet dev, Plan Approval Gate active, parallel review + Opus triage
+  --dev                Fast: Init -> Dev(Opus) -> Commit -> Report (no plan gate)
+  --local              No worktree — works directly on local branch
+  autopilot            Skip all confirmations INCLUDING plan gate, auto commit/PR
+                       (EXCEPT Phase 7 channels menu — always pauses)
+  --dev autopilot      Fastest path
+  --local --dev        Local + fast (no worktree, no analysis/review, no plan gate)
+
+Dedicated commands (same as flags above):
+
+  /multi-agent:dev "task"                       = multi-agent "task" --dev
+  /multi-agent:autopilot "task"                 = multi-agent "task" autopilot
+  /multi-agent:dev-autopilot "task"             = multi-agent "task" --dev autopilot
+  /multi-agent:local "task"                     = multi-agent "task" --local
+  /multi-agent:local-autopilot "task"           = multi-agent "task" --local autopilot
+  /multi-agent:dev-local "task"                 = multi-agent "task" --dev --local
+  /multi-agent:dev-local-autopilot "task"       = multi-agent "task" --dev --local autopilot
+
+------------------------------------------------------------
+
+Status & Resume:
+
+  /multi-agent:status         List tasks across all projects (id, phase, branch, state)
+  /multi-agent:log [#id]      Show task log (defaults to most recent)
+  /multi-agent:resume [#id]   Resume a paused or failed task from where it stopped
+  /multi-agent:kill [#id]     Stop task + delete worktree (logs preserved)
+  /multi-agent:clear-logs     Clean global log directory
+  /multi-agent:purge          Worktree + logs — full reset (double confirm)
+
+Post-Hoc & Side-Channel:
+
+  /multi-agent:channels       Post multi-channel report (Jira / Confluence / Wiki / PR description)
+  /multi-agent:review         Parallel review of current diff only (no full pipeline)
+  /multi-agent:diff-explain   Map a Phase 4 triage finding back to specific diff lines
+  /multi-agent:search         Cross-task log search with smart ranking; --semantic queries triage corpus
+  /multi-agent:scan           Skill security scan against tiered pattern catalog
+  /multi-agent:refactor       Score project, draft an improvement plan, take approval, run dev + sync
+
+Setup & Maintenance:
+
+  /multi-agent:setup          First-run wizard — Keychain tokens + Git identity + language
+  /multi-agent:language [en|tr]   Show or set outputLanguage (promptLanguage stays English)
+  /multi-agent:stack <id>     Manually switch active skill set (ios / android / backend / frontend / fullstack / all)
+  /multi-agent:sync           Sync ecosystem (Claude Code + Copilot CLI + pipeline + website + remote-control)
+  /multi-agent:update         Pull latest pipeline + reinstall + run migrations
+  /multi-agent:delete         Uninstall pipeline from every CLI (Keychain tokens left intact, double confirm)
+
+------------------------------------------------------------
+
+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
+
+  Both follow the same flow after selection:
+    1. Branch selection (develop/release/main)
+    2. Mode: full pipeline or --dev
+    3. Autopilot: yes/no
+    4. Pipeline starts with the selected issue
+
+------------------------------------------------------------
+
+UI Testing (standalone — not part of pipeline phases):
+
+  /multi-agent:test                  Full simulator test (screenshot all screens)
+  /multi-agent:test "dark mode"      Dark mode bug test
+  /multi-agent:test "accessibility"  Accessibility audit (labels, tap targets, contrast)
+  /multi-agent:test "dynamic type"   Large text size test
+  /multi-agent:test "screenshot tr"  App Store screenshots in Turkish
+  /multi-agent:test "store-ready"    App Store guideline pre-flight check
+
+  Uses xcrun simctl / adb (native, no external app needed).
+  Booted simulator/emulator required. Auto-detects bundle ID from project.
+
+Manual Test (Phase 5 standalone — Xcode hint flow):
+
+  /multi-agent:manual-test           Checkout task branch, print Xcode/SourceTree hints,
+  /multi-agent:manual-test #N        wait for your "ok" / "fix: ..." verdict.
+
+------------------------------------------------------------
+
+Setup:
+
+  /multi-agent:setup
+
+  Interactive onboarding:
+  1. Dynamic Keychain Discovery — finds existing tokens by keyword
+  2. Token Mapping — maps found keys to services (preferences)
+  3. Jira Project Key — your team's key (MOBILE, APP, ENG, etc.)
+  4. Git Identity — corporate + personal (saved to preferences)
+  5. Missing Tokens — standard key names + ready-to-paste commands
+  6. Verify — re-scan, confirm ready
+
+------------------------------------------------------------
+
+Key Features:
+
+  Multi-Platform   iOS, Android, Backend, Frontend — auto-detected
+  Build Queue      xcodebuild/Gradle serialized with lock file — parallel safe
+  Stack Aware      Auto-detects iOS/Android/Python/Node/Go/Docker, loads matching skill set
+  Det. Gates       Build + lint + test + secret scan BEFORE AI review
+  Multi-Repo       Per-repo worktrees, per-repo identity, integration build before commit
+  Identity Routing Git identity auto-picked from repo origin URL (corporate vs personal)
+  Issue Safety     Never auto-closes issues (4 approvals required, GitHub + Jira)
+  Store Compliance /multi-agent:test "store-ready" runs 17-rule iOS audit (ITMS / Privacy Manifest /
+                   code signing / debug-tool leak / IPv6 / SDK list / etc.) and 21-rule Android audit
+  Bilingual        EN + TR — outputLanguage toggles assistant explanations; promptLanguage is locked en
+
+Quality & Telemetry (advisory, on by default — flip prefs.global.* to disable):
+
+  Diff Risk Score  Phase 4 Step 1.75 ranks files before reviewer dispatch (security paths,
+                   schema migrations, no-test-change, complexity delta) — heuristic, sub-second
+  Test Gap Report  Phase 5 Step 0 surfaces public symbols added in this branch with no paired test
+  Cost Breakdown   Phase 7 appends per-phase tokens (in/out) + estimated USD to agent-log.md
+  Triage Memory    Phase 7 ingests accepted/deferred/rejected findings into a per-repo corpus
+  Prior-Art Lookup Phase 1 + Phase 4 query the corpus for similar past findings, inject as context
+  Per-Persona      Reviewer/agent dispatch reads `preferredModel` from persona file; per-call override
+                   via PHASE_MODEL_OVERRIDE; falls back to opus
+
+------------------------------------------------------------
+
+Examples:
+
+  # Full pipeline with Jira (key configured during setup)
+  /multi-agent "MOBILE-12345"
+
+  # GitHub issue, fast mode, local
+  /multi-agent "#42" --dev --local
+
+  # Interactive launchers — browse and pick
+  /multi-agent:jira                    # Pick from my Jira issues
+  /multi-agent:issue                   # Pick from unassigned GitHub issues
+
+  # Free-text — any platform
+  /multi-agent "LoginView dark mode fix" --dev autopilot         # 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" --dev        # Frontend
+
+  # Review current diff only
+  /multi-agent:review
+
+------------------------------------------------------------
+
+Logs: $HOME/.claude/logs/multi-agent/{project}/{task-id}/
+```
+
+---
+
+## 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   Worktree yarat (default) ya da local branch (--local)
+
+------------------------------------------------------------
+
+Pipeline (Phase 0'dan sonra) — terminalde görsel kart olarak görünür:
+
+  Phase 0:   Init       -> Yukarıdaki 8 adım
+  Phase 1:   Analysis   -> Stack tespiti + codebase taraması (Opus)
+  Phase 2:   Planning   -> Task kırılımı + mimari inceleme + Plan Onay Kapısı
+                          (clarification max 2 tur + onay döngüsü — sadece normal mode;
+                           --dev, autopilot, --dev autopilot'ta skip)
+  Phase 3:   Dev        -> TDD: test -> kod -> build (Sonnet) + build queue
+  Phase 4:   Review     -> Deterministik kapılar + paralel AI review + Opus triage
+                          (Claude Code: Opus + Sonnet · Copilot CLI: GPT-5.4 + Opus + Sonnet)
+  Phase 5:   Test       -> Opsiyonel: branch'e geç, Xcode'da test (--dev / autopilot'ta skip)
+  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'deki channels menüsünde HER ZAMAN durur (30 dk timeout → session temiz biter).
+
+  Her adım loglanır. Herhangi bir fazdaki hata -> pause -> resume ile devam et.
+
+------------------------------------------------------------
+
+Modlar:
+
+  (normal)             Tam 8 faz, Sonnet dev, Plan Onay Kapısı aktif, paralel review + Opus triage
+  --dev                Hızlı: Init -> Dev(Opus) -> Commit -> Report (plan gate yok)
+  --local              Worktree yok — doğrudan local branch'te çalışır
+  autopilot            Plan gate dahil tüm onayları atla, otomatik commit/PR
+                       (İSTİSNA: Phase 7 channels menüsü — her zaman durur)
+  --dev autopilot      En hızlı yol
+  --local --dev        Local + hızlı (worktree yok, analiz/review yok, plan gate yok)
+
+Dedicated komutlar (yukarıdaki flag'lerin eşdeğeri):
+
+  /multi-agent:dev "task"                       = multi-agent "task" --dev
+  /multi-agent:autopilot "task"                 = multi-agent "task" autopilot
+  /multi-agent:dev-autopilot "task"             = multi-agent "task" --dev autopilot
+  /multi-agent:local "task"                     = multi-agent "task" --local
+  /multi-agent:local-autopilot "task"           = multi-agent "task" --local autopilot
+  /multi-agent:dev-local "task"                 = multi-agent "task" --dev --local
+  /multi-agent:dev-local-autopilot "task"       = multi-agent "task" --dev --local autopilot
+
+------------------------------------------------------------
+
+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:clear-logs     Global log dizinini temizle
+  /multi-agent:purge          Worktree + log'lar — tam reset (çift onay)
+
+Post-Hoc & Side-Channel:
+
+  /multi-agent:channels       Multi-channel rapor gönder (Jira / Confluence / Wiki / PR description)
+  /multi-agent:review         Sadece mevcut diff'i paralel review et (full pipeline yok)
+  /multi-agent:diff-explain   Phase 4 triage bulgusunu diff satırlarına eşle
+  /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:refactor       Projeyi skorla, iyileştirme planı çıkar, onay al, dev + sync çalıştır
+
+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:stack <id>         Aktif skill set'i manuel değiştir (ios / android / backend / frontend / fullstack / all)
+  /multi-agent:sync               Ekosistemi senkronize et (Claude Code + Copilot CLI + pipeline + website + remote-control)
+  /multi-agent:update             En son pipeline'ı çek + reinstall + migration çalıştır
+  /multi-agent:delete             Pipeline'ı tüm CLI'lerden kaldır (Keychain token dokunulmaz, çift onay)
+
+------------------------------------------------------------
+
+İ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. Mode: tam pipeline ya da --dev
+    3. Autopilot: evet/hayır
+    4. 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ı)
+  /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 "screenshot tr"  App Store screenshot seti (Türkçe locale)
+  /multi-agent:test "store-ready"    App Store guideline pre-flight kontrolü
+
+  xcrun simctl / adb kullanır (harici app gerekmez).
+  Booted simulator/emulator şart. Bundle ID proje'den otomatik algılanır.
+
+Manuel Test (Phase 5 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.
+
+------------------------------------------------------------
+
+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, Frontend — otomatik tespit
+  Build Queue      xcodebuild/Gradle lock file ile seri — parallel güvenli
+  Stack Aware      iOS/Android/Python/Node/Go/Docker algılanır, eşleşen skill set yüklenir
+  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 için 17 kurallık audit (ITMS / Privacy Manifest /
+                   code signing / debug-tool leak / IPv6 / SDK list / vb.) + Android için 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 4 Step 1.75 reviewer dispatch'tan önce dosyaları sıralar (güvenlik path'leri,
+                   schema migration, test eklenmemiş değişiklik, complexity delta) — heuristik, saniyenin altı
+  Test Gap Report  Phase 5 Step 0 — bu branch'te eklenmiş public sembol + eşleşen test yoksa raporlar
+  Cost Breakdown   Phase 7 agent-log.md'ye faz başına token (in/out) + tahmini USD ekler
+  Triage Memory    Phase 7 accepted/deferred/rejected bulguları repo başına corpus'a yazar
+  Prior-Art Lookup Phase 1 + Phase 4 corpus'tan benzer geçmiş bulgu sorgular, ek context olarak enjekte
+  Per-Persona      Reviewer/agent dispatch persona dosyasından `preferredModel` okur;
+                   per-call override PHASE_MODEL_OVERRIDE ile; fallback opus
+
+------------------------------------------------------------
+
+Örnekler:
+
+  # Jira ile tam pipeline (key setup'ta yapılandırıldı)
+  /multi-agent "MOBILE-12345"
+
+  # GitHub issue, hızlı mode, local
+  /multi-agent "#42" --dev --local
+
+  # İ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 "LoginView dark mode fix" --dev autopilot         # 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" --dev        # Frontend
+
+  # Sadece mevcut diff'i review et
+  /multi-agent:review
+
+------------------------------------------------------------
+
+Log'lar: $HOME/.claude/logs/multi-agent/{project}/{task-id}/
+```

package/pipeline/commands/multi-agent/issue.md

@@ -0,0 +1,79 @@
+---
+description: "List unassigned GitHub issues, pick one, auto-assign, and launch the multi-agent pipeline."
+argument-hint: "[autopilot] — optional: run the pipeline without confirmations"
+---
+
+# multi-agent issue — 4-Step Picker (Account → Repos → Issue → Dev Context)
+
+**Input**: $ARGUMENTS
+
+Fully interactive. Only one optional flag: `autopilot`.
+
+## Flow
+
+### [1/4] Pick account (`_account-picker`)
+
+```bash
+~/.claude/lib/account-resolver.sh --providers github
+```
+- AskUserQuestion
+- Output: `ACCOUNT_GH_OWNER` (prefix → owner mapping), `ACCOUNT_GH_TOKEN_KEY`
+
+### [2/4] Pick repos (multi-select)
+
+```bash
+~/.claude/lib/repo-cache.sh github "$ACCOUNT_GH_OWNER"
+```
+- Show via AskUserQuestion (multiSelect=true)
+- cwd repo defaults to `[x]` when present
+- Output: `SELECTED_REPOS=[{fullName, cloneUrl}, ...]`
+
+### [3/4] Pick issue (aggregate)
+
+```bash
+for repo in "${SELECTED_REPOS[@]}"; do
+  gh issue list --repo "$repo" --state open --assignee "" \
+    --json number,title,labels --limit 50
+done | python3 -c '
+import json, sys
+items=[]
+for line in sys.stdin: items += json.loads(line)
+for i in items:
+    labels=",".join(l["name"] for l in i.get("labels",[]))
+    if "implemented" in labels.lower() or "in progress" in labels.lower(): continue
+    print(f"#{i[\"number\"]} — {i[\"title\"]}")
+'
+```
+- AskUserQuestion (multiSelect=false)
+- Selected issue: `OWNER/REPO#N`
+- Auto `gh issue edit --add-assignee @me` (optional, with confirm)
+
+### [3.5/4] Maturity check (auto)
+
+After selection, inspect `maturity` from `~/.claude/lib/issue-fetcher.sh` (same rule set as Jira):
+
+| Outcome | Behavior |
+|---|---|
+| `blockers` non-empty (e.g. `description_empty`, `status_closed`) | **Halt** (autopilot too): show summary, advise "fix the issue first" |
+| only `warnings` | AskUserQuestion: show summary + "Continue?". Autopilot auto-continues; warnings logged to `agent-log.md` |
+| both empty | Continue silently |
+
+`PROMPT_LANG=en` is passed to `issue-fetcher.sh` (`promptLanguage` is locked to `"en"`).
+
+### [4/4] Dev context (`_dev-context`)
+
+`~/.claude/lib/submodule-detector.sh --remote "$OWNER/$REPO"` → suggestions + extra repo list, multi-select.
+
+## Pipeline launch
+
+1. **Write picker state** to `/tmp/multi-agent-picker-{taskId}.json` (same shape as `jira.md`).
+2. **Bridge** → `~/.claude/lib/multi-repo-pipeline.sh bridge` writes `agent-state.json` v2.1.0.
+3. **Prepare worktrees** → `~/.claude/lib/multi-repo-pipeline.sh prepare`.
+4. **Phase 0 entry** consumes the bridged state, skipping redundant fetches.
+
+`autopilot` flag → `MULTI_AGENT_AUTOPILOT=1`.
+
+## Error paths
+
+- No repos under account → prompt for manual `owner/repo`
+- No open unassigned issues across selected repos → inform + suggest freetext

package/pipeline/commands/multi-agent/jira.md

@@ -0,0 +1,132 @@
+---
+description: "List open Jira issues, pick one, and launch the multi-agent pipeline."
+argument-hint: "[autopilot] — optional: run the pipeline without confirmations"
+---
+
+# multi-agent jira — 4-Step Picker (Account → Project → Issue → Dev Context)
+
+**Input**: $ARGUMENTS
+
+Fully interactive. Only one optional flag: `autopilot`.
+
+## Flow
+
+### [1/4] Pick account (`_account-picker`)
+
+```bash
+ACCOUNTS=$(~/.claude/lib/account-resolver.sh --providers jira)
+```
+- Show via AskUserQuestion
+- Output: `ACCOUNT_JIRA_TOKEN_KEY`, `ACCOUNT_JIRA_HOST`
+
+### [2/4] Pick Jira projects (multi-select)
+
+Fetch projects:
+```bash
+TOKEN=$(~/.claude/lib/credential-store.sh get "$ACCOUNT_JIRA_TOKEN_KEY")
+curl -s -H "Authorization: Bearer $TOKEN" \
+  "https://$ACCOUNT_JIRA_HOST/rest/api/2/project" \
+  | python3 -c 'import json,sys; [print(p["key"]+"\t"+p["name"]) for p in json.load(sys.stdin)]'
+```
+- AskUserQuestion (multiSelect=true)
+- Output: `JIRA_PROJECT_KEYS=PROJ,...`
+
+### [3/4] Pick issue (aggregate, priority-sorted)
+
+Combine open issues across selected projects, sort by priority + status:
+```bash
+JQL="assignee=currentUser() AND project in (${JIRA_PROJECT_KEYS}) AND resolution = EMPTY AND status not in (Done,Closed,Cancelled)"
+curl -s -H "Authorization: Bearer $TOKEN" \
+  "https://$ACCOUNT_JIRA_HOST/rest/api/2/search?jql=$(printf '%s' "$JQL" | python3 -c 'import sys,urllib.parse; print(urllib.parse.quote(sys.stdin.read()))')&fields=key,summary,status,issuetype,priority,resolution,fixVersions&maxResults=50"
+```
+
+> **Filter**: `resolution = EMPTY` excludes already-resolved issues at JQL level. If a listed issue still surfaces a maturity blocker, the issue is marked resolved in Jira but stuck in `In Progress` — show user a hint.
+
+**Sort order (descending precedence)**:
+1. `priority` → Blocker(100) > Critical(90) > High(80) > Medium(50) > Low(30) > Lowest(10) > (none=0)
+2. `status` → "In Progress" > "In Review" > "To Do" > others
+3. `created` → newest first
+
+**Format** (priority badge prefix, status suffix):
+```
+[3/4] Pick issue (24 found, priority-sorted):
+  > [Blocker] PROJ-12345 — Login crash on iOS 17           (In Progress)
+    [Critical] PROJ-12340 — Payment fails for refunds       (In Review)
+    [High]    PROJ-12338 — Dark mode polish                 (To Do)
+    [Medium]  PROJ-12330 — Add empty state                  (To Do)
+    [—]       PROJ-12300 — Refactor LoginViewModel          (To Do)
+```
+
+- AskUserQuestion (multiSelect=false)
+- Output: selected `KEY` (e.g. `PROJ-12345`)
+
+> **Rule**: Sort by priority for visibility, but don't force the user. No "P1 must come first" coercion — just signal.
+
+### [3.5/4] Maturity check (auto)
+
+After issue selection, inspect `maturity` from `~/.claude/lib/issue-fetcher.sh`:
+
+```jsonc
+"maturity": {
+  "score":    0..100,
+  "blockers": ["status_closed", "already_resolved", "description_empty"],
+  "warnings": ["short_description", "no_repro_steps", "no_acceptance_criteria"],
+  "summary":  "..."
+}
+```
+
+| Outcome | Behavior |
+|---|---|
+| `blockers` non-empty | **Halt** (autopilot too): show summary, advise "fix the issue first" |
+| only `warnings` | AskUserQuestion: show summary + "Continue?". Autopilot auto-continues; warnings logged to `agent-log.md` |
+| both empty (score ≥ 90) | Continue silently |
+
+> **Resolution check**: If Jira `resolution` is set (`Fixed`, `Done`, `Won't Do`, `Resolved`...), `already_resolved` is added — the issue was closed already. To reopen, clear `resolution` in Jira first.
+
+> **fixVersions**: When `descriptor.fixVersions` is non-empty (e.g. `["v1.48.0"]`) and a matching `release/v1.48.0` branch exists in `prefs.projects[*].branches`, suggest that branch. Otherwise fall back to `develop`/cwd current.
+
+`PROMPT_LANG=en` is passed to `issue-fetcher.sh` (`promptLanguage` is locked to `"en"`).
+
+### [4/4] Dev context (`_dev-context`)
+
+`~/.claude/lib/submodule-detector.sh` → suggestions, then multi-select picker.
+
+## Pipeline launch
+
+1. **Write picker state** to `/tmp/multi-agent-picker-{taskId}.json`:
+   ```json
+   {
+     "taskId":"PROJ-12345-{timestamp}",
+     "shortId":<int>,
+     "branch":"<feature|bugfix>/PROJ-12345",
+     "baseBranch":"develop",
+     "issueRef":{...},
+     "primary":{"name":"...","cloneUrl":"...","provider":"github|bitbucket"},
+     "extras":[{...}],
+     "worktreeRoot":"~/.worktrees/PROJ-12345-{timestamp}",
+     "commitType":"<feat|fix>",
+     "identity":{"name":"...","email":"..."}
+   }
+   ```
+
+2. **Bridge to agent-state.json v2.1.0** — picker → Phase 0:
+   ```bash
+   ~/.claude/lib/multi-repo-pipeline.sh bridge /tmp/multi-agent-picker-{taskId}.json
+   # writes ~/.claude/logs/multi-agent/{primary}/{taskId}/agent-state.json
+   ```
+
+3. **Prepare worktrees**:
+   ```bash
+   ~/.claude/lib/multi-repo-pipeline.sh prepare /tmp/multi-agent-picker-{taskId}.json
+   ```
+
+4. **Phase 0 entry** — pipeline reads the bridged `agent-state.json` and skips
+   redundant Jira/GitHub fetches.
+
+`autopilot` arg → start with `MULTI_AGENT_AUTOPILOT=1`.
+
+## Error paths
+
+- No accounts → redirect to `setup` skill
+- Jira fetch fails → "wrong account?" → loop back to step [1/4]
+- No issues → inform user + suggest `freetext` mode

package/pipeline/commands/multi-agent/kill.md

@@ -0,0 +1,38 @@
+---
+description: "Stop the given task, then remove its worktree and branch. Asks for confirmation."
+argument-hint: "#id — task ID to delete (e.g. #2)"
+---
+
+# multi-agent kill — Stop and Delete Task
+
+**Input**: $ARGUMENTS
+
+Stop the task and remove its worktree + branch + logs. Destructive operation — always asks for confirmation.
+
+## Steps
+
+1. **Find the task** — parse `#N` or `{JIRA-KEY}-XXXXX` from the argument.
+
+2. **Show details** — print the task summary:
+   ```
+   ⚠️ Task to delete:
+   - ID: #3
+   - Jira: {JIRA-KEY}-12345
+   - Branch: feature/{JIRA-KEY}-12345-...
+   - Worktree: .worktrees/{JIRA-KEY}-12345/
+   ```
+
+3. **Get confirmation**: "Are you sure?"
+   - If not sure → cancel.
+
+4. **Delete**:
+   ```bash
+   git worktree remove .worktrees/{JIRA-KEY}-{id} --force
+   git branch -D {branch-name}
+   ```
+
+5. **Remote branch** — also ask: "Delete the remote branch too?"
+   - Yes → `git push origin --delete {branch-name}`
+   - No → local-only delete.
+
+6. **Confirm**: `❌ Task #N ({JIRA-KEY}-{id}) killed`