@mmerterden/multi-agent-pipeline 12.6.0 → 12.8.0

package/pipeline/skills/shared/README.md

@@ -30,46 +30,46 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`multi-agent`](./core/multi-agent/) | `core` | Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Fable  |
 | [`multi-agent-analysis`](./core/multi-agent-analysis/) | `core` | Standalone feature-spec analysis (v3 template). Platform-agnostic concept layer with repo-driven convention extraction and per-platform Pass |
 | [`multi-agent-analysis-resolve`](./core/multi-agent-analysis-resolve/) | `core` | Resolve the Section 20 Risks and Open Questions of an analysis v3 document one row at a time. Proposes up to 3 source-labeled answer candida |
-| [`multi-agent-autopilot`](./core/multi-agent-autopilot/) | `core` | Launch any task in autopilot mode: skips every confirmation, runs end-to-end autonomously. |
+| [`multi-agent-autopilot`](./core/multi-agent-autopilot/) | `core` | Launch any task in autopilot mode: skips every confirmation, runs end-to-end autonomously. Use when a task should run end to end with no con |
 | [`multi-agent-build-optimize`](./core/multi-agent-build-optimize/) | `core` | Wrapper that dispatches to xcode-build-orchestrator on iOS repos. Benchmarks the current Xcode build, runs compilation / project / SPM analy |
 | [`multi-agent-channels`](./core/multi-agent-channels/) | `core` | Multi-channel reporter  -  Jira/Confluence/Wiki/PR description. Multi-select channels + content, humanizer pass, reviewer-preserving Bitbuck |
 | [`multi-agent-create-jira`](./core/multi-agent-create-jira/) | `core` | Create a standards-compliant Jira issue (Task / Bug / Story): asks the type, mines project conventions, drafts from a standard template with |
 | [`multi-agent-design-check`](./core/multi-agent-design-check/) | `core` | Mock-mode vs Figma design audit (iOS / Android, local-only). Pick repo + module, gate on mock support, enumerate every state driver into a c |
