@mmerterden/multi-agent-pipeline 12.5.0 → 12.7.0

package/pipeline/skills/shared/external/testing-backend/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: testing-backend
-description: "Backend testing: pytest patterns (Python), Jest patterns (Node.js), integration testing, database fixtures/factories, API contract testing"
+description: "Backend testing: pytest patterns (Python), Jest patterns (Node.js), integration testing, database fixtures/factories, API contract testing. Use when writing or reviewing backend tests: unit, integration, database and API level."
 tags: [testing, pytest, jest, integration, database, api-testing, backend]
 version: "2025.1"
 ---

package/pipeline/skills/shared/external/typescript-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: typescript-patterns
-description: "Modern TypeScript patterns: strict mode, utility types, generics, conditional types, type guards, discriminated unions, Zod validation"
+description: "Modern TypeScript patterns: strict mode, utility types, generics, conditional types, type guards, discriminated unions, Zod validation. Use when writing or reviewing TypeScript types: generics, utility and conditional types, guards, strict mode."
 tags: [typescript, types, generics, zod, validation, frontend, backend]
 version: "2025.1"
 ---

package/pipeline/skills/shared/external/vue-composition/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vue-composition
-description: "Vue 3 Composition API: ref, reactive, computed, watch, composables, Pinia state management, Vue Router 4, script setup"
+description: "Vue 3 Composition API: ref, reactive, computed, watch, composables, Pinia state management, Vue Router 4, script setup. Use when building or reviewing Vue 3 work with the Composition API, composables or Pinia."
 tags: [vue, composition-api, pinia, vue-router, frontend, javascript]
 version: "2025.1"
 ---

package/pipeline/skills/shared/external/web-accessibility/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: web-accessibility
-description: "WCAG 2.2 AA web accessibility: ARIA roles/states, keyboard navigation, screen readers, color contrast, focus management, axe-core testing"
+description: "WCAG 2.2 AA web accessibility: ARIA roles/states, keyboard navigation, screen readers, color contrast, focus management, axe-core testing. Use when auditing or fixing a web UI against WCAG: ARIA, keyboard access, screen readers, contrast."
 tags: [accessibility, a11y, wcag, aria, screen-reader, frontend]
 version: "2025.1"
 ---

package/pipeline/skills/shared/external/web-performance/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: web-performance
-description: "Web performance: Core Web Vitals (LCP, INP, CLS), image optimization, code splitting, caching strategies, bundle analysis, Lighthouse"
+description: "Web performance: Core Web Vitals (LCP, INP, CLS), image optimization, code splitting, caching strategies, bundle analysis, Lighthouse. Use when a page is slow and Core Web Vitals, images, bundles or caching have to be addressed."
 tags: [performance, core-web-vitals, lighthouse, optimization, frontend, caching]
 version: "2025.1"
 ---

package/pipeline/skills/shared/external/web-testing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: web-testing
-description: "Web testing: Vitest unit tests, React Testing Library, Playwright E2E, MSW API mocking, testing hooks and async operations"
+description: "Web testing: Vitest unit tests, React Testing Library, Playwright E2E, MSW API mocking, testing hooks and async operations. Use when writing or reviewing web tests with Vitest, Testing Library, Playwright or MSW."
 tags: [testing, vitest, playwright, react-testing-library, msw, e2e, frontend]
 version: "2025.1"
 ---

package/pipeline/skills/shared/external/xcode-build-benchmark/schemas/build-benchmark.schema.json

@@ -2,13 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Xcode Build Benchmark Artifact",
   "type": "object",
