@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/commands/multi-agent.md

@@ -0,0 +1,293 @@
+---
+description: "Task orchestrator — full pipeline via Jira ID + branch or GitHub Issue URL: analysis, plan, TDD development, parallel review + Opus triage (CLI-aware: 2-model on Claude Code, 3-model on Copilot CLI), commit, log"
+allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, WebFetch, WebSearch, NotebookEdit, Skill
+---
+
+# Multi-Agent Task Orchestrator
+
+Parse the user input and route to the correct sub-command.
+
+**Input**: $ARGUMENTS
+
+> **Language (read FIRST)**: Before any status output, read `prefs.global.outputLanguage` from `$HOME/.claude/multi-agent-preferences.json` and render every conversational line in it. `AskUserQuestion` and external payloads stay English. Full contract: `refs/rules.md` "Language Application".
+
+## Canonical Invocation (per CLI)
+
+Each helper subcommand has its own slash entry — use the CLI-native form:
+
+| Helper | Claude Code | Copilot CLI |
+|--------|-------------|-------------|
+| update | `/multi-agent:update` | `/multi-agent-update` |
+| setup  | `/multi-agent:setup`  | `/multi-agent-setup`  |
+| status | `/multi-agent:status` | `/multi-agent-status` |
+| sync   | `/multi-agent:sync`   | `/multi-agent-sync`   |
+| jira   | `/multi-agent:jira`   | `/multi-agent-jira`   |
+| issue  | `/multi-agent:issue`  | `/multi-agent-issue`  |
+| help   | `/multi-agent:help`   | `/multi-agent-help`   |
+| log, kill, resume, channels, test, ... | `/multi-agent:<name>` | `/multi-agent-<name>` |
+
+The space-form (`multi-agent <subcommand>`) is still routed by this dispatcher
+for backward compatibility, but the colon (Claude) / dash (Copilot) forms are
+the canonical invocations and the only forms surfaced in autocomplete.
+
+## Input Parsing
+
+Classification schema lives in `commands/multi-agent/_input-parser.md` — canonical source. Summary:
+
+| # | Pattern | Type | Picker flow |
+|---|---------|------|--------|
+| 1 | `#N` or bare `316` | `gh-num` | account → repo (single) → maturity → dev-context |
+| 2 | `repo#N` (e.g. `my-app#316`) | `gh-short` | account → maturity → dev-context |
+| 3 | `https://github.com/.../issues/N` | `gh-url` | account → maturity → dev-context |
+| 4 | `https://{JIRA_HOST}/browse/{JIRA_KEY}-N` | `jira-url` | account → maturity → dev-context |
+| 5 | `{JIRA_KEY}-N` (bare) | `jira-id` | account → maturity → dev-context |
+| 6 | `jira` | full picker | account → project (multi) → issue → maturity → dev-context |
+| 7 | `issue` | full picker | account → repo (multi) → issue → maturity → dev-context |
+| 8 | Free-text | `freetext` | account → repo (single) → dev-context (maturity skip) |
+
+**Rule**: Whatever the type, **account is always asked** (autopilot picks a default). After issue fetch, **maturity check is mandatory** — blockers halt the pipeline. All picker UI strings render in English (`promptLanguage` is locked to `en`).
+
+Lib scripts (`~/.claude/lib/`):
+- `account-resolver.sh` — keychain account inventory
+- `issue-fetcher.sh` — Jira/GitHub fetch + maturity scoring
+- `repo-cache.sh` — TTL-cached repo list
+- `submodule-detector.sh` — `.gitmodules` parse → dev-context suggestions
+- `multi-repo-pipeline.sh` — worktree/branch/commit/PR orchestration
+
+## Routing
+
+| Input Pattern | Action |
+|---------------|--------|
+| `#N`, `316` | GitHub Issue # — parse, select project, start pipeline |
+| `https://github.com/.../issues/N` | GitHub Issue URL — fetch, auto-detect or ask project |
+| `https://{JIRA_HOST}/browse/{JIRA_KEY}-XXXXX` | Jira URL — fetch, select project, start pipeline |
+| `{JIRA_KEY}-XXXXX` | Jira ID — fetch, select project, start pipeline |
+| Free-text | Bug/feature description — select project, start pipeline |
+| `jira` | 4-step picker (hesap → proje → issue → dev-context) — `commands/multi-agent/jira.md` delegate |
+| `issue` | 4-step picker (hesap → repo → issue → dev-context) — `commands/multi-agent/issue.md` delegate |
+| `status` | List all tasks (scan `$HOME/.claude/logs/multi-agent/`) |
+| `log [id]` | Show task log |
+| `resume [id]` | Resume paused task |
+| `kill [id]` | Delete worktree (logs preserved). Confirm first |
+| `clear-logs` | Clean global log directory. Keep counter |
+| `purge` | Worktree + logs + counter — full reset (double confirm) |
+| `review` | Review current diff only (lightweight, no worktree) |
+| `channels [PR-url\|#N\|Jira-url\|Jira-id] [--channels pr,jira,confluence,wiki] [--content normal,test,auto-diff,note] [--message "..."]` | Post task report to multi-select channels (PR description, Jira comment, Confluence page, Wiki pages) with multi-select content sources. Humanizer pass per-channel. Bitbucket PR updates use reviewer-preserving PUT. Phase 7 delegates to this command; also invocable post-hoc for fixes made outside the pipeline. No worktree. |
+| `test` or `test [args]` | UI Bug Hunter — screenshot + tap + analyze on booted simulator via MCP (read `$HOME/.claude/commands/sim-test.md`). `/multi-agent:test` also resolves here via the `commands/multi-agent/test.md` delegate. |
+| `manual-test [#id]` | Phase 5 standalone Manual Test — checks out the task branch, prints Xcode / SourceTree hints, waits for user verdict (`ok` / `fix: ...`). |
+| `stack [ios\|android\|backend\|mobile\|all]` | Swap skills for next conversation. No arg = show current stack. |
+| `language [en\|tr]` | Show or set the assistant `outputLanguage` (explanations and chat replies). `promptLanguage` is locked to `en` and is not toggleable. No arg = show current `outputLanguage`. With `en` or `tr` = set and persist `outputLanguage`. External payloads (commits, PR bodies, Jira) stay English. |
+| `setup` | Keychain token + Git Identity onboarding |
+| `--dev` | Dev-only: Init -> Dev(Opus) -> Commit -> Report |
+| `--dev autopilot` or `dev-autopilot` | Fastest path — Dev(Opus) + zero interaction |
+| `--local` | No worktree — works directly on local branch |
+| `autopilot` | Skip user confirmations, auto commit/PR |
+| No args / `help` | Show usage guide |
+
+---
+
+## Modular Loading
+
+This command uses lazy loading for token efficiency. Read the relevant sub-file based on the routed action:
+
+**File layout:**
+- `commands/multi-agent/*.md` → **invocable actions** (each gets its own `/multi-agent:<name>` slash command)
+- `commands/multi-agent/refs/**` → **internal references**, read by the main command, never invoked directly (surface as `/multi-agent:refs:...` in autocomplete — the prefix signals "not an action")
+
+| Route | File to Read |
+|-------|-------------|
+| Pipeline task (any input type) | `$HOME/.claude/commands/multi-agent/refs/phases.md` + `commands/multi-agent/_account-picker.md` + `_repo-picker.md` + `_dev-context.md` |
+| `jira` | `$HOME/.claude/commands/multi-agent/jira.md` (4-step picker) |
+| `issue` | `$HOME/.claude/commands/multi-agent/issue.md` (4-step picker) |
+| Direct ID (`{JIRA_KEY}-N`, `#N`, gh URL, repo#N, free-text) | `commands/multi-agent/_input-parser.md` → `_account-picker.md` → `lib/issue-fetcher.sh` (maturity check) → `_dev-context.md` |
+| `setup` | `$HOME/.claude/commands/multi-agent/setup.md` |
+| `help` | `$HOME/.claude/commands/multi-agent/help.md` |
+| `channels` | `$HOME/.claude/commands/multi-agent/channels.md` |
+| `sync` | `$HOME/.claude/commands/multi-agent/sync.md` |
+| `clear-logs` | Handled inline — scan + delete agent-log.md/agent-state.json files |
+| `review` | `$HOME/.claude/commands/multi-agent/review.md` |
+| `local` | `$HOME/.claude/commands/multi-agent/local.md` |
+| `local-autopilot` | `$HOME/.claude/commands/multi-agent/local-autopilot.md` |
+| `dev-local` | `$HOME/.claude/commands/multi-agent/dev-local.md` |
+| `dev-local-autopilot` | `$HOME/.claude/commands/multi-agent/dev-local-autopilot.md` |
+| `stack` | `$HOME/.claude/commands/multi-agent/stack.md` |
+| `language` | Handled inline — set/show prompt language in preferences |
+| SwiftUI component task (iOS) | `$HOME/.claude/commands/multi-agent/refs/swiftui-guide.md` |
+| Jetpack Compose task (Android) | `$HOME/.claude/commands/multi-agent/refs/android-guide.md` |
+| Backend API task | `$HOME/.claude/commands/multi-agent/refs/backend-guide.md` |
+| Frontend component task | `$HOME/.claude/commands/multi-agent/refs/frontend-guide.md` |
+| Phase 1 or Phase 7 (knowledge) | `$HOME/.claude/commands/multi-agent/refs/knowledge.md` |
+| Token lookup needed | `$HOME/.claude/commands/multi-agent/refs/keychain.md` |
+| Audit tools (Phase 5/6) | `$HOME/.claude/commands/multi-agent/refs/audit-guide.md` |
+| `test` | `$HOME/.claude/commands/sim-test.md` (colon-form `/multi-agent:test` uses the delegate at `commands/multi-agent/test.md`) |
+| `manual-test` | `$HOME/.claude/commands/multi-agent/manual-test.md` |
+
+**Modifier flags** (`--dev`, `--local`, `autopilot`) and **ops** (`status`, `log`, `resume`, `kill`, `clear-logs`, `purge`, `review`) are parsed inline by this file — no separate spec files, they compose with the pipeline or do one-shot work.
+
+**How**: After routing, `Read` the relevant file and follow its instructions. Only load what the current action needs.
+
+**Guide selection** (auto, based on Phase 1 detected stack):
+- iOS detected -> load `swiftui-guide.md`
+- Android detected -> load `android-guide.md`
+- Python/Node.js/Go detected -> load `backend-guide.md`
+- React/Vue/Next.js detected -> load `frontend-guide.md`
+- Multiple stacks -> load all relevant guides
+
+**Agent definitions** (used in Phase 1 and Phase 4):
+- `$HOME/.claude/agents/code-reviewer.md` — Phase 4 reviewer persona (`preferredModel: opus`; Phase 4 overrides Reviewer 3 to `sonnet`)
+- `$HOME/.claude/agents/explorer.md` — Phase 1 codebase scan persona (`preferredModel: sonnet` — scan work, cost-efficient)
+- `$HOME/.claude/agents/ios-architect.md` — iOS architecture review (`preferredModel: opus`)
+- `$HOME/.claude/agents/android-architect.md` — Android architecture review (`preferredModel: opus`)
+- `$HOME/.claude/agents/backend-architect.md` — Backend/API architecture review (`preferredModel: opus`)
+- `$HOME/.claude/agents/security-auditor.md` — Security audit (`preferredModel: opus`)
+
+**Per-persona model routing:** Before each Agent dispatch, the orchestrator reads `preferredModel` from the persona file and exports `CLAUDE_CODE_SUBAGENT_MODEL` (Claude Code) / passes `--model` (Copilot CLI). Precedence: per-dispatch `PHASE_MODEL_OVERRIDE` > persona `preferredModel` > `opus`. Full contract: `skills/shared/core/multi-agent/SKILL.md#agent-dispatch--per-persona-model-routing-v610`.
+
+---
+
+## language Command
+
+Toggles only `outputLanguage` (`promptLanguage` is locked to `"en"` — see `refs/rules.md` § "Language Application"). Full spec: `pipeline/commands/multi-agent/language.md`.
+
+---
+
+## jira Command
+
+Delegates to `commands/multi-agent/jira.md` (4-step picker). Read that file, then apply:
+
+1. **Pick account** — `_account-picker.md` (`lib/account-resolver.sh --providers jira`)
+2. **Pick projects (multi)** — Jira project list, multi-select
+3. **Pick issue** — aggregate across selected projects, `lib/issue-fetcher.sh` with maturity check
+4. **Maturity check** — halt on blocker, prompt on warning (autopilot auto-continues)
+5. **Dev context** (`_dev-context.md`) — extra repo selection
+6. → Interactive Launcher (branch/mode/autopilot) → Phase 0
+
+Steps 1–5 are detailed in `jira.md`; the Interactive Launcher (below) consumes the result.
+
+---
+
+## issue Command
+
+Delegates to `commands/multi-agent/issue.md` (4-step picker). Read that file, then apply:
+
+1. **Pick account** — `_account-picker.md` (`--providers github`)
+2. **Pick repos (multi)** — `lib/repo-cache.sh github <owner>`, multi-select
+3. **Pick issue** — aggregate across repos (`gh issue list`), maturity check
+4. **Maturity check** — `lib/issue-fetcher.sh` maturity field; blocker halts, warning prompts
+5. **Dev context** (`_dev-context.md`) — submodule auto-suggest + extra repos
+6. → Interactive Launcher → Phase 0
+
+---
+
+## Direct-ID Command ({JIRA_KEY}-N, gh URL, repo#N, free-text)
+
+When the user supplies an ID/URL/free-text:
+
+1. **Detect type** — per `_input-parser.md`
+2. **Pick account** — always asked (autopilot picks default)
+3. **Fetch issue** — `lib/issue-fetcher.sh "$INPUT"` (Jira/GitHub fetch + maturity)
+4. **Repo picker** — only for `gh-num` (e.g. `316`) when repo is ambiguous, multi-select
+5. **Maturity check** — blocker halts (autopilot too), warning prompt/log
+6. **Dev context** — always runs, empty submit allowed
+7. → Interactive Launcher → Phase 0
+
+---
+
+## Interactive Launcher (shared by `jira` and `issue`)
+
+After the user selects an issue from either `jira` or `issue` command:
+
+### Step 1 — Branch Selection
+Same as Phase 0 Step 3: fetch remote branches, sort (develop* first → release/* → main/master), present with Recent suggestion from prefs:
+```
+Base branch:
+  Recent: → develop (enter to reuse)
+  ────────────────────
+  1. origin/develop
+  2. origin/main
+  ...
+Select [number] or enter for suggested:
+```
+Save to `prefs.projects[{project}].branches`.
+
+### Step 2 — Mode Selection
+```
+Pipeline mode:
+  1. Full pipeline (8 phases, Sonnet dev, parallel review + triage — CLI-aware reviewer set)
+  2. --dev (fast: Init → Dev(Opus) → Commit → Report)
+Select [1/2]:
+```
+
+### Step 3 — Autopilot
+```
+Enable autopilot? (skip confirmations, auto commit/PR)
+  1. Yes
+  2. No
+Select [1/2]:
+```
+
+### Step 4 — Launch
+Compose the final command arguments and start the pipeline:
+- `jira` source → input type is `jira-id` (e.g. `PROJ-1234`)
+- `issue` source → input type is `github-issue-url` (e.g. `https://github.com/org/repo/issues/610`)
+
+Pass selected base branch + mode flags. The pipeline enters Phase 0 Step 1 with the issue already fetched — skip redundant API calls.
+
+---
+
+## Review Mode
+
+When called with `review`:
+1. Detect current branch and project from cwd (or ask)
+2. Get diff: `git diff HEAD` (unstaged + staged)
+3. If no diff, get diff against base branch: `git diff origin/{baseBranch}...HEAD`
+4. Launch Phase 4 review (parallel + Opus triage — 2-model on Claude Code, 3-model on Copilot CLI) on the diff
+5. No worktree, no state file — lightweight one-shot review
+6. Print findings to terminal
+
+---
+
+## Rules
+
+**Non-negotiable rules that apply to every phase, every mode.** Full reference at `$HOME/.claude/commands/multi-agent/refs/rules.md` — read before any invocation that writes code, commits, or posts to external systems.
+
+Quick pointers:
+- No "Copilot/AI/generated by" attribution. Ever.
+- No commit without build + review pass.
+- Real newlines in external outputs (heredoc + `jq --rawfile` + `curl --data-binary`).
+- No HTML entities (`&amp;`, `&lt;`, `&quot;`) in titles, commits, or bodies.
+- Every Bitbucket PUT ships `reviewers` + `fromRef` + `toRef` + `draft` (missing fields wipe defaults).
+- Commit format: `{type}({scope}): description [{jiraId}|#{shortId}]`.
+- Branch: `feature/` or `bugfix/` prefix.
+- 3-iteration hard kill on any retry loop.
+
+Load `refs/rules.md` for the full contract (Swift-specific rules, reviewer policy, secret scan, subagent contract).
+
+---
+
+## Status Display
+
+Scan global log path `$HOME/.claude/logs/multi-agent/` for `agent-state.json` files across all projects:
+
+```
+Multi-Agent Tasks
+
+| ID | Project | Task | Branch | Phase | Status | Duration |
+|----|---------|------|--------|-------|--------|----------|
+| #1 | my-app | PROJ-12345 | feature/PROJ-12345-... | 3/7 Dev | in progress | 4m |
+| #2 | other-app | GH42 | feature/GH42-dark-mode | 6/7 Commit | complete | 12m |
+
+Commands: kill #N | log #N | resume #N
+```
+
+---
+
+## Global Paths
+
+| Purpose | Path |
+|---------|------|
+| Logs & state | `$HOME/.claude/logs/multi-agent/{project}/{task-id}/` |
+| Knowledge base | `$HOME/.claude/knowledge/{project-name}/` |
+| Helper scripts | `$HOME/.claude/scripts/` |
+| Sub-command files | `$HOME/.claude/commands/multi-agent/` |
+| Agent definitions | `$HOME/.claude/agents/` |

package/pipeline/commands/security-review.md

@@ -0,0 +1,6 @@
+---
+description: Deep security audit on iOS project code
+allowed-tools: Read, Glob, Grep, Agent, Bash(git:*), Bash(grep:*)
+---
+
+Alias for Phase 4 Reviewer 1 (Opus + security-auditor agent). Invocation: `/multi-agent:review` then select security focus; or invoke directly via Agent tool with subagent_type=security-auditor.

package/pipeline/commands/sim-test.md

@@ -0,0 +1,256 @@
+---
+description: "Mobile UI Bug Hunter — iOS Simulator (simctl) + Android Emulator (adb) — auto-detects platform"
+allowed-tools: Agent, Bash, Read, Write, Edit, TaskCreate, TaskUpdate, TaskList, TaskGet, mcp__dev_toolkit__ios_list_devices, mcp__dev_toolkit__ios_boot_device, mcp__dev_toolkit__ios_screenshot, mcp__dev_toolkit__ios_tap, mcp__dev_toolkit__ios_swipe, mcp__dev_toolkit__ios_type_text, mcp__dev_toolkit__ios_launch_app, mcp__dev_toolkit__ios_terminate_app, mcp__dev_toolkit__ios_list_apps, mcp__dev_toolkit__ios_go_home, mcp__dev_toolkit__ios_set_appearance, mcp__dev_toolkit__ios_set_content_size, mcp__dev_toolkit__ios_set_locale, mcp__dev_toolkit__ios_open_url, mcp__dev_toolkit__ios_status_bar, mcp__dev_toolkit__ios_push_notification, mcp__dev_toolkit__ios_grant_permission, mcp__dev_toolkit__ios_revoke_permission, mcp__dev_toolkit__ios_reset_permissions, mcp__dev_toolkit__ios_set_location, mcp__dev_toolkit__ios_clear_location, mcp__dev_toolkit__ios_set_increase_contrast, mcp__dev_toolkit__ios_record_video, mcp__dev_toolkit__ios_add_media, mcp__dev_toolkit__ios_keychain_reset, mcp__dev_toolkit__ios_get_app_container, mcp__dev_toolkit__ios_erase_device, mcp__dev_toolkit__ios_get_ui_tree, mcp__dev_toolkit__android_list_devices, mcp__dev_toolkit__android_screenshot, mcp__dev_toolkit__android_tap, mcp__dev_toolkit__android_swipe, mcp__dev_toolkit__android_type_text, mcp__dev_toolkit__android_key_event, mcp__dev_toolkit__android_launch_app, mcp__dev_toolkit__android_stop_app, mcp__dev_toolkit__android_list_packages, mcp__dev_toolkit__android_go_home, mcp__dev_toolkit__android_go_back, mcp__dev_toolkit__android_get_ui_tree, mcp__dev_toolkit__android_set_dark_mode, mcp__dev_toolkit__android_set_font_scale, mcp__dev_toolkit__android_set_locale, mcp__dev_toolkit__android_set_location, mcp__dev_toolkit__android_grant_permission, mcp__dev_toolkit__android_revoke_permission, mcp__dev_toolkit__android_record_screen, mcp__dev_toolkit__android_install_apk, mcp__dev_toolkit__android_uninstall_app, mcp__dev_toolkit__android_logcat, mcp__dev_toolkit__android_get_screen_size, mcp__dev_toolkit__android_open_url, mcp__dev_toolkit__android_clear_app_data
+---
+
+# Mobile UI Bug Hunter
+
+Auto-detects platform: iOS (simctl) or Android (adb). No external apps needed.
+
+- **iOS**: Xcode + Simulator
+- **Android**: Android SDK + Emulator (or physical device via USB)
+
+> **Note**: Tool names above assume MCP server is registered as `dev-toolkit`. If you used a different name in your settings.json, update the `allowed-tools` list accordingly.
+
+## Platform Detection
+
+```
+1. Check cwd for .xcodeproj / Package.swift -> iOS
+2. Check cwd for build.gradle / build.gradle.kts -> Android
+3. Check running devices: simctl list booted / adb devices
+4. If both available -> ask user which platform
+5. If argument contains "android" or "ios" -> use that
+```
+
+For iOS: use `mcp__dev_toolkit__ios_*` tools
+For Android: use `mcp__dev_toolkit__android_*` tools
+
+**Android extras**: `get_ui_tree` returns XML with bounds/text/resource-id (uiautomator dump), `logcat` for crash detection, `go_back` button.
+
+## Activation
+
+```
+/multi-agent test                      -> full app test
+/multi-agent test "dark mode"          -> dark mode bug test
+/multi-agent test "accessibility"      -> accessibility audit (visual + MCP audit tool)
+/multi-agent test "dynamic type"       -> large text test
+/multi-agent test "screenshot tr"      -> locale screenshots
+/multi-agent test "store-ready"        -> full audit: visual + accessibility + archive/APK compliance
+/multi-agent test "biometric"          -> Face ID / Touch ID flow test
+/multi-agent test "performance"        -> launch time + scroll performance
+/sim-test                              -> standalone (same thing)
+```
+
+## Flow
+
+### Step 1 — Device & App Discovery
+
+```
+Call: ios_list_devices (or android_list_devices)
+-> If no booted simulator: ask user which to boot, call ios_boot_device
+-> If booted: auto-select
+
+Call: ios_list_apps
+-> Auto-detect bundle_id from cwd project (xcodebuild -showBuildSettings | PRODUCT_BUNDLE_IDENTIFIER)
+-> Or ask user to pick from installed apps
+
+Call: ios_launch_app (bundle_id)
+-> Wait 2 seconds for app to load
+```
+
+### Step 2 — Clean Status Bar (for screenshots)
+
+```
+Call: ios_status_bar (time: "09:41", battery_level: 100)
+```
+
+### Step 3 — Systematic Screen Exploration
+
+For each screen in the app:
+
+```
+Call: ios_screenshot
+-> Claude analyzes the image for bugs (see Bug Detection below)
+
+Call: ios_tap (on each tab bar item, button, navigation link)
+-> After each tap: ios_screenshot -> analyze
+-> Navigate back: ios_swipe (left edge swipe) or tap back button coordinates
+```
+
+**Navigation strategy:**
+
+1. Screenshot initial screen -> identify tab bar (usually bottom ~680-700y area)
+2. Tap each tab position -> screenshot each
+3. On each screen: tap interactive elements -> screenshot results
+4. Scroll: `ios_swipe(200, 600, 200, 200)` to scroll down -> screenshot
+5. Type in text fields: `ios_type_text("test input")`
+
+### Step 4 — Variant Testing (based on input argument)
+
+**"dark mode":**
+
+```
+Call: ios_set_appearance("dark")
+-> Re-navigate all screens, screenshot each
+Call: ios_set_appearance("light")  // reset
+```
+
+**"dynamic type":**
+
+```
+Call: ios_set_content_size("extra-extra-extra-large")
+-> Re-navigate, screenshot
+Call: ios_set_content_size("accessibility-extra-large")
+-> Re-navigate, screenshot
+Call: ios_set_content_size("medium")  // reset
+```
+
+**"accessibility":**
+
+- Check each screenshot for: small tap targets, missing labels, poor contrast
+- Verify minimum 44x44pt touch areas
+- Check text readability at default + large sizes
+
+**"screenshot <lang>":**
+
+```
+Call: ios_set_locale(language: "<lang>", bundle_id: "...")
+-> Navigate all screens, screenshot each
+-> Great for App Store screenshot generation
+```
+
+**"store-ready":**
+
+Runs visual + accessibility pass AND dispatches the platform-matching compliance skill so the build is pre-validated against Apple / Google store requirements before submission.
+
+```
+Platform detection:
+  cwd contains .xcodeproj OR Package.swift             -> iOS
+  cwd contains build.gradle OR build.gradle.kts        -> Android
+  Otherwise                                            -> error: "store-ready needs an iOS or Android project"
+
+Step A — run the standard visual + accessibility sweep (light + dark + large text).
+
+Step B — dispatch compliance skill:
+  iOS:
+    Load pipeline/skills/shared/core/apple-archive-compliance/SKILL.md
+    Prereq: @mmerterden/dev-toolkit-mcp ≥ v2.4 (provides ios_app_store_audit MCP tool)
+            — installable via npm; standalone ArchiveGuard binary deprecated in v8.4.0
+    Artifact: pick newest .xcarchive under ~/Library/Developer/Xcode/Archives/**
+              OR accept explicit path argument after "store-ready"
+    Invoke:   mcp__dev_toolkit__ios_app_store_audit({ archive_path: <path>, rules: "all" })
+              OR (Node fallback): node -e "import('@mmerterden/dev-toolkit-mcp/tools/ios-app-store-audit/index.js').then(m => m.runAudit({ archivePath: '<path>', rules: 'all' }).then(r => console.log(JSON.stringify(r))))"
+              Humanize via --lang en (promptLanguage is locked to "en"; pass --lang=tr explicitly to opt into Turkish)
+  Android:
+    Load pipeline/skills/shared/core/google-play-compliance/SKILL.md
+    Prereq: bundletool, aapt2, apksigner in PATH (Android SDK build-tools)
+    Artifact: newest .aab under **/build/outputs/bundle/**/*.aab
+              OR explicit path argument
+    Invoke:   bundletool validate + dump manifest, aapt2 dump badging,
+              apksigner verify, ABI/native scan
+  Merge findings with UI-hunter findings -> single report, severity-grouped.
+
+Step C — humanize via `--lang en` by default (promptLanguage is locked to "en"; pass --lang=tr explicitly to opt into Turkish), group by severity
+  (error = blocker, warning = risk, info = hygiene), link each finding to the
+  Apple ITMS / Play policy reference supplied by the skill catalog.
+
+Step D — offer `/multi-agent:channels` follow-up so findings can land in
+  Jira / Confluence / Wiki / PR body via the normal Phase 7 machinery.
+```
+
+**No argument (full test):**
+
+- Run light mode -> all screens
+- Run dark mode -> all screens
+- Run large text -> all screens
+- Compile complete report
+
+### Step 5 — Bug Detection (on EVERY screenshot)
+
+When analyzing each screenshot, check for:
+
+| Category         | What to Look For                                                                     |
+| ---------------- | ------------------------------------------------------------------------------------ |
+| **Layout**       | Overlapping elements, truncated text, off-screen content, broken alignment           |
+| **Visual**       | Wrong colors, missing images, placeholder text ("Lorem ipsum"), inconsistent spacing |
+| **Dark Mode**    | Text invisible on dark background, hardcoded white/black, wrong tint colors          |
+| **Typography**   | Text overflow at large sizes, unreadable small text, line height issues              |
+| **Navigation**   | Missing back button, dead-end screens, broken tab bar                                |
+| **State**        | Empty state without message, loading spinner stuck, error state visible              |
+| **Localization** | Untranslated strings, text clipping in long translations                             |
+| **Interaction**  | Button didn't respond (before/after screenshots identical after tap)                 |
+
+### Step 6 — Report
+
+Create tasks for each bug found:
+
+```
+TaskCreate("BUG: [severity] title", "Screen: X, Category: Y, Steps: ...", activeForm: "Found bug...")
+```
+
+Then output full report:
+
+```markdown
+# Simulator UI Test Report
+
+**App**: {bundle_id}
+**Device**: {device_name} (iOS {version})
+**Date**: {timestamp}
+**Mode**: {full / dark mode / accessibility / screenshot}
+
+## Bugs Found ({N} total)
+
+### BUG-1: [{Critical/Major/Minor}] {title}
+
+- **Screen**: {which screen}
+- **Category**: Layout / Dark Mode / Typography / Navigation
+- **Steps**: 1. Open app -> 2. Tap {X} -> 3. Observe {issue}
+- **Expected**: {correct behavior}
+- **Actual**: {what's wrong}
+
+### BUG-2: ...
+
+## Screens Visited ({N})
+
+| #   | Screen   | Light | Dark  | Large Text | Bugs |
+| --- | -------- | ----- | ----- | ---------- | ---- |
+| 1   | Home     | ok    | BUG-1 | ok         | 1    |
+| 2   | Login    | ok    | ok    | BUG-2      | 1    |
+| 3   | Settings | ok    | ok    | ok         | 0    |
+
+## Summary
+
+- Screens tested: {N}
+- Clean: {N}
+- With bugs: {N}
+- Critical: {N} | Major: {N} | Minor: {N}
+```
+
+Save to: `$HOME/.claude/logs/sim-test/{bundle_id}/{timestamp}.md`
+
+### Step 7 — Fix Offer
+
+After report is complete, if bugs were found:
+
+```
+{N} bug(s) found. Want me to fix them?
+  y -> Create fix tasks, start fixing (reads source code, applies changes)
+  n -> Report saved, you can review and fix manually
+  pick -> Show bug list, user picks which to fix
+```
+
+If user says yes:
+
+1. For each bug, locate the relevant View file
+2. Analyze the screenshot + bug description
+3. Apply the fix (color, padding, font, constraint, etc.)
+4. Re-run screenshot on that screen to verify fix
+5. Show before/after comparison
+
+### Step 8 — Cleanup
+
+```
+Call: ios_set_appearance("light")
+Call: ios_set_content_size("medium")
+Call: ios_status_bar (clear override)
+```

package/pipeline/eval/golden-tasks/01-ios-bugfix-darkmode/expected/phase-1-analysis.json

@@ -0,0 +1,25 @@
+{
+  "stack": {
+    "primary": "ios",
+    "language": "Swift 6",
+    "framework": "SwiftUI"
+  },
+  "touchedAreas": [
+    {
+      "path": "Sources/Auth/LoginView.swift",
+      "why": "Hardcoded Color.white yerine DesignSystem.Color.Primary.onBackground kullanacak"
+    },
+    {
+      "path": "Sources/Auth/LoginViewTests.swift",
+      "why": "Dark mode snapshot + ViewInspector contrast assertion eklenecek"
+    }
+  ],
+  "risks": [
+    {
+      "risk": "LoginView başka ekran tarafından preview alanı olarak kullanılıyor olabilir — token değişimi preview snapshot'larını kırabilir",
+      "severity": "low",
+      "mitigation": "Preview varyantlarını snapshot'lar ile koruyarak incremental değiştir"
+    }
+  ],
+  "summary": "LoginView'de primary button rengi hardcoded Color.white. Token sistemi ile değiştirilip light+dark mode için ayrık snapshot testleri eklenecek. Değişim iki dosya ile sınırlı, regresyon riski düşük."
+}

package/pipeline/eval/golden-tasks/01-ios-bugfix-darkmode/expected/phase-2-plan.json

@@ -0,0 +1,30 @@
+{
+  "approach": "TDD-first. Önce dark-mode contrast için snapshot + ViewInspector testi yazılır (RED), sonra LoginView'de hardcoded renk token çağrısıyla değiştirilir (GREEN). Refactor: aynı dosyada ikinci hardcoded renk varsa tek geçişte temizlenir.",
+  "tasks": [
+    {
+      "id": "T1",
+      "title": "Add failing dark mode snapshot + contrast ViewInspector test",
+      "type": "test",
+      "files": ["Sources/Auth/LoginViewTests.swift"],
+      "dependsOn": [],
+      "acceptanceCriteria": [
+        "Snapshot test for dark mode renders primary button",
+        "ViewInspector asserts foreground color != Color.white when env.colorScheme == .dark"
+      ]
+    },
+    {
+      "id": "T2",
+      "title": "Replace hardcoded Color.white with DesignSystem token",
+      "type": "code",
+      "files": ["Sources/Auth/LoginView.swift"],
+      "dependsOn": ["T1"],
+      "acceptanceCriteria": [
+        "No Color(red:..., green:..., blue:...) or Color.white remains in LoginView",
+        "Primary button uses DesignSystem.Color.Primary.onBackground",
+        "All snapshot + inspector tests pass"
+      ]
+    }
+  ],
+  "approved": true,
+  "userFeedback": null
+}

package/pipeline/eval/golden-tasks/01-ios-bugfix-darkmode/expected/phase-4-review.json

@@ -0,0 +1,20 @@
+[
+  {
+    "reviewer": "opus",
+    "findings": [
+      {
+        "severity": "blocking",
+        "file": "Sources/Auth/LoginView.swift",
+        "line": 42,
+        "issue": "Hardcoded .font(.system(size: 14)) kaldı — aynı fix sırasında typography token'ına da bağlanmalı",
+        "fix": "Replace with .typographyStyle(.body1) — same pattern as the color token migration"
+      }
+    ],
+    "approved": false
+  },
+  {
+    "reviewer": "sonnet",
+    "findings": [],
+    "approved": true
+  }
+]

package/pipeline/eval/golden-tasks/01-ios-bugfix-darkmode/expected/phase-4-triage.json

@@ -0,0 +1,15 @@
+{
+  "accepted": [
+    {
+      "severity": "blocking",
+      "file": "Sources/Auth/LoginView.swift",
+      "line": 42,
+      "issue": "Hardcoded .font(.system(size: 14)) kaldı — aynı fix sırasında typography token'ına da bağlanmalı",
+      "fix": "Replace with .typographyStyle(.body1) — same pattern as the color token migration",
+      "reviewer": "opus"
+    }
+  ],
+  "deferred": [],
+  "rejected": [],
+  "approved": false
+}

package/pipeline/eval/golden-tasks/01-ios-bugfix-darkmode/metadata.json

@@ -0,0 +1,14 @@
+{
+  "focus": "SwiftUI bugfix path — verifies that Phase 4 picks up an in-scope but adjacent blocker (token drift) even when the primary issue is resolved.",
+  "exercises": [
+    "Phase 1 stack detection (iOS / Swift 6 / SwiftUI)",
+    "Phase 2 TDD ordering (test before code)",
+    "Phase 4 Reviewer-1 catches adjacent token drift; Reviewer-2 approves base fix",
+    "Triage keeps the blocker accepted, no deferrals, not approved"
+  ],
+  "regressionsCaught": [
+    "If stack detection drops SwiftUI from the framework field, this fixture fails the analysis schema check",
+    "If planning schema drops the 'dependsOn' field, T2 loses its order guarantee",
+    "If Phase 4 no longer tolerates Reviewer-1 blocker + Reviewer-2 approval (approved divergence), triage fixture fails"
+  ]
+}