-| [`multi-agent-dev`](./core/multi-agent-dev/) | `core` | Fast development mode: Init → Dev (Opus) → Test → Commit → Report. Analysis, planning, and review phases are skipped. |
-| [`multi-agent-dev-autopilot`](./core/multi-agent-dev-autopilot/) | `core` | Fastest mode: Dev (Opus) plus Autopilot. Init → Dev → Commit → Report with zero confirmations. |
-| [`multi-agent-dev-local`](./core/multi-agent-dev-local/) | `core` | Fast mode + local  -  Init → Dev(Opus) → Commit → Report, no worktree. |
-| [`multi-agent-dev-local-autopilot`](./core/multi-agent-dev-local-autopilot/) | `core` | Fastest + local  -  Dev(Opus) + autopilot, no worktree, zero interaction. |
+| [`multi-agent-dev`](./core/multi-agent-dev/) | `core` | Fast development mode: Init → Dev (Opus) → Test → Commit → Report. Analysis, planning, and review phases are skipped. Use when the work is a |
+| [`multi-agent-dev-autopilot`](./core/multi-agent-dev-autopilot/) | `core` | Fastest mode: Dev (Opus) plus Autopilot. Init → Dev → Commit → Report with zero confirmations. Use when a change is well understood and shou |
+| [`multi-agent-dev-local`](./core/multi-agent-dev-local/) | `core` | Fast mode + local  -  Init → Dev(Opus) → Commit → Report, no worktree. Use when a change should be developed on the current branch without c |
+| [`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-finish`](./core/multi-agent-finish/) | `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 |
-| [`multi-agent-issue`](./core/multi-agent-issue/) | `core` | List unassigned GitHub issues, pick one, auto-assign, and launch the multi-agent pipeline. |
-| [`multi-agent-jira`](./core/multi-agent-jira/) | `core` | List open Jira issues, pick one, and launch the multi-agent pipeline. |
-| [`multi-agent-kill`](./core/multi-agent-kill/) | `core` | Stop the given task, then remove its worktree and branch. Asks for confirmation. |
-| [`multi-agent-language`](./core/multi-agent-language/) | `core` | Toggle outputLanguage (assistant explanations). promptLanguage is fixed to English. External payloads stay English. |
-| [`multi-agent-local`](./core/multi-agent-local/) | `core` | Full pipeline in local mode  -  no worktree, runs directly on the current branch. |
-| [`multi-agent-local-autopilot`](./core/multi-agent-local-autopilot/) | `core` | Full pipeline + local + autopilot  -  no worktree, no confirmations, all 8 phases run end-to-end on the current branch. |
-| [`multi-agent-log`](./core/multi-agent-log/) | `core` | Show the agent-log.md for the given task. With no ID, shows the most recent task. |
+| [`multi-agent-issue`](./core/multi-agent-issue/) | `core` | List unassigned GitHub issues, pick one, auto-assign, and launch the multi-agent pipeline. Use when a GitHub issue should be picked up and s |
+| [`multi-agent-jira`](./core/multi-agent-jira/) | `core` | List open Jira issues, pick one, and launch the multi-agent pipeline. Use when a Jira issue should be picked up and started without knowing  |
+| [`multi-agent-kill`](./core/multi-agent-kill/) | `core` | Stop the given task, then remove its worktree and branch. Asks for confirmation. Use when a running or stuck task should be stopped and its  |
+| [`multi-agent-language`](./core/multi-agent-language/) | `core` | Toggle outputLanguage (assistant explanations). promptLanguage is fixed to English. External payloads stay English. Use when the assistant s |
+| [`multi-agent-local`](./core/multi-agent-local/) | `core` | Full pipeline in local mode  -  no worktree, runs directly on the current branch. Use when the full pipeline should run on the current branc |
+| [`multi-agent-local-autopilot`](./core/multi-agent-local-autopilot/) | `core` | Full pipeline + local + autopilot  -  no worktree, no confirmations, all 8 phases run end-to-end on the current branch. Use when the full pi |
+| [`multi-agent-log`](./core/multi-agent-log/) | `core` | Show the agent-log.md for the given task. With no ID, shows the most recent task. Use when asked what a task did, or to read its log. |
 | [`multi-agent-manual-test`](./core/multi-agent-manual-test/) | `core` | Switch to the active task's branch and prepare it for manual testing in Xcode. Phase 5 standalone (the UI Bug Hunter lives at multi-agent-te |
 | [`multi-agent-prune-logs`](./core/multi-agent-prune-logs/) | `core` | Delete per-task project logs under ~/.claude/logs/multi-agent (filter by age/project/task). Audit trail + metrics are preserved. Dry-run fir |
-| [`multi-agent-purge`](./core/multi-agent-purge/) | `core` | ⚠️ Wipes every worktree, branch, log, and state file. Irreversible; asks for double confirmation. |
+| [`multi-agent-purge`](./core/multi-agent-purge/) | `core` | ⚠️ Wipes every worktree, branch, log, and state file. Irreversible; asks for double confirmation. Use when every worktree, branch, log and s |
 | [`multi-agent-refactor`](./core/multi-agent-refactor/) | `core` | Analyse the project: extract adapted best-practices, hunt real bugs + improvement areas, check upstream drift of derived skills, research th |
-| [`multi-agent-resume`](./core/multi-agent-resume/) | `core` | Resume a stopped or failed task from the phase where it left off. |
+| [`multi-agent-resume`](./core/multi-agent-resume/) | `core` | Resume a stopped or failed task from the phase where it left off. Use when a task stopped or failed and should carry on from where it left o |
 | [`multi-agent-review`](./core/multi-agent-review/) | `core` | Run parallel review on a branch diff or a Pull Request: 2 models on Claude Code (Fable + Sonnet), 3 models on Copilot CLI (GPT + Opus + Sonn |
 | [`multi-agent-review-issue`](./core/multi-agent-review-issue/) | `core` | Assess whether a GitHub issue is ready for multi-agent development: fetch it, grade scope / acceptance criteria / repro / design / API / sta |
 | [`multi-agent-review-jira`](./core/multi-agent-review-jira/) | `core` | Assess whether a Jira issue is ready for multi-agent development: fetch it, grade scope / acceptance criteria / repro / design / API / stack |
-| [`multi-agent-routines`](./core/multi-agent-routines/) | `core` | List your saved /multi-agent routines (from /multi-agent:save) with what each one does, rendered in outputLanguage. |
+| [`multi-agent-routines`](./core/multi-agent-routines/) | `core` | List your saved /multi-agent routines (from /multi-agent:save) with what each one does, rendered in outputLanguage. Use when asked which sav |
 | [`multi-agent-save`](./core/multi-agent-save/) | `core` | Save a recurring job as a reusable /multi-agent:<name> command. Reviews the conversation + your CLAUDE.md for candidate routines, you pick o |
-| [`multi-agent-scan`](./core/multi-agent-scan/) | `core` | Skill security scan: walks local skill directories against a tiered pattern catalog. |
-| [`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. |
-| [`multi-agent-setup`](./core/multi-agent-setup/) | `core` | First-run setup wizard: keychain token discovery, Git Identity onboarding, and pipeline preparation. |
+| [`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-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. |
-| [`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. |
+| [`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-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-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. |
+| [`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 |
 
 ## iOS / Apple Ecosystem
 
@@ -79,7 +79,7 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`alarmkit`](./external/alarmkit/) | `external` | Implement AlarmKit alarms and countdown timers for iOS and iPadOS with Lock Screen, Dynamic Island, StandBy, and paired Apple Watch system U |
 | [`app-clips`](./external/app-clips/) | `external` | Build iOS App Clips with invocation URLs, App Clip Codes, NFC, QR codes, Safari banners, Maps, Messages, target setup, App Store Connect exp |
 | [`app-intents`](./external/app-intents/) | `external` | Implement App Intents for Siri, Shortcuts, Spotlight, widgets, Control Center, and Apple Intelligence on iOS. Covers AppIntent actions, AppE |
-| [`app-store-changelog`](./external/app-store-changelog/) | `external` | Generate user-facing App Store release notes from git history since the last tag. |
+| [`app-store-changelog`](./external/app-store-changelog/) | `external` | Generate user-facing App Store release notes from git history since the last tag. Use when release notes have to be written from the commits |
 | [`app-store-optimization`](./external/app-store-optimization/) | `external` | Optimize App Store product pages for search visibility and conversion. Use for App Store Optimization (ASO), keyword research, app name/subt |
 | [`app-store-review`](./external/app-store-review/) | `external` | Prepare for App Store review and prevent rejections. Covers App Store review guidelines, app rejection reasons, PrivacyInfo.xcprivacy privac |
 | [`apple-on-device-ai`](./external/apple-on-device-ai/) | `external` | Integrate on-device AI using Foundation Models framework, Core ML, and open-source LLM runtimes on Apple Silicon. Covers Foundation Models ( |
@@ -95,28 +95,28 @@ 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, and  |
+| [`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 |
 | [`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. |
-| [`hig-components-layout`](./external/hig-components-layout/) | `external` | Apple Human Interface Guidelines for layout and navigation components. |
-| [`hig-components-status`](./external/hig-components-status/) | `external` | Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings. |
+| [`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 |
+| [`hig-components-status`](./external/hig-components-status/) | `external` | Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings. Use when designing  |
 | [`hig-components-system`](./external/hig-components-system/) | `external` | Apple HIG guidance for system experience components: widgets, live activities, notifications, complications, home screen quick actions, top  |
-| [`hig-foundations`](./external/hig-foundations/) | `external` | Apple Human Interface Guidelines design foundations. |
-| [`hig-inputs`](./external/hig-inputs/) | `external` | Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. |
-| [`hig-patterns`](./external/hig-patterns/) | `external` | Apple Human Interface Guidelines interaction and UX patterns. |
-| [`hig-platforms`](./external/hig-platforms/) | `external` | Apple Human Interface Guidelines for platform-specific design. |
-| [`hig-technologies`](./external/hig-technologies/) | `external` | Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. |
+| [`hig-foundations`](./external/hig-foundations/) | `external` | Apple Human Interface Guidelines design foundations. Use when a design decision turns on Apple's foundations: layout, typography, colour, mo |
+| [`hig-inputs`](./external/hig-inputs/) | `external` | Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. Us |
+| [`hig-patterns`](./external/hig-patterns/) | `external` | Apple Human Interface Guidelines interaction and UX patterns. Use when an interaction or UX pattern on an Apple platform needs designing or  |
+| [`hig-platforms`](./external/hig-platforms/) | `external` | Apple Human Interface Guidelines for platform-specific design. Use when a design has to fit a specific Apple platform's conventions. |
+| [`hig-technologies`](./external/hig-technologies/) | `external` | Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. Us |
 | [`homekit-matter`](./external/homekit-matter/) | `external` | Control smart-home accessories and commission Matter devices using HomeKit and MatterSupport. Use when managing homes/rooms/accessories, cre |
 | [`ios-accessibility`](./external/ios-accessibility/) | `external` | Implements, reviews, or improves accessibility in iOS/macOS apps with SwiftUI, UIKit, and AppKit. Use when adding VoiceOver, Voice Control,  |
-| [`ios-debugger-agent`](./external/ios-debugger-agent/) | `external` | Debug the current iOS project on a booted simulator with XcodeBuildMCP. |
+| [`ios-debugger-agent`](./external/ios-debugger-agent/) | `external` | Debug the current iOS project on a booted simulator with XcodeBuildMCP. Use when an iOS bug has to be reproduced and diagnosed on a booted s |
 | [`ios-developer`](./external/ios-developer/) | `external` | Develop native iOS applications with Swift/SwiftUI. Masters iOS 18, SwiftUI, UIKit integration, Core Data, networking, and App Store optimiz |
 | [`ios-localization`](./external/ios-localization/) | `external` | Implement, review, or improve localization and internationalization in iOS/macOS apps  -  String Catalogs (.xcstrings), generated localizabl |
 | [`ios-networking`](./external/ios-networking/) | `external` | Build, review, or improve networking code in iOS/macOS apps using URLSession with async/await, structured concurrency, and modern Swift patt |
 | [`ios-security`](./external/ios-security/) | `external` | Secure iOS apps with Keychain Services, CryptoKit encryption, biometric authentication (Face ID, Touch ID), Secure Enclave key storage, LACo |
 | [`ios-simulator`](./external/ios-simulator/) | `external` | Manages iOS Simulator devices and tests app behavior using xcrun simctl. Covers device lifecycle (create, boot, shutdown, erase, delete), ap |
 | [`live-activities`](./external/live-activities/) | `external` | Implement, review, or improve Live Activities and Dynamic Island experiences in iOS apps using ActivityKit. Use when building real-time upda |
-| [`macos-menubar-tuist-app`](./external/macos-menubar-tuist-app/) | `external` | Build, refactor, or review SwiftUI macOS menubar apps that use Tuist. |
-| [`macos-spm-app-packaging`](./external/macos-spm-app-packaging/) | `external` | Scaffold, build, sign, and package SwiftPM macOS apps without Xcode projects. |
+| [`macos-menubar-tuist-app`](./external/macos-menubar-tuist-app/) | `external` | Build, refactor, or review SwiftUI macOS menubar apps that use Tuist. Use when building, refactoring or reviewing a SwiftUI macOS menubar ap |
+| [`macos-spm-app-packaging`](./external/macos-spm-app-packaging/) | `external` | Scaffold, build, sign, and package SwiftPM macOS apps without Xcode projects. Use when a SwiftPM macOS app has to be built, signed or packag |
 | [`mapkit-location`](./external/mapkit-location/) | `external` | Implement, review, or improve maps and location features in iOS/macOS apps using MapKit and CoreLocation. Use when working with Map views, a |
 | [`metrickit-diagnostics`](./external/metrickit-diagnostics/) | `external` | Collect and analyze on-device performance metrics and crash diagnostics using MetricKit. Use when setting up MXMetricManager, handling MXMet |
 | [`musickit-audio`](./external/musickit-audio/) | `external` | Integrate Apple Music playback, catalog search, and Now Playing metadata using MusicKit and MediaPlayer. Use when adding music search, Apple |
@@ -135,7 +135,7 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`swift-charts`](./external/swift-charts/) | `external` | Implement, review, or improve data visualizations using Swift Charts. Use when building bar, line, area, point, pie, donut, or iOS 26 3D cha |
 | [`swift-codable`](./external/swift-codable/) | `external` | Implement Swift Codable models for JSON and property-list encoding and decoding with JSONDecoder, JSONEncoder, CodingKeys, and custom init(f |
 | [`swift-concurrency`](./external/swift-concurrency/) | `external` | Resolve Swift concurrency compiler errors, adopt approachable concurrency (SE-0466), and write data-race-safe async code. Use when fixing Se |
-| [`swift-concurrency-expert`](./external/swift-concurrency-expert/) | `external` | Review and fix Swift concurrency issues such as actor isolation and Sendable violations. |
+| [`swift-concurrency-expert`](./external/swift-concurrency-expert/) | `external` | Review and fix Swift concurrency issues such as actor isolation and Sendable violations. Use when a Swift concurrency problem needs diagnosi |
 | [`swift-concurrency-pro`](./external/swift-concurrency-pro/) | `external` | Reviews Swift code for concurrency correctness, modern API usage, and common async/await pitfalls. Use when reading, writing, or reviewing S |
 | [`swift-formatstyle`](./external/swift-formatstyle/) | `external` | Format values for display using the FormatStyle protocol and its concrete types. Use when formatting numbers (integers, floating-point, deci |
 | [`swift-language`](./external/swift-language/) | `external` | Apply modern Swift language patterns and idioms for non-concurrency, non-SwiftUI code. Covers if/switch expressions (Swift 5.9+), typed thro |
@@ -153,11 +153,11 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`swiftui-navigation`](./external/swiftui-navigation/) | `external` | Implement SwiftUI navigation patterns including NavigationStack, NavigationSplitView, sheet presentation, tab-based navigation, and deep lin |
 | [`swiftui-patterns`](./external/swiftui-patterns/) | `external` | Builds SwiftUI views with modern MV architecture, state management, and view composition patterns. Covers @Observable ownership rules, @Stat |
 | [`swiftui-performance`](./external/swiftui-performance/) | `external` | Audit and improve SwiftUI runtime performance. Use when diagnosing slow rendering, janky scrolling, high CPU, memory usage, excessive view u |
-| [`swiftui-performance-audit`](./external/swiftui-performance-audit/) | `external` | Audit SwiftUI performance issues from code review and profiling evidence. |
+| [`swiftui-performance-audit`](./external/swiftui-performance-audit/) | `external` | Audit SwiftUI performance issues from code review and profiling evidence. Use when a SwiftUI view is slow and the cause has to be found from |
 | [`swiftui-pro`](./external/swiftui-pro/) | `external` | Comprehensively reviews SwiftUI code for best practices on modern APIs, maintainability, and performance. Use when reading, writing, or revi |
-| [`swiftui-ui-patterns`](./external/swiftui-ui-patterns/) | `external` | Apply proven SwiftUI UI patterns for navigation, sheets, async state, and reusable screens. |
+| [`swiftui-ui-patterns`](./external/swiftui-ui-patterns/) | `external` | Apply proven SwiftUI UI patterns for navigation, sheets, async state, and reusable screens. Use when a SwiftUI screen needs a proven pattern |
 | [`swiftui-uikit-interop`](./external/swiftui-uikit-interop/) | `external` | Bridges UIKit and SwiftUI by wrapping UIKit views and view controllers in SwiftUI with UIViewRepresentable and UIViewControllerRepresentable |
-| [`swiftui-view-refactor`](./external/swiftui-view-refactor/) | `external` | Refactor SwiftUI views into smaller components with stable, explicit data flow. |
+| [`swiftui-view-refactor`](./external/swiftui-view-refactor/) | `external` | Refactor SwiftUI views into smaller components with stable, explicit data flow. Use when a SwiftUI view has grown too large and needs splitt |
 | [`swiftui-webkit`](./external/swiftui-webkit/) | `external` | Embeds and controls web content in SwiftUI with WebKit for SwiftUI, including WebView, WebPage, navigation policies, JavaScript execution, o |
 | [`tipkit`](./external/tipkit/) | `external` | Implement, review, or improve in-app tips and onboarding using Apple's TipKit framework. Use when adding feature discovery tooltips, onboard |
 | [`vision-framework`](./external/vision-framework/) | `external` | Implement computer vision features including text recognition (OCR), face detection, barcode scanning, image segmentation, object tracking,  |
@@ -168,7 +168,7 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 
 | Skill | Group | Description |
 |-------|-------|-------------|
-| [`android_ui_verification`](./external/android_ui_verification/) | `external` | Automated end-to-end UI testing and verification on an Android Emulator using ADB. |
+| [`android_ui_verification`](./external/android_ui_verification/) | `external` | Automated end-to-end UI testing and verification on an Android Emulator using ADB. Use when an Android build needs driving on an emulator to |
 | [`android-architecture`](./external/android-architecture/) | `external` | Design and implement Clean Architecture with multi-module structure on Android. Covers domain/data/presentation layers, Hilt dependency inje |
 | [`android-jetpack-compose-expert`](./external/android-jetpack-compose-expert/) | `external` | Expert guidance for building modern Android UIs with Jetpack Compose, covering state management, navigation, performance, and Material Desig |
 | [`android-performance`](./external/android-performance/) | `external` | Optimize Android app performance with Baseline Profiles for startup, Compose stability annotations (@Stable, @Immutable, strong skipping), r |
@@ -177,7 +177,7 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`compose-navigation`](./external/compose-navigation/) | `external` | Implement type-safe navigation in Jetpack Compose using Navigation 2.8+ with @Serializable routes, NavHost, composable<Route>, nested naviga |
 | [`compose-testing`](./external/compose-testing/) | `external` | Test Jetpack Compose UI with createComposeRule, semantic matchers (onNodeWithText, onNodeWithTag, onNodeWithContentDescription), actions (pe |
 | [`gradle-kotlin-dsl`](./external/gradle-kotlin-dsl/) | `external` | Configure Android builds with Gradle Kotlin DSL, version catalogs (libs.versions.toml), convention plugins (build-logic module), common conf |
-| [`kotlin-coroutines-expert`](./external/kotlin-coroutines-expert/) | `external` | Expert patterns for Kotlin Coroutines and Flow, covering structured concurrency, error handling, and testing. |
+| [`kotlin-coroutines-expert`](./external/kotlin-coroutines-expert/) | `external` | Expert patterns for Kotlin Coroutines and Flow, covering structured concurrency, error handling, and testing. Use when writing or reviewing  |
 | [`play-store-review`](./external/play-store-review/) | `external` | Prepare Android apps for Google Play Store review and compliance. Covers Google Play policy requirements, content rating questionnaire, targ |
 | [`retrofit-networking`](./external/retrofit-networking/) | `external` | Build networking layers on Android with Retrofit, OkHttp, and Kotlin Coroutines. Covers suspend functions in API interfaces, OkHttp intercep |
 | [`room-database`](./external/room-database/) | `external` | Implement Room database persistence on Android with @Entity, @Dao, @Database, Flow-based reactive queries, TypeConverters for complex types, |
@@ -186,22 +186,22 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 
 | Skill | Group | Description |
 |-------|-------|-------------|
-| [`css-modern`](./external/css-modern/) | `external` | Modern CSS: container queries, nesting, @layer, Grid/Flexbox patterns, custom properties, animations, and transitions |
-| [`html-semantic`](./external/html-semantic/) | `external` | Semantic HTML5: elements, forms with validation and accessibility, SEO best practices, structured data, Open Graph, Twitter Cards |
-| [`nextjs-app-router`](./external/nextjs-app-router/) | `external` | Next.js 15+ App Router: Server/Client Components, Server Actions, data fetching, layouts, middleware, ISR/SSG/SSR, and routing patterns |
-| [`react-best-practices`](./external/react-best-practices/) | `external` | React 19+ best practices: Server Components, use() hook, Actions, hooks patterns, state management, and performance optimization |
-| [`tailwind-css`](./external/tailwind-css/) | `external` | Tailwind CSS v4: utility-first styling, responsive design, dark mode, custom themes, component patterns, and cn() utility |
-| [`typescript-patterns`](./external/typescript-patterns/) | `external` | Modern TypeScript patterns: strict mode, utility types, generics, conditional types, type guards, discriminated unions, Zod validation |
-| [`vue-composition`](./external/vue-composition/) | `external` | Vue 3 Composition API: ref, reactive, computed, watch, composables, Pinia state management, Vue Router 4, script setup |
-| [`web-accessibility`](./external/web-accessibility/) | `external` | WCAG 2.2 AA web accessibility: ARIA roles/states, keyboard navigation, screen readers, color contrast, focus management, axe-core testing |
-| [`web-performance`](./external/web-performance/) | `external` | Web performance: Core Web Vitals (LCP, INP, CLS), image optimization, code splitting, caching strategies, bundle analysis, Lighthouse |
-| [`web-testing`](./external/web-testing/) | `external` | Web testing: Vitest unit tests, React Testing Library, Playwright E2E, MSW API mocking, testing hooks and async operations |
+| [`css-modern`](./external/css-modern/) | `external` | Modern CSS: container queries, nesting, @layer, Grid/Flexbox patterns, custom properties, animations, and transitions. Use when writing or r |
+| [`html-semantic`](./external/html-semantic/) | `external` | Semantic HTML5: elements, forms with validation and accessibility, SEO best practices, structured data, Open Graph, Twitter Cards. Use when  |
+| [`nextjs-app-router`](./external/nextjs-app-router/) | `external` | Next.js 15+ App Router: Server/Client Components, Server Actions, data fetching, layouts, middleware, ISR/SSG/SSR, and routing patterns. Use |
+| [`react-best-practices`](./external/react-best-practices/) | `external` | React 19+ best practices: Server Components, use() hook, Actions, hooks patterns, state management, and performance optimization. Use when b |
+| [`tailwind-css`](./external/tailwind-css/) | `external` | Tailwind CSS v4: utility-first styling, responsive design, dark mode, custom themes, component patterns, and cn() utility. Use when styling  |
+| [`typescript-patterns`](./external/typescript-patterns/) | `external` | Modern TypeScript patterns: strict mode, utility types, generics, conditional types, type guards, discriminated unions, Zod validation. Use  |
+| [`vue-composition`](./external/vue-composition/) | `external` | Vue 3 Composition API: ref, reactive, computed, watch, composables, Pinia state management, Vue Router 4, script setup. Use when building or |
+| [`web-accessibility`](./external/web-accessibility/) | `external` | WCAG 2.2 AA web accessibility: ARIA roles/states, keyboard navigation, screen readers, color contrast, focus management, axe-core testing. U |
+| [`web-performance`](./external/web-performance/) | `external` | Web performance: Core Web Vitals (LCP, INP, CLS), image optimization, code splitting, caching strategies, bundle analysis, Lighthouse. Use w |
+| [`web-testing`](./external/web-testing/) | `external` | Web testing: Vitest unit tests, React Testing Library, Playwright E2E, MSW API mocking, testing hooks and async operations. Use when writing |
 
 ## Backend / API
 
 | Skill | Group | Description |
 |-------|-------|-------------|
-| [`api-patterns`](./external/api-patterns/) | `external` | API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination. |
+| [`api-patterns`](./external/api-patterns/) | `external` | API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination. Use when choosing be |
 | [`api-security-best-practices`](./external/api-security-best-practices/) | `external` | Implement secure API design patterns including authentication, authorization, input validation, rate limiting, and protection against common |
 | [`database-patterns`](./external/database-patterns/) | `external` | Database patterns: SQL best practices (PostgreSQL), indexing, query optimization, migrations, schema design, ORMs (SQLAlchemy, Prisma, Drizz |
 | [`docker-expert`](./external/docker-expert/) | `external` | You are an advanced Docker containerization expert with comprehensive, practical knowledge of container optimization, security hardening, mu |
@@ -209,9 +209,9 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`monorepo-architect`](./external/monorepo-architect/) | `external` | Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient mu |
 | [`nodejs-backend-patterns`](./external/nodejs-backend-patterns/) | `external` | Comprehensive guidance for building scalable, maintainable, and production-ready Node.js backend applications with modern frameworks, archit |
 | [`observability-engineer`](./external/observability-engineer/) | `external` | Build production-ready monitoring, logging, and tracing systems. Implements comprehensive observability strategies, SLI/SLO management, and  |
-| [`python-patterns`](./external/python-patterns/) | `external` | Modern Python 3.12+: type hints, dataclasses, Pydantic v2, async/await, context managers, generators, pattern matching |
-| [`rest-api-design`](./external/rest-api-design/) | `external` | REST API design: HTTP methods, status codes, pagination, versioning, rate limiting, caching headers, OpenAPI documentation |
-| [`testing-backend`](./external/testing-backend/) | `external` | Backend testing: pytest patterns (Python), Jest patterns (Node.js), integration testing, database fixtures/factories, API contract testing |
+| [`python-patterns`](./external/python-patterns/) | `external` | Modern Python 3.12+: type hints, dataclasses, Pydantic v2, async/await, context managers, generators, pattern matching. Use when writing or  |
+| [`rest-api-design`](./external/rest-api-design/) | `external` | REST API design: HTTP methods, status codes, pagination, versioning, rate limiting, caching headers, OpenAPI documentation. Use when a REST  |
+| [`testing-backend`](./external/testing-backend/) | `external` | Backend testing: pytest patterns (Python), Jest patterns (Node.js), integration testing, database fixtures/factories, API contract testing.  |
 
 ## Cross-cutting
 
@@ -222,7 +222,7 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`architecture`](./external/architecture/) | `external` | Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisi |
 | [`avkit`](./external/avkit/) | `external` | Create media playback experiences using AVKit. Use when adding video players with AVPlayerViewController, enabling Picture-in-Picture, routi |
 | [`backlog`](./external/backlog/) | `external` | The engineering backlog registry for deferred-but-approved work in this codebase. Every job the user defers ('defer it', 'add it to the list |
-| [`ci-cd-pipelines`](./external/ci-cd-pipelines/) | `external` | CI/CD pipelines: GitHub Actions workflows, Docker multi-stage builds, environment management, secret management, deployment strategies |
+| [`ci-cd-pipelines`](./external/ci-cd-pipelines/) | `external` | CI/CD pipelines: GitHub Actions workflows, Docker multi-stage builds, environment management, secret management, deployment strategies. Use  |
 | [`clean-code`](./external/clean-code/) | `external` | This skill embodies the principles of \"Clean Code\" by Robert C. Martin (Uncle Bob). Use it to transform \"code that works\" into \"code th |
 | [`closed-loop-delivery`](./external/closed-loop-delivery/) | `external` | Use when a coding task must be completed against explicit acceptance criteria with minimal user re-intervention across implementation, revie |
 | [`context-compression`](./external/context-compression/) | `external` | When agent sessions generate millions of tokens of conversation history, compression becomes mandatory. The naive approach is aggressive com |
@@ -231,8 +231,8 @@ Source layout is logical grouping only  -  skill discovery at runtime is unchang
 | [`cryptokit`](./external/cryptokit/) | `external` | Use Apple CryptoKit for Swift cryptographic primitives. Use when hashing with SHA-2 or SHA-3, generating HMACs, encrypting with AES-GCM or C |
 | [`debugging-instruments`](./external/debugging-instruments/) | `external` | Debug iOS apps and profile performance using LLDB, Memory Graph Debugger, and Instruments. Use when diagnosing crashes, memory leaks, retain |
 | [`debugging-strategies`](./external/debugging-strategies/) | `external` | Transform debugging from frustrating guesswork into systematic problem-solving with proven strategies, powerful tools, and methodical approa |
-| [`github-actions-templates`](./external/github-actions-templates/) | `external` | Production-ready GitHub Actions workflow patterns for testing, building, and deploying applications. |
-| [`help-skills`](./external/help-skills/) | `external` | Mevcut tum iOS/Swift skill'lerini listeler ve ne ise yaradiklarini aciklar. |
+| [`github-actions-templates`](./external/github-actions-templates/) | `external` | Production-ready GitHub Actions workflow patterns for testing, building, and deploying applications. Use when a GitHub Actions workflow has  |
+| [`help-skills`](./external/help-skills/) | `external` | Mevcut tum iOS/Swift skill'lerini listeler ve ne ise yaradiklarini aciklar. Use when asked which iOS or Swift skills are available and what  |
 | [`humanizer`](./external/humanizer/) | `external` | \| |
 | [`pdfkit`](./external/pdfkit/) | `external` | Display and manipulate PDF documents using PDFKit. Use when embedding PDFView to show PDF files, creating or modifying PDFDocument instances |
 | [`search-first`](./external/search-first/) | `external` | \| |

package/pipeline/skills/shared/core/apple-archive-compliance/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: apple-archive-compliance
 language: en
-description: "Apple App Store Review compliance  -  wraps the dev-toolkit-mcp `ios_app_store_audit` tool (18-rule deep scan) with ITMS error code mapping + EN/TR humanizer templates. Consumed by: /multi-agent:test 'store-ready' (primary dispatch), Phase 4 Security Auditor (catalog cross-ref on Info.plist / PrivacyInfo / entitlements diffs), /multi-agent:review (PR citation), /multi-agent:channels (PR body auto-augmentation). Wiring enforced by smoke-compliance-skills.sh."
+description: "Apple App Store Review compliance  -  wraps the dev-toolkit-mcp `ios_app_store_audit` tool (18-rule deep scan) with ITMS error code mapping + EN/TR humanizer templates. Consumed by: /multi-agent:test 'store-ready' (primary dispatch), Phase 4 Security Auditor (catalog cross-ref on Info.plist / PrivacyInfo / entitlements diffs), /multi-agent:review (PR citation), /multi-agent:channels (PR body auto-augmentation). Wiring enforced by smoke-compliance-skills.sh. Use when an .xcarchive needs an App Store review check before submission, or a rejection has to be diagnosed."
 user-invocable: true
 argument-hint: '[archive-path] [--threshold=error|warning|info] [--format=markdown|json] [--lang=en|tr]   -  no-arg: picks most recent .xcarchive from ~/Library/Developer/Xcode/Archives/'
 ---

package/pipeline/skills/shared/core/google-play-compliance/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: google-play-compliance
 language: en
-description: "Google Play Store publication compliance  -  bundletool + aapt2 + apksigner orchestration + 21-rule policy catalog with Play Console error codes + humanizer templates. Consumed by: /multi-agent:test 'store-ready' (primary dispatch), Phase 4 Security Auditor (catalog cross-ref on AndroidManifest / build.gradle / proguard / signing diffs), /multi-agent:review (PR citation), /multi-agent:channels (PR body auto-augmentation). Wiring enforced by smoke-compliance-skills.sh."
+description: "Google Play Store publication compliance  -  bundletool + aapt2 + apksigner orchestration + 21-rule policy catalog with Play Console error codes + humanizer templates. Consumed by: /multi-agent:test 'store-ready' (primary dispatch), Phase 4 Security Auditor (catalog cross-ref on AndroidManifest / build.gradle / proguard / signing diffs), /multi-agent:review (PR citation), /multi-agent:channels (PR body auto-augmentation). Wiring enforced by smoke-compliance-skills.sh. Use when an .aab or .apk needs a Play policy check before upload, or a Play rejection has to be diagnosed."
 user-invocable: true
 argument-hint: '[bundle-path] [--threshold=error|warning|info] [--format=markdown|json] [--lang=en|tr]   -  no-arg: picks most recent .aab from app/build/outputs/bundle/release/'
 ---

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

@@ -1,7 +1,7 @@
 ---
 name: multi-agent
 language: en
-description: "Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Fable + Sonnet on Claude Code, GPT + Opus + Sonnet on Copilot CLI) → commit → log. Every step is written to agent-log.md."
+description: "Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Fable + Sonnet on Claude Code, GPT + Opus + Sonnet on Copilot CLI) → commit → log. Every step is written to agent-log.md. Use when given a Jira ID, a GitHub issue or a free-text task and the whole pipeline should run."
 user-invocable: true
 argument-hint: '"PROJ-12345" "feature/PROJ-12345-flight-filter" | "https://github.com/.../issues/316" | status | log #1 | resume #1 | kill #1 | clear-logs | purge | review'
 ---
@@ -281,6 +281,14 @@ When `dynamicSkillLoading=true` AND the target install is index-only, subagent p
 Run phases sequentially. Log every step to `agent-log.md`.
 If any phase fails, mark task as `paused` and stop  -  user can `resume` later.
 
+**The blocks below are the routing summary, not the specification.** Each phase's
+full contract lives in `$HOME/.claude/multi-agent-refs/phases/phase-{n}-{name}.md`
+(3200 lines across the set) and is read when that phase actually starts. Modes are
+in `phases/modes.md`, operations in `phases/operations.md`, the log shape in
+`phases/log-format.md`. Where a summary here and a ref disagree, the ref wins and
+the summary is the bug: this file used to carry its own copy of the log format,
+and the copy named a path the code had stopped using.
+
 ### Canonical phase labels (TaskCreate + banner)
 
 Every user-facing phase title  -  TaskCreate cards, `phase-banner.sh` headers, and any status line rendered to the terminal  -  MUST come from this table. Labels are always English (`promptLanguage` is locked to `en`):
@@ -570,206 +578,24 @@ Skip this sub-step if the task is NOT a component implementation (e.g., bug fix,
 
 ## Log File Format
 
-Create at `.worktrees/PROJ-{id}/agent-log.md`:
-
-```markdown
-# PROJ-{id}  -  {Task Title}
-**Branch**: {branch-name}
-**Project**: {my-ios-app | my-figma-app}
-**Started**: {YYYY-MM-DD HH:mm}
-**Finished**: {YYYY-MM-DD HH:mm}
-**Total Duration**: {Xm Ys}
-**Status**: 🔄 In Progress | ✅ Complete | ⏸️ Paused | ❌ Failed
-
-## Timeline
-
-| # | Phase | Agent | Model | Duration | Tokens (in/out) | Status | Detail |
-|---|-------|-------|-------|----------|-----------------|--------|--------|
-
-> `Tokens (in/out)` is fed per row from the `phase-tracker.sh tokens` accumulator. If there is no token telemetry, the cell is printed as ` - `.
-
-## Agent Activity Report
-
-### Agent Usage
-| Agent | Call Count | Total Duration | Model(s) | Skill Count |
-|-------|-------------|-------------|------------|-------------|
-| explore | 3 | 12s | haiku | 0 |
-| ios-architect | 1 | 8s | opus | 6 |
-| code-reviewer | 3 | 37s | opus, gpt-5.4, sonnet | 5 each |
-| security-auditor | 1 | 6s | sonnet | 4 |
-| task (build) | 4 | 2m 15s | haiku | 0 |
-| **TOTAL** | **12** | **3m 18s** | | |
-
-### Token Estimate
-| Category | Amount |
-|----------|--------|
-| Main agent (orchestrator) | ~{N}K tokens |
-| Sub-agents (total) | ~{N}K tokens |
-| **Total estimate** | **~{N}K tokens** |
-| Premium request count | ~{N} |
-
-> Token amounts are estimates. For exact usage, run the `/usage` command.
-
-### Per-Phase Time Distribution
-```
-Phase 0: Init       ████░░░░░░░░░░░░  5s
-Phase 1: Analysis   ██████░░░░░░░░░░  12s
-Phase 2: Planning   █████░░░░░░░░░░░  8s
-Phase 3: Dev        ████████████████  2m 35s  ← longest
-Phase 4: Review     ████████░░░░░░░░  37s
-Phase 5: Test  ██░░░░░░░░░░░░░░  (waiting on user)
-Phase 6: Commit     ██░░░░░░░░░░░░░░  3s
-Phase 7: Report    ███░░░░░░░░░░░░░  17s  ← Jira + Wiki + Confluence + Log + Knowledge
-```
-
-### Review Iterations
-| Iteration | Blocking | Important | Suggestion | Decision |
-|-----------|----------|-----------|------------|-------|
-| R1 | 0 | 1 | 2 | 🟡 fix + re-review |
-| R2 | 0 | 0 | 1 | 🟢 pass |
-
-## Files Changed
-
-## Review Consensus
-
-## Cost Breakdown
-
-(Printed in Phase 7 via `pipeline/scripts/render-agent-log-cost.sh <task-id>`. If there is no token data in the tracker, the renderer returns exit 2 and this section is silently skipped.)
-
-| Phase | Model | Tokens in | Tokens out | Est. USD |
-|-------|-------|-----------|------------|----------|
-
-## Test Scenarios (Jira)
-```
-
-### Cost Breakdown  -  emit contract
-
-The Phase 7 agent-log compose step always attempts this render:
-
-```bash
-COST_BLOCK=$(bash pipeline/scripts/render-agent-log-cost.sh "$TASK_ID" 2>/dev/null) && \
-  printf '\n%s\n' "$COST_BLOCK" >> "$AGENT_LOG"
-```
-
-Independent of `reportContent.costSummary`  -  agent-log always carries it, PR/Jira bodies are opt-in. The renderer uses `cost-table.json`; a price update flows from a single point to both surfaces at once.
-
----
-
-## SwiftUI Component Generation Guide (Generic)
-
-When the task involves creating a SwiftUI component (any project, not just figma), follow this architecture:
-
-### Component Architecture: Configuration / View / Modifiers
+Canonical shape, and the path the code actually uses, live in
+`$HOME/.claude/multi-agent-refs/phases/log-format.md`. Read it when writing
+the log; do not re-derive the format here.
 
-Every component produces up to 5 files:
+This section used to carry its own copy of the whole template, and the copy
+had gone stale in a way that mattered: it said the log lives at
+`.worktrees/PROJ-{id}/agent-log.md`, while `prune-logs.sh` and the phase
+tracker both use `$HOME/.claude/logs/multi-agent/{project}/{task-id}/`. Two
+answers for one path, and the wrong one was the one loaded on every run.
 
-| File | When | Content |
-|------|------|---------|
-| `{Name}Configuration.swift` | Complex (>3 props) | Pure value type, all declarative properties |
-| `{Name}View.swift` | Always | SwiftUI view, renders Configuration |
-| `{Name}+Modifiers.swift` | Complex | Fluent modifier API chain |
-| `{Name}Preview.swift` | Always | All meaningful variant previews |
-| `{Name}Tests.swift` | Always | ViewInspector + Unit tests |
+## Component Generation
 
-### Configuration Purity Rule
+Generic guide: `$HOME/.claude/multi-agent-refs/component-generation.md`.
+Dispatch (which plugin skill handles it per CLI):
+`$HOME/.claude/multi-agent-refs/component-dispatch.md`.
 
-Configuration structs hold ONLY declarative, value-type properties:
-
-```swift
-// ✅ CORRECT  -  pure value type
-struct ButtonConfiguration {
-    var title: String = ""
-    var style: ButtonStyle = .primary
-    var isEnabled: Bool = true
-    var icon: Image? = nil
-}
-
-// ❌ WRONG  -  these do NOT belong in Configuration
-// Closures → View property
-// @Binding → View property
-// @State → View property
-// AnyView / @ViewBuilder → View generic parameter
-```
-
-### View Implementation
-
-```swift
-struct ButtonView: View {
-    let configuration: ButtonConfiguration
-    private var action: (() -> Void)?  // closure lives in View, not Config
-
-    var body: some View {
-        Button(action: { action?() }) {
-            HStack(spacing: .Spacing.spacing8) {
-                if let icon = configuration.icon { icon }
-                Text(configuration.title)
-                    .typographyStyle(.body1)
-            }
-        }
-        .disabled(!configuration.isEnabled)
-    }
-}
-```
-
-### Modifier Pattern
-
-```swift
-extension ButtonView {
-    func title(_ value: String) -> ButtonView {
-        var config = configuration
-        config.title = value
-        return ButtonView(configuration: config)
-    }
-    func style(_ value: ButtonStyle) -> ButtonView {
-        var config = configuration
-        config.style = value
-        return ButtonView(configuration: config)
-    }
-    func onTap(_ action: @escaping () -> Void) -> ButtonView {
-        var view = self
-        view.action = action
-        return view
-    }
-}
-```
-
-### Simple vs Complex Decision
-
-| Criteria | Simple | Complex |
-|----------|--------|---------|
-| Properties | ≤3 | >3 |
-| Configuration file | No  -  props in View directly | Yes  -  separate struct |
-| +Modifiers file | No | Yes |
-| View file | All-in-one | Renders Configuration |
-
-### 3-Layer Test Strategy
-
-| Layer | Tool | What It Validates |
-|-------|------|-------------------|
-| Structural | ViewInspector | Hierarchy, subview existence, applied modifiers |
-| Visual | Snapshot Tests | Pixel-correct render: light/dark, RTL/LTR |
-| Behavioral | Unit Tests | State changes, closures, configuration mutations |
-
-### Component Checklist (Before Commit)
-
-1. No magic numbers  -  all values are design tokens or named constants
-2. Configuration purity  -  no side-effects or view logic in Config
-3. Modifier correctness  -  fluent API valid, paired modifiers live in the View
-4. Accessibility  -  accessibility label/trait on every interactive element
-5. Preview  -  all meaningful variants in the preview
-6. Test  -  structural + unit tests written
-7. Dark mode  -  renders correctly in both color schemes
-8. Dynamic Type  -  text scales at large sizes without breaking the layout
-
-### When a Figma URL Is Provided
-
-If the user provides a Figma URL:
-1. Fetch the design data with Figma MCP tools (get_design_context, get_screenshot)
-2. Map the design's colors, spacing, and typography onto the project's token system
-3. Apply the Configuration/View/Modifiers pattern above
-4. Use the screenshot as a reference, do not copy it  -  adapt to the project's existing components
-
----
+Loaded only for a task that generates a component from a design, which is
+what it is for. It was previously inline and paid for on every run.
 
 ## Rules
 
@@ -868,85 +694,6 @@ When `multi-agent status` is called, show:
 
 ## Help Display
 
-When called with no args or `help`, detect project and show relevant usage with pipeline explanation:
-
-First show how it works:
-```
-🤖 How it works (8 phases):
-  0. Init       -  Project detection, worktree creation, state file
-  1. Analysis   -  Codebase scan (parallel explore agents, Fable)
-  2. Planning   -  Task breakdown, architecture review, user approval
-  3. Dev        -  TDD loop: write test → write code → build (Sonnet)
-  4. Review     -  Parallel review + Fable triage. Reviewer set by CLI:
-                 • Claude Code → Fable + Sonnet (2 parallel)
-                 • Copilot CLI → GPT-5.4 + Opus + Sonnet (3 parallel)
-  5. Test  -  Optional: switch to the branch, manual test in Xcode
-  6. Commit     -  Commit + push + PR + issue body update (PR links + progress flags)
-  7. Report     -  A single logical phase (5 steps):
-                 1) Jira comment (humanized analysis + test scenarios)
-                 2) Component wiki + Figma screenshot + wiki push (for component tasks)
-                 3) Optional Confluence page update
-                 4) Detailed report into agent-log.md + Quality & Metrics + telemetry
-                 5) Knowledge capture (architecture, patterns, gotchas) + memory
-
-Every step is logged to agent-log.md. An error in any phase → pause.
-resume continues from where it left off.
-```
-
-Then show project-specific usage:
-
-**my-ios-app:**
-```
-🤖 Multi-Agent Task Orchestrator (my-ios-app)
-
-Usage:
-  multi-agent "PROJ-XXX" "branch-name"   → Full pipeline → assigns #ID
-  multi-agent status                        → All tasks with #ID, phase, status
-  multi-agent log [#id]                     → View task log
-  multi-agent resume [#id]                  → Resume paused task
-  multi-agent kill [#id]                    → Stop + delete worktree/branch/logs
-  multi-agent clear-logs                    → Delete all logs, keep worktrees
-  multi-agent purge                         → ⚠️ Full reset: delete everything
-  multi-agent review                        → Review current diff only
-
-Example: multi-agent "PROJ-12345" "feature/PROJ-12345-flight-filter"
-```
-
-**my-figma-app:**
-```
-🤖 Multi-Agent Task Orchestrator (figma)
-
-Usage:
-  multi-agent "github-issue-url"            → Full pipeline from issue
-  multi-agent status                        → All tasks with #ID, phase, status
-  multi-agent log [#id]                     → View task log
-  multi-agent resume [#id]                  → Resume paused task
-  multi-agent kill [#id]                    → Stop + delete worktree/branch/logs
-  multi-agent clear-logs                    → Delete all logs, keep worktrees
-  multi-agent purge                         → ⚠️ Full reset: delete everything
-  multi-agent review                        → Review current diff only
-
-Example: multi-agent "https://github.com/my-org/my-figma-app/issues/316"
-```
-
-**generic (any iOS project):**
-```
-🤖 Multi-Agent Task Orchestrator (generic)
-
-Usage:
-  multi-agent "bug/feature description"     → Full pipeline from free-text
-  multi-agent "github-issue-url"            → Full pipeline from issue
-  multi-agent "PROJ-XXX" "branch-name"   → Full pipeline with Jira
-  multi-agent status                        → All tasks with #ID, phase, status
-  multi-agent log [#id]                     → View task log
-  multi-agent resume [#id]                  → Resume paused task
-  multi-agent kill [#id]                    → Stop + delete worktree/branch/logs
-  multi-agent clear-logs                    → Delete all logs, keep worktrees
-  multi-agent purge                         → ⚠️ Full reset: delete everything
-  multi-agent review                        → Review current diff only
-
-Example: multi-agent "In LoginView the button color is invisible in dark mode"
-```
-
-Pipeline: Init → Analysis → Planning → Development → Review → User Test → Commit → Wiki → Report
-Each step logged to: .worktrees/{task-id}/agent-log.md
+Rendered by the `multi-agent-help` skill (`/multi-agent:help`), which owns
+the full text in both languages. It used to be duplicated here in English
+only, on a path this skill takes for exactly one input.