-  "required": [
-    "schema_version",
-    "created_at",
-    "build",
-    "runs",
-    "summary"
-  ],
+  "required": ["schema_version", "created_at", "build", "runs", "summary"],
   "properties": {
     "schema_version": {
       "type": "string",
@@ -20,20 +14,11 @@
     },
     "build": {
       "type": "object",
-      "required": [
-        "entrypoint",
-        "scheme",
-        "configuration",
-        "destination",
-        "command"
-      ],
+      "required": ["entrypoint", "scheme", "configuration", "destination", "command"],
       "properties": {
         "entrypoint": {
           "type": "string",
-          "enum": [
-            "project",
-            "workspace"
-          ]
+          "enum": ["project", "workspace"]
         },
         "path": {
           "type": "string"
@@ -73,10 +58,7 @@
     },
     "runs": {
       "type": "object",
-      "required": [
-        "clean",
-        "incremental"
-      ],
+      "required": ["clean", "incremental"],
       "properties": {
         "clean": {
           "type": "array",
@@ -101,10 +83,7 @@
     },
     "summary": {
       "type": "object",
-      "required": [
-        "clean",
-        "incremental"
-      ],
+      "required": ["clean", "incremental"],
       "properties": {
         "clean": {
           "$ref": "#/definitions/stats"
@@ -128,24 +107,14 @@
   "definitions": {
     "run": {
       "type": "object",
-      "required": [
-        "id",
-        "build_type",
-        "duration_seconds",
-        "success",
-        "command"
-      ],
+      "required": ["id", "build_type", "duration_seconds", "success", "command"],
       "properties": {
         "id": {
           "type": "string"
         },
         "build_type": {
           "type": "string",
-          "enum": [
-            "clean",
-            "cached-clean",
-            "incremental"
-          ]
+          "enum": ["clean", "cached-clean", "incremental"]
         },
         "duration_seconds": {
           "type": "number",
@@ -174,10 +143,7 @@
     },
     "category": {
       "type": "object",
-      "required": [
-        "name",
-        "seconds"
-      ],
+      "required": ["name", "seconds"],
       "properties": {
         "name": {
           "type": "string"
@@ -195,13 +161,7 @@
     },
     "stats": {
       "type": "object",
-      "required": [
-        "count",
-        "min_seconds",
-        "max_seconds",
-        "median_seconds",
-        "average_seconds"
-      ],
+      "required": ["count", "min_seconds", "max_seconds", "median_seconds", "average_seconds"],
       "properties": {
         "count": {
           "type": "integer",

package/pipeline/skills/skills-index.md

@@ -3,7 +3,7 @@
 > Auto-generated by `pipeline/scripts/build-skills-index.mjs`  -  do not hand-edit.
 > Regenerate with `node pipeline/scripts/build-skills-index.mjs`.
 
-**189 skills** across 2 groups.
+**193 skills** across 2 groups.
 
 | Group | Name | Platform | Description |
 |-------|------|----------|-------------|
@@ -11,19 +11,19 @@
 | external | `agent-introspection-debugging` |  -  | \| |
 | external | `agentflow` |  -  | Orchestrate autonomous AI development pipelines through your Kanban board (Asana, GitHub Projects, Linear). Manages multi-worker Claude Code |
 | external | `alarmkit` |  -  | Implement AlarmKit alarms and countdown timers for iOS and iPadOS with Lock Screen, Dynamic Island, StandBy, and paired Apple Watch system U |
-| external | `android_ui_verification` |  -  | Automated end-to-end UI testing and verification on an Android Emulator using ADB. |
+| external | `android_ui_verification` |  -  | 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 |
 | external | `android-architecture` |  -  | Design and implement Clean Architecture with multi-module structure on Android. Covers domain/data/presentation layers, Hilt dependency inje |
 | external | `android-jetpack-compose-expert` |  -  | Expert guidance for building modern Android UIs with Jetpack Compose, covering state management, navigation, performance, and Material Desig |
 | external | `android-performance` |  -  | Optimize Android app performance with Baseline Profiles for startup, Compose stability annotations (@Stable, @Immutable, strong skipping), r |
 | external | `android-security` |  -  | Secure Android apps with ProGuard/R8 obfuscation, OkHttp certificate pinning, BiometricPrompt authentication, EncryptedSharedPreferences, Pl |
-| external | `api-patterns` |  -  | API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination. |
+| external | `api-patterns` |  -  | API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination. Use when choosing be |
 | external | `api-security-best-practices` |  -  | Implement secure API design patterns including authentication, authorization, input validation, rate limiting, and protection against common |
 | external | `app-clips` |  -  | Build iOS App Clips with invocation URLs, App Clip Codes, NFC, QR codes, Safari banners, Maps, Messages, target setup, App Store Connect exp |
 | external | `app-intents` |  -  | Implement App Intents for Siri, Shortcuts, Spotlight, widgets, Control Center, and Apple Intelligence on iOS. Covers AppIntent actions, AppE |
-| external | `app-store-changelog` |  -  | Generate user-facing App Store release notes from git history since the last tag. |
+| external | `app-store-changelog` |  -  | 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 |
 | external | `app-store-optimization` |  -  | Optimize App Store product pages for search visibility and conversion. Use for App Store Optimization (ASO), keyword research, app name/subt |
 | external | `app-store-review` |  -  | Prepare for App Store review and prevent rejections. Covers App Store review guidelines, app rejection reasons, PrivacyInfo.xcprivacy privac |
-| core | `apple-archive-compliance` |  -  | Apple App Store Review compliance  -  wraps the dev-toolkit-mcp `ios_app_store_audit` tool (17-rule deep scan) with ITMS error code mapping  |
+| core | `apple-archive-compliance` |  -  | Apple App Store Review compliance  -  wraps the dev-toolkit-mcp `ios_app_store_audit` tool (18-rule deep scan) with ITMS error code mapping  |
 | external | `apple-on-device-ai` |  -  | Integrate on-device AI using Foundation Models framework, Core ML, and open-source LLM runtimes on Apple Silicon. Covers Foundation Models ( |
 | external | `architecture` |  -  | Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisi |
 | external | `authentication` |  -  | Implement iOS authentication flows with AuthenticationServices and LocalAuthentication. Use when building Sign in with Apple, passkey/WebAut |
@@ -31,7 +31,7 @@
 | external | `background-processing` |  -  | Schedule and execute background work on iOS using BGTaskScheduler. Use when registering BGAppRefreshTask for short background fetches, BGPro |
 | external | `backlog` |  -  | The engineering backlog registry for deferred-but-approved work in this codebase. Every job the user defers ('defer it', 'add it to the list |
 | external | `callkit-voip` |  -  | Implement VoIP calling with CallKit and PushKit. Use when building incoming/outgoing call flows, registering for VoIP push notifications, co |
-| external | `ci-cd-pipelines` |  -  | CI/CD pipelines: GitHub Actions workflows, Docker multi-stage builds, environment management, secret management, deployment strategies |
+| external | `ci-cd-pipelines` |  -  | CI/CD pipelines: GitHub Actions workflows, Docker multi-stage builds, environment management, secret management, deployment strategies. Use  |
 | external | `clean-code` |  -  | This skill embodies the principles of \"Clean Code\" by Robert C. Martin (Uncle Bob). Use it to transform \"code that works\" into \"code th |
 | external | `closed-loop-delivery` |  -  | Use when a coding task must be completed against explicit acceptance criteria with minimal user re-intervention across implementation, revie |
 | external | `cloudkit-sync` |  -  | Implement, review, or improve CloudKit and iCloud sync in iOS/macOS apps. Use when working with CKContainer, CKRecord, CKQuery, CKSubscripti |
@@ -47,7 +47,7 @@
 | external | `coreml` |  -  | Integrate Core ML models in iOS apps for on-device machine learning inference. Covers model loading (.mlmodel, .mlpackage, .mlmodelc), predi |
 | external | `council` |  -  | \| |
 | external | `cryptokit` |  -  | Use Apple CryptoKit for Swift cryptographic primitives. Use when hashing with SHA-2 or SHA-3, generating HMACs, encrypting with AES-GCM or C |
-| external | `css-modern` |  -  | Modern CSS: container queries, nesting, @layer, Grid/Flexbox patterns, custom properties, animations, and transitions |
+| external | `css-modern` |  -  | Modern CSS: container queries, nesting, @layer, Grid/Flexbox patterns, custom properties, animations, and transitions. Use when writing or r |
 | external | `database-patterns` |  -  | Database patterns: SQL best practices (PostgreSQL), indexing, query optimization, migrations, schema design, ORMs (SQLAlchemy, Prisma, Drizz |
 | external | `debugging-instruments` |  -  | Debug iOS apps and profile performance using LLDB, Memory Graph Debugger, and Instruments. Use when diagnosing crashes, memory leaks, retain |
 | external | `debugging-strategies` |  -  | Transform debugging from frustrating guesswork into systematic problem-solving with proven strategies, powerful tools, and methodical approa |
@@ -56,80 +56,84 @@
 | external | `energykit` |  -  | Query grid electricity forecasts and submit load events using EnergyKit to help users optimize home electricity usage. Use when building sma |
 | external | `eventkit-calendar` |  -  | Create, read, and manage calendar events and reminders using EventKit and EventKitUI. Use when adding events to the user's calendar, creatin |
 | external | `fastapi-pro` |  -  | Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async p |
-| external | `firebase` |  -  | You're a developer who has shipped dozens of Firebase projects. You've seen the \"easy\" path lead to security breaches, runaway costs, and  |
-| external | `github-actions-templates` |  -  | Production-ready GitHub Actions workflow patterns for testing, building, and deploying applications. |
+| external | `firebase` |  -  | You're a developer who has shipped dozens of Firebase projects. You've seen the \\"easy\\" path lead to security breaches, runaway costs, an |
+| external | `github-actions-templates` |  -  | Production-ready GitHub Actions workflow patterns for testing, building, and deploying applications. Use when a GitHub Actions workflow has  |
 | core | `google-play-compliance` |  -  | Google Play Store publication compliance  -  bundletool + aapt2 + apksigner orchestration + 21-rule policy catalog with Play Console error c |
 | external | `gradle-kotlin-dsl` |  -  | Configure Android builds with Gradle Kotlin DSL, version catalogs (libs.versions.toml), convention plugins (build-logic module), common conf |
 | external | `healthkit` |  -  | Read, write, and query Apple Health data using HealthKit. Covers HKHealthStore authorization, sample queries, statistics queries, statistics |
-| external | `help-skills` |  -  | Mevcut tum iOS/Swift skill'lerini listeler ve ne ise yaradiklarini aciklar. |
-| external | `hig-components-content` |  -  | Apple Human Interface Guidelines for content display components. |
-| external | `hig-components-layout` |  -  | Apple Human Interface Guidelines for layout and navigation components. |
-| external | `hig-components-status` |  -  | Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings. |
+| external | `help-skills` |  -  | Mevcut tum iOS/Swift skill'lerini listeler ve ne ise yaradiklarini aciklar. Use when asked which iOS or Swift skills are available and what  |
+| external | `hig-components-content` |  -  | Apple Human Interface Guidelines for content display components. Use when designing or reviewing how content is displayed on an Apple platfo |
+| external | `hig-components-layout` |  -  | Apple Human Interface Guidelines for layout and navigation components. Use when designing or reviewing layout and navigation on an Apple pla |
+| external | `hig-components-status` |  -  | Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings. Use when designing  |
 | external | `hig-components-system` |  -  | 'Apple HIG guidance for system experience components: widgets, live activities, notifications, complications, home screen quick actions, top |
-| external | `hig-foundations` |  -  | Apple Human Interface Guidelines design foundations. |
-| external | `hig-inputs` |  -  | Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. |
-| external | `hig-patterns` |  -  | Apple Human Interface Guidelines interaction and UX patterns. |
-| external | `hig-platforms` |  -  | Apple Human Interface Guidelines for platform-specific design. |
-| external | `hig-technologies` |  -  | Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. |
+| external | `hig-foundations` |  -  | Apple Human Interface Guidelines design foundations. Use when a design decision turns on Apple's foundations: layout, typography, colour, mo |
+| external | `hig-inputs` |  -  | Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. Us |
+| external | `hig-patterns` |  -  | Apple Human Interface Guidelines interaction and UX patterns. Use when an interaction or UX pattern on an Apple platform needs designing or  |
+| external | `hig-platforms` |  -  | Apple Human Interface Guidelines for platform-specific design. Use when a design has to fit a specific Apple platform's conventions. |
+| external | `hig-technologies` |  -  | Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. Us |
 | external | `homekit-matter` |  -  | Control smart-home accessories and commission Matter devices using HomeKit and MatterSupport. Use when managing homes/rooms/accessories, cre |
-| external | `html-semantic` |  -  | Semantic HTML5: elements, forms with validation and accessibility, SEO best practices, structured data, Open Graph, Twitter Cards |
+| external | `html-semantic` |  -  | Semantic HTML5: elements, forms with validation and accessibility, SEO best practices, structured data, Open Graph, Twitter Cards. Use when  |
 | external | `humanizer` |  -  | \| |
 | external | `ios-accessibility` |  -  | Implements, reviews, or improves accessibility in iOS/macOS apps with SwiftUI, UIKit, and AppKit. Use when adding VoiceOver, Voice Control,  |
-| external | `ios-debugger-agent` |  -  | Debug the current iOS project on a booted simulator with XcodeBuildMCP. |
+| external | `ios-debugger-agent` |  -  | 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 |
 | external | `ios-developer` |  -  | Develop native iOS applications with Swift/SwiftUI. Masters iOS 18, SwiftUI, UIKit integration, Core Data, networking, and App Store optimiz |
 | external | `ios-localization` |  -  | Implement, review, or improve localization and internationalization in iOS/macOS apps  -  String Catalogs (.xcstrings), generated localizabl |
 | external | `ios-networking` |  -  | Build, review, or improve networking code in iOS/macOS apps using URLSession with async/await, structured concurrency, and modern Swift patt |
 | external | `ios-security` |  -  | Secure iOS apps with Keychain Services, CryptoKit encryption, biometric authentication (Face ID, Touch ID), Secure Enclave key storage, LACo |
 | external | `ios-simulator` |  -  | Manages iOS Simulator devices and tests app behavior using xcrun simctl. Covers device lifecycle (create, boot, shutdown, erase, delete), ap |
-| external | `kotlin-coroutines-expert` |  -  | Expert patterns for Kotlin Coroutines and Flow, covering structured concurrency, error handling, and testing. |
+| external | `kotlin-coroutines-expert` |  -  | Expert patterns for Kotlin Coroutines and Flow, covering structured concurrency, error handling, and testing. Use when writing or reviewing  |
 | external | `live-activities` |  -  | Implement, review, or improve Live Activities and Dynamic Island experiences in iOS apps using ActivityKit. Use when building real-time upda |
-| external | `macos-menubar-tuist-app` |  -  | Build, refactor, or review SwiftUI macOS menubar apps that use Tuist. |
-| external | `macos-spm-app-packaging` |  -  | Scaffold, build, sign, and package SwiftPM macOS apps without Xcode projects. |
+| external | `macos-menubar-tuist-app` |  -  | Build, refactor, or review SwiftUI macOS menubar apps that use Tuist. Use when building, refactoring or reviewing a SwiftUI macOS menubar ap |
+| external | `macos-spm-app-packaging` |  -  | Scaffold, build, sign, and package SwiftPM macOS apps without Xcode projects. Use when a SwiftPM macOS app has to be built, signed or packag |
 | external | `mapkit-location` |  -  | Implement, review, or improve maps and location features in iOS/macOS apps using MapKit and CoreLocation. Use when working with Map views, a |
 | external | `metrickit-diagnostics` |  -  | Collect and analyze on-device performance metrics and crash diagnostics using MetricKit. Use when setting up MXMetricManager, handling MXMet |
 | external | `monorepo-architect` |  -  | Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient mu |
 | core | `multi-agent` |  -  | Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Fable  |
 | core | `multi-agent-analysis` |  -  | Standalone feature-spec analysis (v3 template). Platform-agnostic concept layer with repo-driven convention extraction and per-platform Pass |
 | core | `multi-agent-analysis-resolve` |  -  | 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 |
-| core | `multi-agent-autopilot` |  -  | Launch any task in autopilot mode: skips every confirmation, runs end-to-end autonomously. |
+| core | `multi-agent-autopilot` |  -  | 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 |
 | core | `multi-agent-build-optimize` |  -  | Wrapper that dispatches to xcode-build-orchestrator on iOS repos. Benchmarks the current Xcode build, runs compilation / project / SPM analy |
 | core | `multi-agent-channels` |  -  | Multi-channel reporter  -  Jira/Confluence/Wiki/PR description. Multi-select channels + content, humanizer pass, reviewer-preserving Bitbuck |
 | core | `multi-agent-create-jira` |  -  | Create a standards-compliant Jira issue (Task / Bug / Story): asks the type, mines project conventions, drafts from a standard template with |
-| core | `multi-agent-dev` |  -  | Fast development mode: Init → Dev (Opus) → Test → Commit → Report. Analysis, planning, and review phases are skipped. |
-| core | `multi-agent-dev-autopilot` |  -  | Fastest mode: Dev (Opus) plus Autopilot. Init → Dev → Commit → Report with zero confirmations. |
-| core | `multi-agent-dev-local` |  -  | Fast mode + local  -  Init → Dev(Opus) → Commit → Report, no worktree. |
-| core | `multi-agent-dev-local-autopilot` |  -  | Fastest + local  -  Dev(Opus) + autopilot, no worktree, zero interaction. |
+| core | `multi-agent-design-check` |  -  | Mock-mode vs Figma design audit (iOS / Android, local-only). Pick repo + module, gate on mock support, enumerate every state driver into a c |
+| core | `multi-agent-dev` |  -  | Fast development mode: Init → Dev (Opus) → Test → Commit → Report. Analysis, planning, and review phases are skipped. Use when the work is a |
+| core | `multi-agent-dev-autopilot` |  -  | Fastest mode: Dev (Opus) plus Autopilot. Init → Dev → Commit → Report with zero confirmations. Use when a change is well understood and shou |
+| core | `multi-agent-dev-local` |  -  | Fast mode + local  -  Init → Dev(Opus) → Commit → Report, no worktree. Use when a change should be developed on the current branch without c |
+| core | `multi-agent-dev-local-autopilot` |  -  | Fastest + local  -  Dev(Opus) + autopilot, no worktree, zero interaction. Use when a change should be developed on the current branch with n |
 | core | `multi-agent-diff-explain` |  -  | 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 |
 | core | `multi-agent-finish` |  -  | Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenari |
+| core | `multi-agent-forget` |  -  | Remove a saved /multi-agent routine (created by /multi-agent:save): deletes its local-only command and its registry entry. Asks which one an |
 | core | `multi-agent-garbage-collect` |  -  | Sweep leftover /tmp scratch (picker state, review diffs, channel payloads, analysis drafts) from past runs. Dry-run first; confirms before d |
 | core | `multi-agent-help` |  -  | Multi-agent pipeline usage guide  -  renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatib |
-| core | `multi-agent-issue` |  -  | List unassigned GitHub issues, pick one, auto-assign, and launch the multi-agent pipeline. |
-| core | `multi-agent-jira` |  -  | List open Jira issues, pick one, and launch the multi-agent pipeline. |
-| core | `multi-agent-kill` |  -  | Stop the given task, then remove its worktree and branch. Asks for confirmation. |
-| core | `multi-agent-language` |  -  | Toggle outputLanguage (assistant explanations). promptLanguage is fixed to English. External payloads stay English. |
-| core | `multi-agent-local` |  -  | Full pipeline in local mode  -  no worktree, runs directly on the current branch. |
-| core | `multi-agent-local-autopilot` |  -  | Full pipeline + local + autopilot  -  no worktree, no confirmations, all 8 phases run end-to-end on the current branch. |
-| core | `multi-agent-log` |  -  | Show the agent-log.md for the given task. With no ID, shows the most recent task. |
+| core | `multi-agent-issue` |  -  | 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 |
+| core | `multi-agent-jira` |  -  | 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  |
+| core | `multi-agent-kill` |  -  | 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  |
+| core | `multi-agent-language` |  -  | Toggle outputLanguage (assistant explanations). promptLanguage is fixed to English. External payloads stay English. Use when the assistant s |
+| core | `multi-agent-local` |  -  | Full pipeline in local mode  -  no worktree, runs directly on the current branch. Use when the full pipeline should run on the current branc |
+| core | `multi-agent-local-autopilot` |  -  | Full pipeline + local + autopilot  -  no worktree, no confirmations, all 8 phases run end-to-end on the current branch. Use when the full pi |
+| core | `multi-agent-log` |  -  | 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. |
 | core | `multi-agent-manual-test` |  -  | 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 |
 | core | `multi-agent-prune-logs` |  -  | Delete per-task project logs under ~/.claude/logs/multi-agent (filter by age/project/task). Audit trail + metrics are preserved. Dry-run fir |
-| core | `multi-agent-purge` |  -  | ⚠️ Wipes every worktree, branch, log, and state file. Irreversible; asks for double confirmation. |
-| core | `multi-agent-refactor` |  -  | Analyse the project: extract adapted best-practices, hunt real bugs + improvement areas, check upstream drift of derived skills, draft one p |
-| core | `multi-agent-resume` |  -  | Resume a stopped or failed task from the phase where it left off. |
+| core | `multi-agent-purge` |  -  | ⚠️ Wipes every worktree, branch, log, and state file. Irreversible; asks for double confirmation. Use when every worktree, branch, log and s |
+| core | `multi-agent-refactor` |  -  | Analyse the project: extract adapted best-practices, hunt real bugs + improvement areas, check upstream drift of derived skills, research th |
+| core | `multi-agent-resume` |  -  | 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 |
 | core | `multi-agent-review` |  -  | 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 |
 | core | `multi-agent-review-issue` |  -  | Assess whether a GitHub issue is ready for multi-agent development: fetch it, grade scope / acceptance criteria / repro / design / API / sta |
 | core | `multi-agent-review-jira` |  -  | Assess whether a Jira issue is ready for multi-agent development: fetch it, grade scope / acceptance criteria / repro / design / API / stack |
-| core | `multi-agent-scan` |  -  | Skill security scan: walks local skill directories against a tiered pattern catalog. |
-| core | `multi-agent-search` |  -  | Log search across every agent-log.md with smart ranking and filters. Optional --semantic flag queries the per-repo triage corpus. |
-| core | `multi-agent-setup` |  -  | First-run setup wizard: keychain token discovery, Git Identity onboarding, and pipeline preparation. |
+| core | `multi-agent-routines` |  -  | List your saved /multi-agent routines (from /multi-agent:save) with what each one does, rendered in outputLanguage. Use when asked which sav |
+| core | `multi-agent-save` |  -  | Save a recurring job as a reusable /multi-agent:<name> command. Reviews the conversation + your CLAUDE.md for candidate routines, you pick o |
+| core | `multi-agent-scan` |  -  | Skill security scan: walks local skill directories against a tiered pattern catalog. Use when local skill directories need checking for unsa |
+| core | `multi-agent-search` |  -  | Log search across every agent-log.md with smart ranking and filters. Optional --semantic flag queries the per-repo triage corpus. Use when s |
+| core | `multi-agent-setup` |  -  | First-run setup wizard: keychain token discovery, Git Identity onboarding, and pipeline preparation. Use when the pipeline is being set up f |
 | core | `multi-agent-stack` |  -  | Select the active stack for this repo by enabling the matching marketplace plugin(s) in .claude/settings.json (ios/android/mobile/backend/fr |
-| core | `multi-agent-status` |  -  | Show every multi-agent task's ID, phase, branch, and status. |
-| core | `multi-agent-sync` |  -  | One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, pipeline repo, and website. |
+| core | `multi-agent-status` |  -  | Show every multi-agent task's ID, phase, branch, and status. Use when asked what is running, or for an overview of every task. |
+| core | `multi-agent-sync` |  -  | One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, pipeline repo, website, and the dev-toolkit MCP server. Use whe |
 | core | `multi-agent-test` |  -  | UI Bug Hunter  -  iOS Simulator (simctl) + Android Emulator (adb). Auto-detects platform. Screenshot + tap + analyze on the booted device. T |
 | core | `multi-agent-uninstall` |  -  | Uninstall the pipeline from Claude Code + Copilot CLI. Keychain access tokens are always left untouched; --all-data also clears pipeline set |
-| core | `multi-agent-update` |  -  | Update the pipeline to the latest version: git pull, install, migrate. |
+| core | `multi-agent-update` |  -  | Update the pipeline to the latest version: git pull, install, migrate. Use when the installed pipeline is behind and should be brought to th |
 | external | `musickit-audio` |  -  | Integrate Apple Music playback, catalog search, and Now Playing metadata using MusicKit and MediaPlayer. Use when adding music search, Apple |
 | external | `natural-language` |  -  | Tokenize, tag, and analyze natural language text using Apple's NaturalLanguage framework and translate between languages with the Translatio |
-| external | `nextjs-app-router` |  -  | Next.js 15+ App Router: Server/Client Components, Server Actions, data fetching, layouts, middleware, ISR/SSG/SSR, and routing patterns |
+| external | `nextjs-app-router` |  -  | Next.js 15+ App Router: Server/Client Components, Server Actions, data fetching, layouts, middleware, ISR/SSG/SSR, and routing patterns. Use |
 | external | `nodejs-backend-patterns` |  -  | Comprehensive guidance for building scalable, maintainable, and production-ready Node.js backend applications with modern frameworks, archit |
 | external | `observability-engineer` |  -  | Build production-ready monitoring, logging, and tracing systems. Implements comprehensive observability strategies, SLI/SLO management, and  |
 | external | `passkit-wallet` |  -  | Integrate Apple Pay payments and Wallet passes using PassKit. Use when adding Apple Pay buttons, creating payment requests, handling payment |
@@ -139,10 +143,10 @@
 | external | `photos-camera-media` |  -  | Implement, review, or improve photo picking, camera capture, and media handling in iOS apps using PhotoKit and AVFoundation. Use when workin |
 | external | `play-store-review` |  -  | Prepare Android apps for Google Play Store review and compliance. Covers Google Play policy requirements, content rating questionnaire, targ |
 | external | `push-notifications` |  -  | Implement, review, or debug push notifications in iOS/macOS apps  -  local notifications, remote (APNs) notifications, rich notifications, n |
-| external | `python-patterns` |  -  | Modern Python 3.12+: type hints, dataclasses, Pydantic v2, async/await, context managers, generators, pattern matching |
-| external | `react-best-practices` |  -  | React 19+ best practices: Server Components, use() hook, Actions, hooks patterns, state management, and performance optimization |
+| external | `python-patterns` |  -  | Modern Python 3.12+: type hints, dataclasses, Pydantic v2, async/await, context managers, generators, pattern matching. Use when writing or  |
+| external | `react-best-practices` |  -  | React 19+ best practices: Server Components, use() hook, Actions, hooks patterns, state management, and performance optimization. Use when b |
 | external | `realitykit-ar` |  -  | Build iOS augmented reality and 3D experiences with RealityKit and ARKit. Use when adding RealityView content, loading entities or USDZ mode |
-| external | `rest-api-design` |  -  | REST API design: HTTP methods, status codes, pagination, versioning, rate limiting, caching headers, OpenAPI documentation |
+| external | `rest-api-design` |  -  | REST API design: HTTP methods, status codes, pagination, versioning, rate limiting, caching headers, OpenAPI documentation. Use when a REST  |
 | external | `retrofit-networking` |  -  | Build networking layers on Android with Retrofit, OkHttp, and Kotlin Coroutines. Covers suspend functions in API interfaces, OkHttp intercep |
 | external | `room-database` |  -  | Implement Room database persistence on Android with @Entity, @Dao, @Database, Flow-based reactive queries, TypeConverters for complex types, |
 | external | `search-first` |  -  | \| |
@@ -156,7 +160,7 @@
 | external | `swift-charts` |  -  | Implement, review, or improve data visualizations using Swift Charts. Use when building bar, line, area, point, pie, donut, or iOS 26 3D cha |
 | external | `swift-codable` |  -  | Implement Swift Codable models for JSON and property-list encoding and decoding with JSONDecoder, JSONEncoder, CodingKeys, and custom init(f |
 | external | `swift-concurrency` |  -  | Resolve Swift concurrency compiler errors, adopt approachable concurrency (SE-0466), and write data-race-safe async code. Use when fixing Se |
-| external | `swift-concurrency-expert` |  -  | Review and fix Swift concurrency issues such as actor isolation and Sendable violations. |
+| external | `swift-concurrency-expert` |  -  | Review and fix Swift concurrency issues such as actor isolation and Sendable violations. Use when a Swift concurrency problem needs diagnosi |
 | external | `swift-concurrency-pro` |  -  | Reviews Swift code for concurrency correctness, modern API usage, and common async/await pitfalls. Use when reading, writing, or reviewing S |
 | external | `swift-formatstyle` |  -  | Format values for display using the FormatStyle protocol and its concrete types. Use when formatting numbers (integers, floating-point, deci |
 | external | `swift-language` |  -  | Apply modern Swift language patterns and idioms for non-concurrency, non-SwiftUI code. Covers if/switch expressions (Swift 5.9+), typed thro |
@@ -174,22 +178,22 @@
 | external | `swiftui-navigation` |  -  | Implement SwiftUI navigation patterns including NavigationStack, NavigationSplitView, sheet presentation, tab-based navigation, and deep lin |
 | external | `swiftui-patterns` |  -  | Builds SwiftUI views with modern MV architecture, state management, and view composition patterns. Covers @Observable ownership rules, @Stat |
 | external | `swiftui-performance` |  -  | Audit and improve SwiftUI runtime performance. Use when diagnosing slow rendering, janky scrolling, high CPU, memory usage, excessive view u |
-| external | `swiftui-performance-audit` |  -  | Audit SwiftUI performance issues from code review and profiling evidence. |
+| external | `swiftui-performance-audit` |  -  | 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 |
 | external | `swiftui-pro` |  -  | Comprehensively reviews SwiftUI code for best practices on modern APIs, maintainability, and performance. Use when reading, writing, or revi |
-| external | `swiftui-ui-patterns` |  -  | Apply proven SwiftUI UI patterns for navigation, sheets, async state, and reusable screens. |
+| external | `swiftui-ui-patterns` |  -  | Apply proven SwiftUI UI patterns for navigation, sheets, async state, and reusable screens. Use when a SwiftUI screen needs a proven pattern |
 | external | `swiftui-uikit-interop` |  -  | Bridges UIKit and SwiftUI by wrapping UIKit views and view controllers in SwiftUI with UIViewRepresentable and UIViewControllerRepresentable |
-| external | `swiftui-view-refactor` |  -  | Refactor SwiftUI views into smaller components with stable, explicit data flow. |
+| external | `swiftui-view-refactor` |  -  | Refactor SwiftUI views into smaller components with stable, explicit data flow. Use when a SwiftUI view has grown too large and needs splitt |
 | external | `swiftui-webkit` |  -  | Embeds and controls web content in SwiftUI with WebKit for SwiftUI, including WebView, WebPage, navigation policies, JavaScript execution, o |
-| external | `tailwind-css` |  -  | Tailwind CSS v4: utility-first styling, responsive design, dark mode, custom themes, component patterns, and cn() utility |
-| external | `testing-backend` |  -  | Backend testing: pytest patterns (Python), Jest patterns (Node.js), integration testing, database fixtures/factories, API contract testing |
+| external | `tailwind-css` |  -  | Tailwind CSS v4: utility-first styling, responsive design, dark mode, custom themes, component patterns, and cn() utility. Use when styling  |
+| external | `testing-backend` |  -  | Backend testing: pytest patterns (Python), Jest patterns (Node.js), integration testing, database fixtures/factories, API contract testing.  |
 | external | `tipkit` |  -  | Implement, review, or improve in-app tips and onboarding using Apple's TipKit framework. Use when adding feature discovery tooltips, onboard |
-| external | `typescript-patterns` |  -  | Modern TypeScript patterns: strict mode, utility types, generics, conditional types, type guards, discriminated unions, Zod validation |
+| external | `typescript-patterns` |  -  | Modern TypeScript patterns: strict mode, utility types, generics, conditional types, type guards, discriminated unions, Zod validation. Use  |
 | external | `vision-framework` |  -  | Implement computer vision features including text recognition (OCR), face detection, barcode scanning, image segmentation, object tracking,  |
-| external | `vue-composition` |  -  | Vue 3 Composition API: ref, reactive, computed, watch, composables, Pinia state management, Vue Router 4, script setup |
+| external | `vue-composition` |  -  | Vue 3 Composition API: ref, reactive, computed, watch, composables, Pinia state management, Vue Router 4, script setup. Use when building or |
 | external | `weatherkit` |  -  | Fetch current, hourly, and daily weather forecasts and display required attribution using WeatherKit. Use when integrating weather data, sho |
-| external | `web-accessibility` |  -  | WCAG 2.2 AA web accessibility: ARIA roles/states, keyboard navigation, screen readers, color contrast, focus management, axe-core testing |
-| external | `web-performance` |  -  | Web performance: Core Web Vitals (LCP, INP, CLS), image optimization, code splitting, caching strategies, bundle analysis, Lighthouse |
-| external | `web-testing` |  -  | Web testing: Vitest unit tests, React Testing Library, Playwright E2E, MSW API mocking, testing hooks and async operations |
+| external | `web-accessibility` |  -  | WCAG 2.2 AA web accessibility: ARIA roles/states, keyboard navigation, screen readers, color contrast, focus management, axe-core testing. U |
+| external | `web-performance` |  -  | Web performance: Core Web Vitals (LCP, INP, CLS), image optimization, code splitting, caching strategies, bundle analysis, Lighthouse. Use w |
+| external | `web-testing` |  -  | Web testing: Vitest unit tests, React Testing Library, Playwright E2E, MSW API mocking, testing hooks and async operations. Use when writing |
 | external | `widgetkit` |  -  | Implement, review, or improve widgets, Live Activities, and controls using WidgetKit and ActivityKit. Use when building home screen, Lock Sc |
 | external | `xcode-build-benchmark` |  -  | Benchmark Xcode clean and incremental builds with repeatable inputs, timing summaries, and timestamped `.build-benchmark/` artifacts. Use wh |
 | external | `xcode-build-fixer` |  -  | Apply approved Xcode build optimization changes following best practices, then re-benchmark to verify improvement. Use when a developer has  |

package/pipeline/scripts/smoke-plugin-validate.sh

@@ -1,64 +0,0 @@
-#!/usr/bin/env bash
-#
-# smoke-plugin-validate.sh  -  run `claude plugin validate --strict` against
-# every plugin / marketplace surface committed to this repo.
-#
-# Discovery: any directory containing `.claude-plugin/plugin.json` or
-# `.claude-plugin/marketplace.json` (node_modules excluded). The `claude`
-# CLI validates the containing directory; --strict promotes warnings
-# (unrecognized fields, missing metadata) to failures so CI catches drift
-# the runtime would silently tolerate.
-#
-# Skip semantics (exit 0 with a SKIP line):
-#   - `claude` binary not on PATH (optional tooling; billing-friendly CI
-#     runners don't install it)
-#   - no validatable surface in the repo (the marketplace plugins live in
-#     the separate multi-agent-plugins repo; this repo may carry none)
-#
-# Exit codes: 0=pass or skip, 1=validation failure
-
-set -uo pipefail
-
-REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-
-if ! command -v claude >/dev/null 2>&1; then
-  echo "SKIP smoke-plugin-validate: claude binary not on PATH"
-  exit 0
-fi
-
-# Each hit is a manifest; the validatable surface is its .claude-plugin parent's parent.
-MANIFESTS=$(find "$REPO_ROOT" \
-  -path "$REPO_ROOT/node_modules" -prune -o \
-  -path "$REPO_ROOT/coverage" -prune -o \
-  -type f -path '*/.claude-plugin/*' \( -name plugin.json -o -name marketplace.json \) -print \
-  2>/dev/null | sort)
-
-if [ -z "$MANIFESTS" ]; then
-  echo "SKIP smoke-plugin-validate: no .claude-plugin plugin/marketplace manifest in this repo"
-  exit 0
-fi
-
-PASS=0
-FAIL=0
-pass() { PASS=$((PASS + 1)); echo "  ✓ $1"; }
-fail() { FAIL=$((FAIL + 1)); echo "  ✗ $1"; }
-
-# Validate each surface directory once, even if it carries both manifests.
-SURFACES=$(echo "$MANIFESTS" | sed 's|/\.claude-plugin/[^/]*$||' | sort -u)
-
-for surface in $SURFACES; do
-  rel="${surface#"$REPO_ROOT"/}"
-  [ "$surface" = "$REPO_ROOT" ] && rel="."
-  echo ""
-  echo "→ claude plugin validate --strict $rel"
-  if OUT=$(claude plugin validate --strict "$surface" 2>&1); then
-    pass "$rel validates clean (strict)"
-  else
-    fail "$rel failed strict validation"
-    echo "$OUT" | sed 's/^/    /'
-  fi
-done
-
-echo ""
-echo "══ smoke-plugin-validate: $PASS passed, $FAIL failed ══"
-[ "$FAIL" -gt 0 ] && exit 1 || exit 0