@mmerterden/multi-agent-pipeline 14.1.0 → 14.2.1

package/pipeline/skills/.skills-index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "1.0.0",
-  "skillCount": 196,
+  "skillCount": 201,
   "entries": [
     {
       "name": "accessibility-compliance-accessibility-audit",
@@ -445,7 +445,7 @@
     },
     {
       "name": "firebase",
-      "description": "You're a developer who has shipped dozens of Firebase projects. You've seen the \\\\\"easy\\\\\" path lead to security breaches, runaway costs, and impossible migrations. You know Firebase is powerful, but you also know its sharp edges. Use when integrating or reviewing Firebase: auth, Firestore, function",
+      "description": "You're a developer who has shipped dozens of Firebase projects. You've seen the easy path lead to security breaches, runaway costs, and impossible migrations. You know Firebase is powerful, but you also know its sharp edges. Use when integrating or reviewing Firebase: auth, Firestore, functions, or ",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -857,15 +857,6 @@
       "triggerPaths": [],
       "relativePath": "shared/core/multi-agent-diff-explain/SKILL.md"
     },
-    {
-      "name": "multi-agent-ship",
-      "description": "Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenario comment). No dev phase. Use when local work is already done and only review, build, commit and reporting remain.",
-      "platform": null,
-      "group": "core",
-      "triggerKeywords": [],
-      "triggerPaths": [],
-      "relativePath": "shared/core/multi-agent-ship/SKILL.md"
-    },
     {
       "name": "multi-agent-forget",
       "description": "Remove a saved /multi-agent routine (created by /multi-agent:save): deletes its local-only command and its registry entry. Asks which one and confirms. Use when a saved routine is no longer wanted and should be removed.",
@@ -1082,6 +1073,15 @@
       "triggerPaths": [],
       "relativePath": "shared/core/multi-agent-setup/SKILL.md"
     },
+    {
+      "name": "multi-agent-ship",
+      "description": "Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenario comment). No dev phase. Use when local work is already done and only review, build, commit and reporting remain.",
+      "platform": null,
+      "group": "core",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/core/multi-agent-ship/SKILL.md"
+    },
     {
       "name": "multi-agent-stack",
       "description": "Select the active stack for this repo by enabling the matching marketplace plugin(s) in .claude/settings.json (ios/android/mobile/backend/frontend/fullstack/all). Use when a repo's stack changed or the wrong plugins are enabled for it.",
@@ -1100,6 +1100,15 @@
       "triggerPaths": [],
       "relativePath": "shared/core/multi-agent-status/SKILL.md"
     },
+    {
+      "name": "multi-agent-store-ready",
+      "description": "Pre-submission store readiness for a built package, iOS and Android, local-only. Three symmetric gates per platform: a static package audit, the store's own authoritative validation, and a policy review against repo source. Separate verdict per gate, a skipped gate never counted as a pass. Validates",
+      "platform": null,
+      "group": "core",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/core/multi-agent-store-ready/SKILL.md"
+    },
     {
       "name": "multi-agent-sync",
       "description": "One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, pipeline repo, website, and the dev-toolkit MCP server. Use when work is finished and should be propagated across Claude Code, Copilot CLI, the repos, the website and the dev-toolkit server.",
@@ -1118,9 +1127,45 @@
       "triggerPaths": [],
       "relativePath": "shared/core/multi-agent-test/SKILL.md"
     },
+    {
+      "name": "multi-agent-test-accessibility",
+      "description": "Accessibility audit on a booted simulator / emulator: VoiceOver labels, sub-44pt tap targets, contrast, traits. Alias pinning the accessibility scenario. Use when auditing a screen for assistive-technology support.",
+      "platform": null,
+      "group": "core",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/core/multi-agent-test-accessibility/SKILL.md"
+    },
+    {
+      "name": "multi-agent-test-dark-mode",
+      "description": "Dark mode UI test on a booted simulator / emulator: walk every screen light then dark, report contrast + colour bugs. Alias pinning the dark-mode scenario. Use when a dark-mode rendering bug is suspected.",
+      "platform": null,
+      "group": "core",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/core/multi-agent-test-dark-mode/SKILL.md"
+    },
+    {
+      "name": "multi-agent-test-dynamic-type",
+      "description": "Dynamic Type layout test on a booted simulator / emulator: re-walk every screen at XL through accessibility-extra-large, report truncation and clipping. Alias pinning the dynamic-type scenario. Use when checking a layout survives large text.",
+      "platform": null,
+      "group": "core",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/core/multi-agent-test-dynamic-type/SKILL.md"
+    },
+    {
+      "name": "multi-agent-test-screenshots",
+      "description": "App Store screenshot set from a booted simulator / emulator in a given locale, taken as an argument and defaulting to tr. Alias pinning the screenshot scenario. Use when generating store screenshots or checking a localised build renders.",
+      "platform": null,
+      "group": "core",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/core/multi-agent-test-screenshots/SKILL.md"
+    },
     {
       "name": "multi-agent-testflight-validation",
-      "description": "Pre-submission validation for a TestFlight / App Store build (iOS, local-only). Three gates: static archive audit, Apple's own `altool --validate-app`, and a Review-Guidelines check. ITMS codes are mapped to the rule each implies. Validates only, never uploads. Use when a build is about to go to Tes",
+      "description": "iOS-pinned alias of store-ready: same three gates on an iOS build, one implementation. Validates a TestFlight / App Store package, never uploads. Use when an iOS build is about to go to TestFlight, or a submission was rejected and you need why.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],

package/pipeline/skills/shared/README.md

@@ -2,11 +2,11 @@
 
 Single source of truth for skills delivered to both Claude Code (`~/.claude/skills/`) and Copilot CLI (`~/.copilot/skills/`) by the installer.
 
-**Total:** 196 skills (47 core + 149 external). Auto-generated by `scripts/gen-skills-index.mjs`  -  do not edit by hand.
+**Total:** 201 skills (52 core + 149 external). Auto-generated by `scripts/gen-skills-index.mjs`  -  do not edit by hand.
 
 ## Directory layout
 
-- **`core/`**  -  47 `multi-agent*` orchestration skills that are pipeline-critical. Edits here are core-code changes.
+- **`core/`**  -  52 `multi-agent*` orchestration skills that are pipeline-critical. Edits here are core-code changes.
 - **`external/`**  -  149 iOS / Android / generic skills imported from the upstream skill library. Mirrors of third-party guidance.
 - Install destination stays flat: both trees flatten into `~/.claude/skills/` and `~/.copilot/skills/`. See ADR-0006 for the rationale.
 
@@ -14,7 +14,7 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 
 ## Categories
 
-- [Pipeline Orchestration](#pipeline-orchestration)  -  47
+- [Pipeline Orchestration](#pipeline-orchestration)  -  52
 - [iOS / Apple Ecosystem](#ios-apple-ecosystem)  -  89
 - [Android / Kotlin](#android-kotlin)  -  13
 - [Web / Frontend](#web-frontend)  -  10
@@ -40,7 +40,6 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`multi-agent-dev-local`](./core/multi-agent-dev-local/) | `core` | Fast mode + local  -  Init → Dev(Opus) → Review → Commit → Report, no worktree. Use when a change should be developed and reviewed on the cu |
 | [`multi-agent-dev-local-autopilot`](./core/multi-agent-dev-local-autopilot/) | `core` | Fastest + local  -  Dev(Opus) + autopilot, no worktree, zero interaction. Use when a change should be developed on the current branch with n |
 | [`multi-agent-diff-explain`](./core/multi-agent-diff-explain/) | `core` | Map Phase 4 triage findings to branch diff lines. Read-only post-hoc command, used after review to answer 'which finding lines up with which |
-| [`multi-agent-ship`](./core/multi-agent-ship/) | `core` | Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenari |
 | [`multi-agent-forget`](./core/multi-agent-forget/) | `core` | Remove a saved /multi-agent routine (created by /multi-agent:save): deletes its local-only command and its registry entry. Asks which one an |
 | [`multi-agent-garbage-collect`](./core/multi-agent-garbage-collect/) | `core` | Sweep leftover /tmp scratch (picker state, review diffs, channel payloads, analysis drafts) from past runs. Dry-run first; confirms before d |
 | [`multi-agent-help`](./core/multi-agent-help/) | `core` | Multi-agent pipeline usage guide  -  renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatib |
@@ -65,11 +64,17 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`multi-agent-scan`](./core/multi-agent-scan/) | `core` | Skill security scan: walks local skill directories against a tiered pattern catalog. Use when local skill directories need checking for unsa |
 | [`multi-agent-search`](./core/multi-agent-search/) | `core` | Log search across every agent-log.md with smart ranking and filters. Optional --semantic flag queries the per-repo triage corpus. Use when s |
 | [`multi-agent-setup`](./core/multi-agent-setup/) | `core` | First-run setup wizard: keychain token discovery, Git Identity onboarding, and pipeline preparation. Use when the pipeline is being set up f |
+| [`multi-agent-ship`](./core/multi-agent-ship/) | `core` | Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenari |
 | [`multi-agent-stack`](./core/multi-agent-stack/) | `core` | Select the active stack for this repo by enabling the matching marketplace plugin(s) in .claude/settings.json (ios/android/mobile/backend/fr |
 | [`multi-agent-status`](./core/multi-agent-status/) | `core` | Show every multi-agent task's ID, phase, branch, and status. Use when asked what is running, or for an overview of every task. |
+| [`multi-agent-store-ready`](./core/multi-agent-store-ready/) | `core` | Pre-submission store readiness for a built package, iOS and Android, local-only. Three symmetric gates per platform: a static package audit, |
 | [`multi-agent-sync`](./core/multi-agent-sync/) | `core` | One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, pipeline repo, website, and the dev-toolkit MCP server. Use whe |
 | [`multi-agent-test`](./core/multi-agent-test/) | `core` | UI Bug Hunter  -  iOS Simulator (simctl) + Android Emulator (adb). Auto-detects platform. Screenshot + tap + analyze on the booted device. T |
-| [`multi-agent-testflight-validation`](./core/multi-agent-testflight-validation/) | `core` | Pre-submission validation for a TestFlight / App Store build (iOS, local-only). Three gates: static archive audit, Apple's own `altool --val |
+| [`multi-agent-test-accessibility`](./core/multi-agent-test-accessibility/) | `core` | Accessibility audit on a booted simulator / emulator: VoiceOver labels, sub-44pt tap targets, contrast, traits. Alias pinning the accessibil |
+| [`multi-agent-test-dark-mode`](./core/multi-agent-test-dark-mode/) | `core` | Dark mode UI test on a booted simulator / emulator: walk every screen light then dark, report contrast + colour bugs. Alias pinning the dark |
+| [`multi-agent-test-dynamic-type`](./core/multi-agent-test-dynamic-type/) | `core` | Dynamic Type layout test on a booted simulator / emulator: re-walk every screen at XL through accessibility-extra-large, report truncation a |
+| [`multi-agent-test-screenshots`](./core/multi-agent-test-screenshots/) | `core` | App Store screenshot set from a booted simulator / emulator in a given locale, taken as an argument and defaulting to tr. Alias pinning the  |
+| [`multi-agent-testflight-validation`](./core/multi-agent-testflight-validation/) | `core` | iOS-pinned alias of store-ready: same three gates on an iOS build, one implementation. Validates a TestFlight / App Store package, never upl |
 | [`multi-agent-uninstall`](./core/multi-agent-uninstall/) | `core` | Uninstall the pipeline from Claude Code + Copilot CLI. Keychain access tokens are always left untouched; --all-data also clears pipeline set |
 | [`multi-agent-update`](./core/multi-agent-update/) | `core` | Update the pipeline to the latest version: git pull, install, migrate. Use when the installed pipeline is behind and should be brought to th |
 
@@ -97,7 +102,7 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`device-integrity`](./external/device-integrity/) | `external` | Verify device legitimacy and app integrity using DeviceCheck (DCDevice per-device bits) and App Attest (DCAppAttestService key generation, a |
 | [`energykit`](./external/energykit/) | `external` | Query grid electricity forecasts and submit load events using EnergyKit to help users optimize home electricity usage. Use when building sma |
 | [`eventkit-calendar`](./external/eventkit-calendar/) | `external` | Create, read, and manage calendar events and reminders using EventKit and EventKitUI. Use when adding events to the user's calendar, creatin |
-| [`firebase`](./external/firebase/) | `external` | You're a developer who has shipped dozens of Firebase projects. You've seen the \\"easy\\" path lead to security breaches, runaway costs, an |
+| [`firebase`](./external/firebase/) | `external` | You're a developer who has shipped dozens of Firebase projects. You've seen the easy path lead to security breaches, runaway costs, and impo |
 | [`healthkit`](./external/healthkit/) | `external` | Read, write, and query Apple Health data using HealthKit. Covers HKHealthStore authorization, sample queries, statistics queries, statistics |
 | [`hig-components-content`](./external/hig-components-content/) | `external` | Apple Human Interface Guidelines for content display components. Use when designing or reviewing how content is displayed on an Apple platfo |
 | [`hig-components-layout`](./external/hig-components-layout/) | `external` | Apple Human Interface Guidelines for layout and navigation components. Use when designing or reviewing layout and navigation on an Apple pla |

package/pipeline/skills/shared/core/multi-agent/SKILL.md

@@ -133,20 +133,16 @@ When `multi-agent kill [id]` is called:
 
 ---
 
-## Clear Logs
+## Clear Logs  -  superseded, redirect only
 
-When `multi-agent clear-logs` is called:
+`multi-agent clear-logs`: **do not run it.** Say it was superseded, then route to
+`multi-agent-prune-logs` (per-task logs, audit trail and metrics kept) or
+`multi-agent-garbage-collect` (`/tmp` scratch + worktree residue).
 
-1. **Confirm**: `"All task logs will be deleted (agent-log.md + agent-state.json). Worktrees and branches will be kept. Are you sure?"`
-2. **Scan**: Find all `.worktrees/PROJ-*/agent-log.md` and `agent-state.json` files
-3. **Delete**: Remove log and state files from each worktree
-4. **Do NOT reset counter**: `.worktrees/.multi-agent-counter` stays intact  -  prevents ID collision with existing worktrees
-5. **Confirm**:
-   ```
-   🧹 Logs cleared
-   Deleted: {N} agent-log.md + {N} agent-state.json
-   Worktrees & branches: untouched
-   ```
+It scanned `.worktrees/PROJ-*/`, which holds no logs  -  they live at
+`$HOME/.claude/logs/multi-agent/{project}/{task-id}/`  -  so it deleted nothing and
+reported success. The name stays as a redirect so an existing invocation still lands
+somewhere correct.
 
 ---
 
@@ -185,8 +181,8 @@ When `multi-agent purge` is called:
 
 When `multi-agent resume [id]` is called:
 
-1. **Find state file**: Scan `.worktrees/PROJ-{id}/agent-state.json`
-   - If no `id` given, find the most recent worktree with `status != "done"`
+1. **Find state file**: `$HOME/.claude/logs/multi-agent/{project}/{task-id}/agent-state.json`  -  that is where Phase 0 writes it, not inside the worktree. A task finalized by Phase 6 keeps its state at `.../{task-id}/artifacts/agent-state.json`, so look there too before reporting not-found.
+   - If no `id` given, take the most recent task dir with `status != "done"`
 2. **Read state**: Parse `agent-state.json` → determine last completed phase
 3. **Restore context**: Read `agent-log.md` for previous findings:
    - Phase 1 analysis findings → reuse in Phase 2+
@@ -397,8 +393,8 @@ Full contract: `refs/tracker-contract.md` section "TaskCreate ordering (strict)"
    git config user.name  "{identity.name}"
    git config user.email "{identity.email}"
    ```
-4. Create log file: `.worktrees/PROJ-{id}/agent-log.md` with header
-5. Create state file: `.worktrees/PROJ-{id}/agent-state.json` with:
+4. Create log file: `$HOME/.claude/logs/multi-agent/{project}/{task-id}/agent-log.md` with header
+5. Create state file: `$HOME/.claude/logs/multi-agent/{project}/{task-id}/agent-state.json` with:
    ```json
    {
      "taskId": "PROJ-12345",
@@ -589,7 +585,7 @@ Skip this sub-step if the task is NOT a component implementation (e.g., bug fix,
    ⏱️  Total: 3m 18s | Agents: 12 calls | Files: 4 changed
    📦 Commit: abc1234 | PR: #87
    📖 Wiki: {ComponentName}.md pushed to wiki master
-   📋 Full report: .worktrees/PROJ-{id}/agent-log.md
+   📋 Full report: ~/.claude/logs/multi-agent/{project}/{task-id}/agent-log.md
    ```
 3. Log: `📋 Phase 7: Report complete`
 

package/pipeline/skills/shared/core/multi-agent-help/SKILL.md

@@ -94,7 +94,8 @@ Utility Commands (dash form on Copilot, colon form on Claude Code):
   /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:clear-logs     Clean global log directory
+  /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
@@ -104,6 +105,13 @@ Utility Commands (dash form on Copilot, colon form on Claude Code):
   /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.
 
 ------------------------------------------------------------
 
@@ -117,11 +125,22 @@ Interactive Launchers:
 UI Testing (standalone):
 
   /multi-agent:test                  Full simulator test (screenshot all screens)
-  /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 "screenshot tr"  App Store screenshots in Turkish
-  /multi-agent:test "store-ready"    App Store guideline pre-flight check
+
+  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 <lang>"
+
+  `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):
 
@@ -243,7 +262,8 @@ Utility Komutları:
   /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:clear-logs     Global log dizinini temizle
+  /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ç
@@ -253,6 +273,13 @@ Utility Komutları:
   /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.
 
 ------------------------------------------------------------
 
@@ -266,11 +293,22 @@ Utility Komutları:
 UI Testing (standalone):
 
   /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
-  /multi-agent:test "dynamic type"   Büyük metin boyutu testi
-  /multi-agent:test "screenshot tr"  App Store screenshot (Türkçe locale)
-  /multi-agent:test "store-ready"    App Store guideline pre-flight
+
+  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 <dil>"
+
+  `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ışı):
 

package/pipeline/skills/shared/core/multi-agent-purge/SKILL.md

@@ -9,14 +9,29 @@ user-invocable: true
 
 Reset every multi-agent state. Nuclear option  -  requires double confirmation.
 
+Backed by `$HOME/.copilot/scripts/purge.sh`, which is safe by default (dry-run,
+deletes nothing until `--yes`), resolves every `rm` target strictly inside
+`<repo>/.worktrees/`, and never touches the main worktree or main/master/develop.
+
+Task log dirs are NOT purge territory  -  use `multi-agent-prune-logs`. The audit
+trail and metrics corpus at the log root are always preserved.
+
 ## Steps
 
-1. **Scan**  -  Find all worktrees:
+1. **Preview (dry-run)**  -  let the script enumerate; do not hand-roll a scan:
    ```bash
-   find {repo}/.worktrees/ -name "agent-state.json" -maxdepth 2
+   bash $HOME/.copilot/scripts/purge.sh
    ```
+   Nothing to remove -> report "nothing to purge" and stop.
+
+   **Never discover worktrees by looking for `agent-state.json` inside them.** That
+   was this skill's scan until v14.2.1 and it finds nothing: state lives at
+   `$HOME/.claude/logs/multi-agent/{project}/{task-id}/`, not in the worktree, so
+   the marker is absent from every real worktree. The scan returned zero while live
+   worktrees sat on disk, and purge reported "nothing to purge" as success. The
+   script enumerates `<repo>/.worktrees/*/` directly, which is why it works.
 
-2. **Show list**:
+2. **Show list** (the script prints it; this is the shape):
    ```
    ⚠️ WARNING: Will be deleted:
    - .worktrees/PROJ-133139/ (branch: feature/PROJ-133139-...)

package/pipeline/skills/shared/core/multi-agent-store-ready/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: multi-agent-store-ready
+language: en
+description: "Pre-submission store readiness for a built package, iOS and Android, local-only. Three symmetric gates per platform: a static package audit, the store's own authoritative validation, and a policy review against repo source. Separate verdict per gate, a skipped gate never counted as a pass. Validates only, never uploads. Use when a build is about to go to TestFlight or a Play track, or when a submission was rejected and the reason is not obvious."
+user-invocable: true
+argument-hint: "[repo]  -  empty = pick; repo name or path; --ipa= | --archive= | --aab= | --apk=; --skip-sweep; --resume"
+---
+
+# multi-agent-store-ready  -  pre-submission validation, iOS + Android
+
+Catch, before you upload, what App Store Connect or the Play Console would send
+back after you do.
+
+**Local-only.** No commits, no push, no PR. **It never uploads**: iOS runs
+`--validate-app`, never `--upload-app`; Android never commits a Play edit.
+
+**Input**: $ARGUMENTS
+
+## Dispatcher
+
+The full flow  -  input parsing, pickers, pre-flight, the running-app sweep, the
+three gates per platform, the report format and the next-action offer  -  lives in
+one place. Read and follow:
+
+```
+$HOME/.copilot/multi-agent/commands/store-ready.md
+```
+
+(Equivalent on Claude Code: `$HOME/.claude/commands/multi-agent/store-ready/SKILL.md`.)
+
+Do not re-derive the gate structure from this file; it is a summary, and the target
+doc is the contract.
+
+## Gate matrix (summary  -  the target doc is authoritative)
+
+| Gate | iOS | Android |
+|---|---|---|
+| 1 Static | `ios_app_store_audit` 18 rules, needs an `.xcarchive` | `android_apk_audit` + `google-play-compliance` 21 rules, needs an `.aab` |
+| 2 Authoritative | `ios_testflight_validate` → `altool --validate-app`, needs credentials | `SKIPPED`  -  Play's authoritative check is server-side only and no client ships here |
+| 3 Policy | `app-store-review` skill vs repo source | `play-store-review` skill vs repo source |
+
+Gate 2's asymmetry is reported as an asymmetry. An Android run clears at most 2 of 3
+gates and must never print `passed`. A skipped gate is never folded into the pass
+count on either platform.
+
+## Related surfaces
+
+`multi-agent-testflight-validation` is a thin alias onto this skill, kept so the
+iOS-only name keeps working; it resolves here with the platform pinned to iOS.
+`multi-agent-test "store-ready"` also resolves here. There is one implementation.

package/pipeline/skills/shared/core/multi-agent-sync/SKILL.md

@@ -31,7 +31,7 @@ Run all steps automatically:
 
 ```
 Step 1: DETECT      Compare timestamps, find stale targets
-Step 2: COPILOT     Claude Code -> Copilot CLI (instructions + 44 sub-command skills)
+Step 2: COPILOT     Claude Code -> Copilot CLI (instructions + 49 sub-command skills)
 Step 2b: CODEX      Claude Code -> Codex CLI (1 router skill + 44 specs as refs + 8 agent TOML)
 Step 3: REPO        Claude Code -> pipeline repo (genericized, personal data scrub)
 Step 3d: DEV-TOOLKIT Companion MCP server -> detect movement, ship gates, commit + publish
@@ -223,14 +223,15 @@ When invoked with the `release` argument:
 |-------------|-------------|
 | `~/.claude/commands/multi-agent/{cmd}.md` | `~/.copilot/skills/multi-agent-{cmd}/SKILL.md` |
 
-**44 commands are synced** (canonical inventory  -  must match `cross-cli-contract.md` section 1; drift = contract violation):
+**49 commands are synced** (canonical inventory  -  must match `cross-cli-contract.md` section 1; drift = contract violation):
 
 ```
 analysis, analysis-resolve, autopilot, build-optimize, channels, create-jira, design-check, dev,
 dev-autopilot, dev-local, dev-local-autopilot, diff-explain, forget, garbage-collect,
 help, ios-coding-standard, issue, jira, kill, language, local,
 local-autopilot, log, manual-test, prune-logs, purge, refactor, resume, review, review-issue, review-jira,
-routines, save, scan, search, setup, ship, stack, status, sync, test, testflight-validation, uninstall, update
+routines, save, scan, search, setup, ship, stack, status, store-ready, sync, test, test-accessibility,
+test-dark-mode, test-dynamic-type, test-screenshots, testflight-validation, uninstall, update
 ```
 
 **NOT synced**: `refs/*`  -  Lazy-load references, Claude Code specific

package/pipeline/skills/shared/core/multi-agent-test/SKILL.md

@@ -26,14 +26,24 @@ Pass `$ARGUMENTS` through verbatim  -  the target doc picks the right test matri
 
 ## Quick reference
 
-| Invocation | What it does |
-|---|---|
-| `multi-agent-test` | Walk all screens, collect screenshot + UI tree, general report |
-| `multi-agent-test "dark mode"` | Light/dark comparison, contrast + color bugs |
-| `multi-agent-test "accessibility"` | VoiceOver label + tap target + contrast audit |
-| `multi-agent-test "dynamic type"` | XL-XXXL text-size layout check |
-| `multi-agent-test "screenshot tr"` | App Store screenshot set (Turkish locale) |
-| `multi-agent-test "store-ready"` | App Store guideline pre-flight check |
+| Invocation | Fixed-scenario alias | What it does |
+|---|---|---|
+| `multi-agent-test` | - | Walk all screens, collect screenshot + UI tree, general report |
+| `multi-agent-test "dark mode"` | `multi-agent-test-dark-mode` | Light/dark comparison, contrast + color bugs |
+| `multi-agent-test "accessibility"` | `multi-agent-test-accessibility` | VoiceOver label + tap target + contrast audit |
+| `multi-agent-test "dynamic type"` | `multi-agent-test-dynamic-type` | XL-XXXL text-size layout check |
+| `multi-agent-test "screenshot <lang>"` | `multi-agent-test-screenshots [locale]` | App Store screenshot set in a locale (alias defaults to tr) |
+| `multi-agent-test "store-ready" [path]` | hands off to `multi-agent-store-ready` | package validation, not a UI test |
+
+Both columns are supported and neither is deprecated; the aliases exist so the
+scenario list autocompletes off `test-` instead of having to be remembered.
+
+`store-ready` is the odd one out: it validates a built **package** rather than a
+running app, so it is not implemented here at all. `multi-agent-store-ready` owns
+it on both platforms  -  three gates per platform, plus this file's sweep as its
+Step A. `multi-agent-testflight-validation` is the iOS-pinned alias of that skill.
+The quoted tag is kept as a hand-off so an existing invocation still lands
+somewhere correct.
 
 ## Requirements
 

package/pipeline/skills/shared/core/multi-agent-test-accessibility/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: multi-agent-test-accessibility
+language: en
+description: "Accessibility audit on a booted simulator / emulator: VoiceOver labels, sub-44pt tap targets, contrast, traits. Alias pinning the accessibility scenario. Use when auditing a screen for assistive-technology support."
+user-invocable: true
+argument-hint: "(no arguments  -  the scenario is fixed)"
+---
+
+# multi-agent-test-accessibility  -  Accessibility audit
+
+Fixed-scenario alias. The implementation is the UI Bug Hunter flow; this skill only
+pins the scenario so the tag does not have to be typed or quoted.
+
+## Dispatcher
+
+Read and follow:
+
+```
+$HOME/.copilot/multi-agent/sim-test.md
+```
+
+(Equivalent on Claude Code: `$HOME/.claude/commands/sim-test.md`.)
+
+Run it with **scenario = `accessibility`**. Ignore `$ARGUMENTS`; the scenario is fixed
+by the skill name. Anything the user adds is context for the report, never a scenario
+override  -  to run a different matrix they invoke that skill.
+
+## Equivalent
+
+`multi-agent-test "accessibility"`  -  identical behaviour. Both forms are supported;
+neither is deprecated.
+
+## Requirements
+
+- **iOS**: Xcode + booted Simulator (`xcrun simctl list | grep Booted`)
+- **Android**: Android SDK + running emulator or USB device (`adb devices`)
+- **MCP**: `dev-toolkit` MCP server registered (tool names start with `mcp__dev-toolkit__*`)

package/pipeline/skills/shared/core/multi-agent-test-dark-mode/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: multi-agent-test-dark-mode
+language: en
+description: "Dark mode UI test on a booted simulator / emulator: walk every screen light then dark, report contrast + colour bugs. Alias pinning the dark-mode scenario. Use when a dark-mode rendering bug is suspected."
+user-invocable: true
+argument-hint: "(no arguments  -  the scenario is fixed)"
+---
+
+# multi-agent-test-dark-mode  -  Dark mode UI test
+
+Fixed-scenario alias. The implementation is the UI Bug Hunter flow; this skill only
+pins the scenario so the tag does not have to be typed or quoted.
+
+## Dispatcher
+
+Read and follow:
+
+```
+$HOME/.copilot/multi-agent/sim-test.md
+```
+
+(Equivalent on Claude Code: `$HOME/.claude/commands/sim-test.md`.)
+
+Run it with **scenario = `dark mode`**. Ignore `$ARGUMENTS`; the scenario is fixed by
+the skill name. Anything the user adds is context for the report, never a scenario
+override  -  to run a different matrix they invoke that skill.
+
+## Equivalent
+
+`multi-agent-test "dark mode"`  -  identical behaviour. Both forms are supported;
+neither is deprecated.
+
+## Requirements
+
+- **iOS**: Xcode + booted Simulator (`xcrun simctl list | grep Booted`)
+- **Android**: Android SDK + running emulator or USB device (`adb devices`)
+- **MCP**: `dev-toolkit` MCP server registered (tool names start with `mcp__dev-toolkit__*`)

package/pipeline/skills/shared/core/multi-agent-test-dynamic-type/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: multi-agent-test-dynamic-type
+language: en
+description: "Dynamic Type layout test on a booted simulator / emulator: re-walk every screen at XL through accessibility-extra-large, report truncation and clipping. Alias pinning the dynamic-type scenario. Use when checking a layout survives large text."
+user-invocable: true
+argument-hint: "(no arguments  -  the scenario is fixed)"
+---
+
+# multi-agent-test-dynamic-type  -  Dynamic Type layout test
+
+Fixed-scenario alias. The implementation is the UI Bug Hunter flow; this skill only
+pins the scenario so the tag does not have to be typed or quoted.
+
+## Dispatcher
+
+Read and follow:
+
+```
+$HOME/.copilot/multi-agent/sim-test.md
+```
+
+(Equivalent on Claude Code: `$HOME/.claude/commands/sim-test.md`.)
+
+Run it with **scenario = `dynamic type`**. Ignore `$ARGUMENTS`; the scenario is fixed
+by the skill name. Anything the user adds is context for the report, never a scenario
+override  -  to run a different matrix they invoke that skill.
+
+## Equivalent
+
+`multi-agent-test "dynamic type"`  -  identical behaviour. Both forms are supported;
+neither is deprecated.
+
+## Requirements
+
+- **iOS**: Xcode + booted Simulator (`xcrun simctl list | grep Booted`)
+- **Android**: Android SDK + running emulator or USB device (`adb devices`)
+- **MCP**: `dev-toolkit` MCP server registered (tool names start with `mcp__dev-toolkit__*`)