@mmerterden/multi-agent-pipeline 15.4.0 → 15.6.0

package/CHANGELOG.md

@@ -16,6 +16,23 @@ Internal file-layout changes that don't affect the slash-command surface are sti
 
 ## [Unreleased]
 
+## [15.6.0] - 2026-08-18
+
+### Fixed
+- **The heart goes platform-blind** (platform-dynamic audit, 15 findings): Phase 3's RED run, target resolution and build verification become `case "$STACK"` arms (gradle/pytest/npm beside xcodebuild, with the Gradle build-lock decision stated); Phase 4 Gate 1 matches its own stack-generic Gates 2-3; Phase 2 dispatches the platform's architect agent; Phase 5's device-check table gains the Android MCP tools; the figma-config schema stops claiming SwiftUI as universal; wiki scope gains a `platform` value.
+
+### Added
+- **Per-stack routing hatches**: `STACK_ONLY` lists in `_stack-routing.mjs` so a stack-only skill (ktlint, hilt-di, ...) routes with one list entry instead of a regex widening - and `--check-routing` now FAILS on unrouted skills. `lint-skills` accepts `platform: backend|frontend`.
+
+## [15.5.0] - 2026-08-18
+
+### Added
+- **`sharedUtilities` census bucket** - the bind-don't-rebuild inventory: formatter families, validation rule types + per-module facades and design-token namespaces living outside screen slices, counted with samples; Phase 3 treats a non-empty bucket as binding.
+
+### Fixed
+- **Smoke runs never touch the live dashboard** - run-smokes exports `MULTI_AGENT_SMOKE=1` and phase-tracker's live ping returns under it (test gates were leaving phantom "running" rows on the timeline).
+- **Routing resolves the multi-agent-plugins toolkit first** - the public toolkit family is the pipeline's standard companion; a corporate variant is the fallback, not the default.
+
 ## [15.4.0] - 2026-08-18
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "15.4.0",
+  "version": "15.6.0",
   "description": "8-phase AI development pipeline with full orchestration on Claude Code, Copilot CLI and Codex CLI. Analysis, planning, TDD, CLI-aware parallel review with consensus surfacing + Fable triage, default-FAIL evidence gates, secret + intent guards, per-phase cost ledger, persistent learnings memory, wiki generation, commit automation. Token-preserving uninstall.",
   "type": "module",
   "main": "index.js",

package/pipeline/lib/extract-conventions.sh

@@ -1026,6 +1026,43 @@ bucket_di_registration() {
 # =============================================================================
 # Assemble final JSON
 # =============================================================================
+
+# =============================================================================
+# C13 - sharedUtilities: the bind-don't-rebuild inventory
+# =============================================================================
+# What shared machinery already exists OUTSIDE screen slices - formatter families,
+# validation rule types + per-module rule facades, design-token namespaces. A dev
+# phase that sees a non-empty bucket binds these instead of hand-rolling a
+# duplicate; the counts say how settled each family is.
+bucket_shared_utilities() {
+  local ext screens_seg
+  case "$PLATFORM" in
+    ios)     ext='*.swift' ; screens_seg='/Screens/' ;;
+    android) ext='*.kt'    ; screens_seg='/screens/' ;;
+    *)       empty_bucket; return ;;
+  esac
+  local files
+  files=$(run_find -type f -name "$ext" 2>/dev/null | grep -v "$screens_seg" | grep -viE '/tests?/|/generated/' || true)
+  if [ -z "$files" ]; then empty_bucket; return; fi
+  local fmt rules facades tokens
+  fmt=$(printf '%s
+' "$files"    | grep -cE '(Formatter|Format)\.(swift|kt)$' || true)
+  rules=$(printf '%s
+' "$files"  | grep -cE '[A-Za-z]Rule\.(swift|kt)$' || true)
+  facades=$(printf '%s
+' "$files"| grep -cE '(FormRules|ValidationRules)\.(swift|kt)$' || true)
+  tokens=$(printf '%s
+' "$files" | grep -cE '(Tokens?|Spacing|Radius|Typography)[A-Za-z]*\.(swift|kt)$' || true)
+  fmt=${fmt:-0}; rules=${rules:-0}; facades=${facades:-0}; tokens=${tokens:-0}
+  local total=$((fmt + rules + facades + tokens))
+  if [ "$total" -eq 0 ]; then empty_bucket; return; fi
+  local sample
+  sample=$(printf '%s
+' "$files" | grep -E '(Formatter|Format|Rule|FormRules|ValidationRules|Tokens?|Spacing|Radius|Typography)[A-Za-z]*\.(swift|kt)$' | head -5 | sed "s|^$REPO_PATH/||")
+  emit_bucket "formatters:$fmt rules:$rules facades:$facades tokens:$tokens"     "$(printf '%s
+' "$sample" | head -1)"     "$(confidence_for "$total")"     "$(files_to_json "$sample")" "[]"
+}
+
 folderStructure=$(run_bucket_with_timeout bucket_folder_structure)
 stateHolderNaming=$(run_bucket_with_timeout bucket_state_holder)
 viewNaming=$(run_bucket_with_timeout bucket_view_naming)
@@ -1038,6 +1075,7 @@ testMethodNaming=$(run_bucket_with_timeout bucket_test_method_naming)
 accessibilityIdentifier=$(run_bucket_with_timeout bucket_accessibility_identifier)
 localizationKey=$(run_bucket_with_timeout bucket_localization_key)
 diRegistration=$(run_bucket_with_timeout bucket_di_registration)
+sharedUtilities=$(run_bucket_with_timeout bucket_shared_utilities)
 
 jq -n \
   --argjson folderStructure "$folderStructure" \
@@ -1052,6 +1090,7 @@ jq -n \
   --argjson accessibilityIdentifier "$accessibilityIdentifier" \
   --argjson localizationKey "$localizationKey" \
   --argjson diRegistration "$diRegistration" \
+  --argjson sharedUtilities "$sharedUtilities" \
   '{
     folderStructure: $folderStructure,
     stateHolderNaming: $stateHolderNaming,
@@ -1064,7 +1103,8 @@ jq -n \
     testMethodNaming: $testMethodNaming,
     accessibilityIdentifier: $accessibilityIdentifier,
     localizationKey: $localizationKey,
-    diRegistration: $diRegistration
+    diRegistration: $diRegistration,
+    sharedUtilities: $sharedUtilities
   }'
 
 exit 0

package/pipeline/multi-agent-refs/component-dispatch.md

@@ -52,7 +52,7 @@ a single atom is `component`. When it cannot be decided, ask  -  do not default
 omits the wiring.
 
 **Pre-implementation validation is not optional on iOS.** Before the create skill
-runs, dispatch `ai-ios-toolkit:figma-validate` for the frame. It checks
+runs, dispatch `<toolkit>:figma-validate` (probed like every dual-name skill; a toolkit that ships none records the skip) for the frame. It checks
 registry presence, Code Connect strategy, **design token compliance**, dependency
 readiness, atomic scope and already-implemented status in about ten seconds. Those
 are precisely the checks whose absence produced guessed spacing and an unpublished

package/pipeline/multi-agent-refs/features/stack-skill-routing.md

@@ -22,15 +22,15 @@ Platform comes from the same mapping component dispatch uses, so the two cannot
 
 | `state.platform` / detected stack | Toolkit candidates, first enabled wins |
 |---|---|
-| ios, swift | `ai-ios-engineering-toolkit`, then `ai-ios-toolkit` |
-| android, kotlin | `ai-android-engineering-toolkit`, then `ai-android-toolkit` |
+| ios, swift | `ai-ios-toolkit`, then `ai-ios-engineering-toolkit` |
+| android, kotlin | `ai-android-toolkit`, then `ai-android-engineering-toolkit` |
 | anything else | no toolkit  -  step is a recorded no-op |
 
-A row is an ORDERED candidate list, not one name: the corporate toolkit (where one exists)
-carries the project-specific doctrine and outranks its public derivation, so it resolves first.
-Probe the candidates in order against the enabled plugins and take the first hit. When none is
-enabled, the recorded no-op names every candidate probed - a repo that enabled a corporate
-toolkit the table did not know about must show up as a probe miss, never as silence.
+A row is an ORDERED candidate list, not one name: the multi-agent-plugins toolkit is the
+pipeline's standard companion and resolves first; a corporate variant is the fallback for a
+repo that enables only it. Probe the candidates in order against the enabled plugins and take
+the first hit. When none is enabled, the recorded no-op names every candidate probed - an
+enabled toolkit the table did not know about must show up as a probe miss, never as silence.
 
 The toolkit is enabled per repo (`.claude/settings.local.json` / `~/.claude/settings.json` `enabledPlugins`). **Not enabled is not an error here**, unlike component dispatch: a backend or web repo legitimately has no toolkit, and halting would make the pipeline unusable outside mobile. Record the no-op and continue.
 

package/pipeline/multi-agent-refs/phases/phase-3-dev.md

@@ -26,7 +26,7 @@ Pre-flight steps (run in order, abort on failure).
 
 5. **Standards binding citations**: read `analysis Section 21 References` table. For each row with `Rol: bağlayıcı / binding`, persist the source path into `state.dev.standardsBindings[]`. Phase 3 Dev tasks MUST cite at least one binding source per architectural decision (pre-existing Locked decision 8).
 
-6. **Conventions handoff**: read `analysis Section 13.1 Concept Table` (Pass B output with footnotes). Persist concept-to-realization mapping into `state.dev.conventions[<concept>]`. Phase 3 implementation uses these names verbatim (e.g., if Section 13.1 says "State holder: PassengerFlightViewModel", Phase 3 names the class exactly `PassengerFlightViewModel`).
+6. **Conventions handoff**: read `analysis Section 13.1 Concept Table` (Pass B output with footnotes). Persist concept-to-realization mapping into `state.dev.conventions[<concept>]`. Phase 3 implementation uses these names verbatim, and a non-empty `sharedUtilities` bucket is binding: bind those formatters/rule-facades/tokens, never hand-roll a duplicate (e.g., if Section 13.1 says "State holder: PassengerFlightViewModel", Phase 3 names the class exactly `PassengerFlightViewModel`).
 
 7. **MCP forbidden**: calling `mcp__claude_ai_Figma__*` in Phase 3 is a violation. `smoke-no-mcp-in-dev-phases.sh` reads `state.telemetry.mcpCalls[]` after the run and fails if Phase 3 contributed an entry.
 
@@ -122,16 +122,17 @@ For each task (respecting dependency order):
      - `describe` / `it` → Quick/Nimble
    - Test naming: `test{Scenario}_{Expected}` (e.g. `testKeychainReturnsNil_doesNotCrash`)
    - One test per behavior change  -  not one test per file
-   - Run test to confirm RED:
+   - Run test to confirm RED  -  the command is the platform's, one arm per stack:
      ```bash
-     acquire_build_lock "$TASK_ID"
-     xcodebuild test \
-       -scheme "{scheme}" \
-       -destination "platform=iOS Simulator,name={simulator}" \
-       -derivedDataPath "{worktreePath}/.DerivedData" \
-       -only-testing:"{testTarget}/{testClass}/{testMethod}" \
-       2>&1 | tail -5
-     release_build_lock
+     case "$STACK" in
+       ios)     acquire_build_lock "$TASK_ID"
+                xcodebuild test -scheme "{scheme}" -destination "platform=iOS Simulator,name={simulator}" \
+                  -derivedDataPath "{worktreePath}/.DerivedData" -only-testing:"{testTarget}/{testClass}/{testMethod}" 2>&1 | tail -5
+                release_build_lock ;;
+       android) ./gradlew test --tests "{testClass}.{testMethod}" 2>&1 | tail -5 ;;
+       backend) pytest "{test_file}::{test_name}" 2>&1 | tail -5 ;;
+       frontend) npm test -- --testPathPattern="{file}" 2>&1 | tail -5 ;;
+     esac
      ```
    - Must fail for the RIGHT reason (expected assertion, not compilation error)
 
@@ -154,49 +155,22 @@ For each task (respecting dependency order):
    - Only if duplication or naming is poor
    - Re-run tests after refactor → still GREEN
 
-   **Scheme + destination resolution** (auto-detect once per project, cache in `agent-state.json`):
+   **Target resolution** (auto-detect once per project, cache in `agent-state.json`; ios resolves scheme + simulator, android resolves module + variant, backend/frontend need none):
    ```bash
-   # List available schemes
-   xcodebuild -list -json -project "{projectPath}" 2>/dev/null \
-     || xcodebuild -list -json -workspace "{workspacePath}" 2>/dev/null
-   # Pick: prefer scheme matching project name, then first non-test scheme
-   
-   # Available simulators
-   xcrun simctl list devices available -j | jq '.devices | to_entries[] | select(.key | contains("iOS")) | .value[0].name'
+   case "$STACK" in
+     ios)     xcodebuild -list -json -project "{projectPath}" 2>/dev/null || xcodebuild -list -json -workspace "{workspacePath}" 2>/dev/null
+              # prefer the scheme matching the project name, then the first non-test scheme
+              xcrun simctl list devices available -j | jq '.devices | to_entries[] | select(.key | contains("iOS")) | .value[0].name' ;;
+     android) ./gradlew projects 2>/dev/null | grep -E "^\+--- Project" ; ./gradlew tasks --all 2>/dev/null | grep -m5 "assemble.*Debug" ;;
+   esac
    ```
 
-   **Non-Xcode projects:**
-   - Python: `pytest {test_file}::{test_name}` → `pytest`
-   - Node.js: `npm test -- --testPathPattern={file}` → `npm test`
-   - Android: `./gradlew test --tests "{testClass}.{testMethod}"` → `./gradlew test`
-
-4. **Build verification with queue lock** (see Build Queue section below):
-
-   **Preferred  -  MCP tool (token-efficient, dev-toolkit-mcp ≥ 2.3.0):**
-   ```
-   acquire_build_lock "$TASK_ID"
-   mcp__dev-toolkit__ios_xcodebuild({
-     project: "{projectPath}",        // or workspace
-     scheme: "{scheme}",
-     configuration: "Release",
-     destination: "generic/platform=iOS",
-     derived_data_path: "{worktreePath}/.DerivedData"
-   })
-   release_build_lock
-   ```
-   Returns one line: `Build: SUCCESS|FAILURE (E errors, W warnings) [xcresult-<id>]`. On failure, drill in only when needed via `mcp__dev-toolkit__ios_xcresult({id, mode: "errors"})`. Saves thousands of tokens per build cycle vs. raw xcodebuild output.
-
-   **Fallback  -  raw xcodebuild** (when MCP server is unavailable):
-   ```bash
-   acquire_build_lock "$TASK_ID"
-   xcodebuild build \
-     -scheme "{scheme}" \
-     -destination "generic/platform=iOS" \
-     -derivedDataPath "{worktreePath}/.DerivedData" \
-     2>&1 | tail -5
-   release_build_lock
-   ```
-5. If build fails → fix → rebuild (max 3 attempts, track `retryCount` in state). With MCP path: pass the captured xcresult ID to `ios_xcresult` mode `errors` first, then `warnings` only if needed  -  never dump full log into context.
+4. **Build verification** (per stack; ios/android under the build queue lock, see below):
+   - **ios, preferred (MCP, dev-toolkit ≥ 2.3.0)**: `acquire_build_lock` → `mcp__dev-toolkit__ios_xcodebuild({project|workspace, scheme, configuration: "Release", destination: "generic/platform=iOS", derived_data_path: "{worktreePath}/.DerivedData"})` → `release_build_lock`. Returns one line `Build: SUCCESS|FAILURE (E errors, W warnings) [xcresult-<id>]`; on failure drill in via `mcp__dev-toolkit__ios_xcresult({id, mode: "errors"})`, never dump the full log.
+   - **ios, fallback (raw)**: same lock pair around `xcodebuild build -scheme "{scheme}" -destination "generic/platform=iOS" -derivedDataPath "{worktreePath}/.DerivedData" 2>&1 | tail -5`.
+   - **android**: lock pair around `./gradlew assembleDebug 2>&1 | tail -5` (the Gradle daemon and `build/` outputs contend across parallel worktrees exactly as DerivedData does  -  the lock applies).
+   - **backend / frontend**: `python -m compileall .` / `npm run build --if-present 2>&1 | tail -5`; no lock.
+5. If build fails → fix → rebuild (max 3 attempts, track `retryCount` in state).
 6. **Intermediate commit** (after each completed task in the plan):
    ```bash
    git -C "{worktreePath}" add -A
@@ -247,7 +221,7 @@ release_build_lock() { rm -rf "$BUILD_LOCK"; }
 - Phase 4 Step 1 Gate 1 (build gate before review)
 - Phase 4 Step 1 Gate 3 (test gate before review)
 
-**Non-Xcode projects** (Python, Node.js): No lock needed  -  these can build/test in parallel without conflicts.
+**Android**: same lock discipline  -  the Gradle daemon and `build/` outputs contend across parallel worktrees. **Backend/frontend** (Python, Node.js): no lock needed  -  these build/test in parallel without conflicts.
 
 ---
 

package/pipeline/multi-agent-refs/phases/phase-4-review.md

@@ -10,8 +10,8 @@ Progress emission per `$HOME/.claude/multi-agent-refs/progress-contract.md`  -
 If any gate fails → fix first, don't waste AI tokens reviewing broken code.
 
 ```bash
-# Gate 1: Build (Xcode uses build queue lock  -  see Phase 3)  -  tee output to a log
-xcodebuild ... 2>&1 | tee "$WORKTREE/.build.log"
+# Gate 1: Build (xcodebuild/gradle assemble/tsc/py compile  -  stack-dependent; Xcode uses the build queue lock, see Phase 3)  -  tee output to a log
+<build-command> 2>&1 | tee "$WORKTREE/.build.log"
 # Gate 2: Lint (swiftlint/ktlint/ruff/eslint  -  stack-dependent)
 # Gate 3: Tests pass (xcodebuild test/gradle test/pytest/npm test)  -  tee output to a log
 <test-command> 2>&1 | tee "$WORKTREE/.test.log"

package/pipeline/multi-agent-refs/phases/phase-5-test.md

@@ -126,12 +126,12 @@ Before or during user testing, run device-level audits via Bash if user requests
 
 | Check               | When              | Command                                   |
 | ------------------- | ----------------- | ----------------------------------------- |
-| Accessibility audit | UI changes        | `mcp__dev-toolkit__ios_accessibility_audit` (or `swift ui-tree-dumper.swift`) |
-| Biometric test      | Auth flow changes | `mcp__dev-toolkit__ios_biometric` (or `xcrun simctl keychain biometric-match`) |
-| Launch time         | Android project   | `adb shell am start -W`                   |
-| Visual test         | Any UI changes    | `/multi-agent test` (sim-test)            |
-| Snapshot regression | Component / pixel-stable UI changes | `mcp__dev-toolkit__ios_visual_diff` (dev-toolkit-mcp ≥ 2.3.0) |
-| App Store screenshots | `taskType === screenshot` | `mcp__dev-toolkit__ios_status_bar({preset: "clean"})` before each capture |
+| Accessibility audit | UI changes        | `mcp__dev-toolkit__{ios,android}_accessibility_audit` |
+| Biometric test      | Auth flow changes | ios: `mcp__dev-toolkit__ios_biometric` (android: manual) |
+| Launch time         | Perf-sensitive changes | ios: app-launch instrument · android: `mcp__dev-toolkit__android_launch_time` |
+| Visual test         | Any UI changes    | `/multi-agent test` (sim-test, both platforms) |
+| Snapshot regression | Component / pixel-stable UI changes | ios: `mcp__dev-toolkit__ios_visual_diff` · android: `mcp__dev-toolkit__android_screenshot` + compare |
+| Store screenshots   | `taskType === screenshot` | ios: `ios_status_bar({preset: "clean"})` · android: `android_screenshot` |
 
 Results included in Phase 7 report. MCP tools preferred when available  -  concise structured output, lower token cost.
 

package/pipeline/multi-agent-refs/phases/phase-6-commit.md

@@ -129,13 +129,13 @@ gh pr create --base {baseBranch} --head {branch} $REVIEWERS \
   --body-file /tmp/pr-body-$TASK_ID.md
 ```
 
-**UI Component PR (when SwiftUI component detected):**
+**UI Component PR (when a UI component is detected (SwiftUI/Compose)):**
 
 Same `gh pr create` pattern with component-specific body sections:
 
 - Component Details: file table (Configuration, View, Modifiers, Tests)
 - Variants table, Design Tokens Used, Figma URL
-- Accessibility: labels, identifiers, 44pt tap target, Dynamic Type
+- Accessibility: labels, identifiers, platform-minimum tap target (44pt iOS / 48dp Android), Dynamic Type
 - Test Coverage: structural/behavioral/snapshot counts
 - Checklist: no magic numbers, configuration purity, modifier chain, accessibility, dark mode + RTL, build passes
 

package/pipeline/multi-agent-refs/rules.md

@@ -139,7 +139,7 @@ This is the single source of truth. When a contributor or model is unsure where
 
 ## Build Queue
 
-- All `xcodebuild` / `xcodebuild test` calls acquire `/tmp/claude-xcodebuild.lock` before running. Parallel Xcode builds corrupt DerivedData and simulator state.
+- `xcodebuild` and `./gradlew` build/test calls acquire `/tmp/claude-xcodebuild.lock` first: parallel runs corrupt DerivedData/simulators and contend on the Gradle daemon.
 - Each worktree uses its own `-derivedDataPath "{worktreePath}/.DerivedData"` to prevent cross-contamination.
 - Lock auto-releases; stale locks (>15min) get force-cleaned.
 - Non-Xcode builds (Gradle, npm, Python) don't need the lock  -  they handle their own concurrency.

package/pipeline/schemas/conventions-output.schema.json

@@ -18,27 +18,61 @@
     "testMethodNaming",
     "accessibilityIdentifier",
     "localizationKey",
-    "diRegistration"
+    "diRegistration",
+    "sharedUtilities"
   ],
   "properties": {
-    "folderStructure": { "$ref": "#/$defs/conventionBucket" },
-    "stateHolderNaming": { "$ref": "#/$defs/conventionBucket" },
-    "viewNaming": { "$ref": "#/$defs/conventionBucket" },
-    "navigatorNaming": { "$ref": "#/$defs/conventionBucket" },
-    "useCaseNaming": { "$ref": "#/$defs/conventionBucket" },
-    "repositoryNaming": { "$ref": "#/$defs/conventionBucket" },
-    "dtoNaming": { "$ref": "#/$defs/conventionBucket" },
-    "uiStateModel": { "$ref": "#/$defs/conventionBucket" },
-    "testMethodNaming": { "$ref": "#/$defs/conventionBucket" },
-    "accessibilityIdentifier": { "$ref": "#/$defs/conventionBucket" },
-    "localizationKey": { "$ref": "#/$defs/conventionBucket" },
-    "diRegistration": { "$ref": "#/$defs/conventionBucket" }
+    "folderStructure": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "stateHolderNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "viewNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "navigatorNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "useCaseNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "repositoryNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "dtoNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "uiStateModel": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "testMethodNaming": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "accessibilityIdentifier": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "localizationKey": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "diRegistration": {
+      "$ref": "#/$defs/conventionBucket"
+    },
+    "sharedUtilities": {
+      "$ref": "#/$defs/conventionBucket"
+    }
   },
   "$defs": {
     "conventionBucket": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["pattern", "example", "confidence", "evidenceFiles", "alternativeCandidates"],
+      "required": [
+        "pattern",
+        "example",
+        "confidence",
+        "evidenceFiles",
+        "alternativeCandidates"
+      ],
       "properties": {
         "pattern": {
           "type": "string",
@@ -50,18 +84,27 @@
         },
         "confidence": {
           "type": "string",
-          "enum": ["high", "medium", "low", "none"],
+          "enum": [
+            "high",
+            "medium",
+            "low",
+            "none"
+          ],
           "description": "high: 5+ examples; medium: 3-4; low: 1-2 or mixed; none: no evidence."
         },
         "evidenceFiles": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "maxItems": 5,
           "description": "Repo-relative or absolute paths backing the detection (capped at 5)."
         },
         "alternativeCandidates": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Competing patterns that were observed but lost the majority vote."
         }
       }

package/pipeline/schemas/figma-project-config.schema.json

@@ -276,7 +276,7 @@
     "ui": {
       "type": "object",
       "additionalProperties": false,
-      "description": "UI interaction systems. Consumed by the figma-navigation / figma-overlays / figma-bottom-sheets convention skills and by Phase 4 review. When a section is absent or its mode is 'native', the pipeline uses stock SwiftUI (NavigationStack, .alert/.sheet(item:), .sheet+presentationDetents). Set mode 'custom' to route to a project-supplied system by the type names below.",
+      "description": "UI interaction systems. Consumed by the figma-navigation / figma-overlays / figma-bottom-sheets convention skills and by Phase 4 review. When a section is absent or its mode is 'native', the pipeline uses the platform's stock system (SwiftUI NavigationStack/.sheet on iOS, Compose Navigation/dialogs on Android). Set mode 'custom' to route to a project-supplied system by the type names below.",
       "properties": {
         "navigationSystem": {
           "type": "object",

package/pipeline/scripts/_stack-routing.mjs

@@ -27,7 +27,11 @@ export const COMMON_SKILLS = [
   "localization-reuse-map",
 ];
 
-// Apple/Xcode-only skills that match no stack pattern → iOS plugin only.
+// Stack-only escape hatches: skill names that match no stack pattern route to
+// exactly one plugin. Every stack gets one - a stack whose new skill matches
+// nothing must be addable HERE (one list entry), never by widening a regex or
+// releasing new pipeline logic. Apple's list came first; the peers are seeded
+// with the names that plausibly arrive next.
 export const APPLE_ONLY = [
   "avkit",
   "cryptokit",
@@ -42,6 +46,38 @@ export const APPLE_ONLY = [
   "xcode-project-analyzer",
 ];
 
+export const ANDROID_ONLY = [
+  "ktlint",
+  "detekt",
+  "espresso",
+  "hilt-di",
+  "proguard-r8",
+  "workmanager",
+  "jetpack-glance",
+  "coroutines",
+  "material3-theming",
+  "baseline-profiles",
+];
+
+export const BACKEND_ONLY = [
+  "grpc-services",
+  "message-queues",
+  "sql-migrations",
+];
+
+export const FRONTEND_ONLY = [
+  "storybook",
+  "web-vitals",
+  "service-workers",
+];
+
+export const STACK_ONLY = {
+  "ai-ios-toolkit": APPLE_ONLY,
+  "ai-android-toolkit": ANDROID_ONLY,
+  "ai-backend-toolkit": BACKEND_ONLY,
+  "ai-frontend-toolkit": FRONTEND_ONLY,
+};
+
 // stack → matching pattern (per-stack routing patterns (formerly in stack-swap.sh))
 //
 // A skill lands in every plugin whose pattern it matches, so a bare substring
@@ -70,7 +106,9 @@ export const STACK_PATTERNS = {
  */
 export function routeSkill(name) {
   if (COMMON_SKILLS.includes(name)) return [COMMON_PLUGIN];
-  if (APPLE_ONLY.includes(name)) return ["ai-ios-toolkit"];
+  for (const [plugin, list] of Object.entries(STACK_ONLY)) {
+    if (list.includes(name)) return [plugin];
+  }
   const hits = [];
   for (const [plugin, re] of Object.entries(STACK_PATTERNS)) {
     if (re.test(name)) hits.push(plugin);

package/pipeline/scripts/build-stack-plugins.mjs

@@ -56,6 +56,7 @@ import {
   COMMON_PLUGIN,
   COMMON_SKILLS,
   APPLE_ONLY,
+  STACK_ONLY,
   STACK_PATTERNS,
 } from "./_stack-routing.mjs";
 
@@ -119,9 +120,12 @@ for (const skill of allSkills) {
     desired[COMMON_PLUGIN].add(skill);
     continue;
   }
-  if (APPLE_ONLY.includes(skill)) {
-    desired["ai-ios-toolkit"].add(skill);
-    continue;
+  {
+    const only = Object.entries(STACK_ONLY).find(([, list]) => list.includes(skill));
+    if (only) {
+      desired[only[0]].add(skill);
+      continue;
+    }
   }
   let matched = false;
   for (const [plugin, re] of Object.entries(STACK_PATTERNS)) {
@@ -144,7 +148,7 @@ for (const skill of allSkills) {
 // source in this repo, so CI can gate it without a checkout of the plugins repo.
 const multiRouted = [];
 for (const skill of allSkills) {
-  if (COMMON_SKILLS.includes(skill) || APPLE_ONLY.includes(skill)) continue;
+  if (COMMON_SKILLS.includes(skill) || Object.values(STACK_ONLY).some((l) => l.includes(skill))) continue;
   const owners = Object.entries(STACK_PATTERNS)
     .filter(([, re]) => re.test(skill))
     .map(([p]) => p);
@@ -160,8 +164,14 @@ if (args.includes("--check-routing")) {
     console.error("fix: anchor the offending STACK_PATTERNS alternative to the exact skill name");
     process.exit(1);
   }
+  if (unrouted.length) {
+    console.error(`check-routing: ${unrouted.length} skill(s) route to NO plugin`);
+    for (const s of unrouted) console.error(`  FAIL ${s}`);
+    console.error("fix: add the name to its stack's STACK_ONLY list in _stack-routing.mjs");
+    process.exit(1);
+  }
   console.log(
-    `check-routing: clean (${allSkills.length} skills, ${unrouted.length} unrouted, 0 multi-routed)`,
+    `check-routing: clean (${allSkills.length} skills, 0 unrouted, 0 multi-routed)`,
   );
   process.exit(0);
 }

package/pipeline/scripts/phase-tracker.sh

@@ -121,6 +121,9 @@ need_jq() {
 # the Phase 7 / halt emit that reads the real run status. The emitter no-ops
 # unless prefs.global.usageLog.enabled; detached so it never blocks a boundary.
 usage_live_ping() {
+  # Smoke runs exercise this script's state handling, never the live dashboard -
+  # a test gate must not leave phantom "running" rows on the timeline.
+  [ -n "${MULTI_AGENT_SMOKE:-}" ] && return 0
   local task="$1" phase="$2"
   local script="$HOME/.claude/scripts/usage-report.mjs"
   local prefs="$HOME/.claude/multi-agent-preferences.json"