@mmerterden/multi-agent-pipeline 11.1.0 → 11.3.0

package/pipeline/{commands/multi-agent/refs → multi-agent-refs}/wiki-capture.md

@@ -2,7 +2,7 @@
 
 > **TLDR**  -  Component tasks can auto-generate wiki docs + Figma screenshots. The Wiki adapter is invoked from `/multi-agent:channels` (Phase 7 delegates, or user invokes post-hoc). Four layouts supported (`submodule`, `in-repo`, `github-wiki`, `separate-repo`)  -  adapter picked from `figmaConfig.wiki.mode`. Non-blocking: failures log a warning and channels continues to other adapters. The Wiki adapter supports scope multi-select (Case A) and a precondition-failure menu (Case B)  -  see below.
 
-This doc is referenced from `commands/multi-agent/channels.md` (Wiki adapter) and indirectly from `refs/phases/phase-7-report.md` (which delegates all external delivery to channels). Keeping it separate keeps both files under their token budgets and gives the contract a stable location for Claude-side + Copilot-side implementations.
+This doc is referenced from `commands/multi-agent/channels/SKILL.md` (Wiki adapter) and indirectly from `$HOME/.claude/multi-agent-refs/phases/phase-7-report.md` (which delegates all external delivery to channels). Keeping it separate keeps both files under their token budgets and gives the contract a stable location for Claude-side + Copilot-side implementations.
 
 ## Applicability
 
@@ -77,9 +77,9 @@ Save the answer to `prefs.global.wikiDefault` for next run. Migration script (`m
 
 ## Dispatch
 
-1. Resolve wiki mode from `figmaConfig.wiki.mode`  -  one of `submodule`, `in-repo`, `github-wiki`, `separate-repo`. Each has a dedicated adapter inside the `figma-component-wiki` skill; see `pipeline/skills/figma-ios/figma-component-wiki/SKILL.md` for per-mode path layout and push semantics.
+1. Resolve wiki mode from `figmaConfig.wiki.mode`  -  one of `submodule`, `in-repo`, `github-wiki`, `separate-repo`. Each has a dedicated adapter inside the `figma-component-wiki` skill; see the `ai-ios-engineering-toolkit:figma-component-wiki` plugin skill for per-mode path layout and push semantics.
 2. Emit progress line: `→ writing wiki {componentName} (mode: {mode})`.
-3. Dispatch to `pipeline/skills/figma-ios/figma-component-wiki` (iOS) or `pipeline/skills/figma-android/figma-component-wiki` (Android), passing `{componentName, componentPath, figmaConfig, agentState}`.
+3. Dispatch to the plugin skill `ai-ios-engineering-toolkit:figma-component-wiki` (iOS) or `ai-android-engineering-toolkit:figma-component-wiki` (Android), passing `{componentName, componentPath, figmaConfig}`.
 4. Skill returns `{ writtenPaths[], committedSha?, pushedRemote? }`. Write `writtenPaths` to Phase 7 summary's "Files written" section and push metadata (if any) to "External publishes".
 5. On adapter failure  -  log the adapter + mode + error, continue Phase 7. Wiki is a non-blocking augmentation; the Jira comment in Step 3 already carries the component summary, so the developer is never left in the dark if wiki misfires.
 
@@ -107,6 +107,6 @@ Claude Code and Copilot CLI MUST:
 - Render byte-identical Case A / Case B menus (spacing, brackets, numbering).
 - Respect `prefs.global.wikiScope` array. Legacy `wikiDefault` boolean is migrated on first v5.7 load.
 - Treat adapter failures as non-blocking with the same log shape.
-- Pause the Case A / Case B menu in autopilot  -  per Phase 7 autopilot exception (`refs/phases/modes.md`). 30-min timeout ends session cleanly; resume re-opens menu.
+- Pause the Case A / Case B menu in autopilot  -  per Phase 7 autopilot exception (`$HOME/.claude/multi-agent-refs/phases/modes.md`). 30-min timeout ends session cleanly; resume re-opens menu.
 
 `smoke-wiki-integration.sh` asserts every contract item documented above.

package/pipeline/preferences-template.json

@@ -71,7 +71,8 @@
       "warnPct": 80,
       "onExceed": "warn",
       "pricingModel": "opus"
-    }
+    },
+    "derivedSkillSources": []
   },
   "projects": {},
   "_figmaConfigTemplate": {
@@ -153,5 +154,20 @@
       "complex": "opus",
       "overrides": {}
     }
+  },
+  "_derivedSkillSourcesTemplate": {
+    "_comment": "Optional. Populate global.derivedSkillSources[] to let /multi-agent:refactor check whether skills you derived from an upstream marketplace plugin have been updated. Kept in your LOCAL prefs only (never synced), so it may reference private sources. Copy an entry like the one below.",
+    "_example": {
+      "label": "Component toolkit skills",
+      "localPath": "plugins/<my-plugin>/skills/workflow",
+      "upstreamMarketplace": "<installed-marketplace-name>",
+      "upstreamPlugin": "<upstream-plugin-name>",
+      "upstreamSkills": [
+        "<skill-a>",
+        "<skill-b>"
+      ],
+      "derivedFromVersion": "0.0.0",
+      "upstreamRepoUrl": "https://github.com/<org>/<repo>"
+    }
   }
 }

package/pipeline/rules/figma-pipeline.md

@@ -1,6 +1,6 @@
 ## Figma -> Component Generation
 
-Skill set under `pipeline/skills/figma-ios/` (iOS), `pipeline/skills/figma-android/` (Android), and `pipeline/skills/figma-common/` (shared). Activated when the task contains a Figma URL and target files are `.swift` (iOS) or `.kt` (Android).
+Skill set lives in the marketplace plugins  -  `ai-ios-engineering-toolkit` (iOS/SwiftUI) and `ai-android-engineering-toolkit` (Android/Compose). Activated when the task contains a Figma URL and target files are `.swift` (iOS) or `.kt` (Android).
 
 ### MUST: Figma access - 3-tier fallback chain (BLOCKING, pipeline-wide)
 
@@ -190,7 +190,7 @@ Phase 3.3: figma-iteration-commit     → Batch iteration commit (if iterating)
 | Wiki | enabled/disabled | `wiki.enabled` |
 | Figma API | MCP / REST fallback | `figma.mcpEnabled` |
 
-Provider interfaces are defined inline in the platform skill sets  -  see `pipeline/skills/figma-common/`, `pipeline/skills/figma-ios/`, and `pipeline/skills/figma-android/`.
+Provider interfaces are defined inline in the plugin skill sets  -  see the `ai-ios-engineering-toolkit` and `ai-android-engineering-toolkit` marketplace plugins.
 
 ### Optional Features (graceful skip when disabled)
 

package/pipeline/schemas/prefs.schema.json

@@ -613,40 +613,6 @@
           "default": true,
           "description": "When the Wiki channel produces component wiki content AND a Jira issue is linked (`state.jiraId` set), also post a humanizer-passed summary of the wiki content as a Jira comment so QA + PMs see the component docs inline. Independent of `reportChannels.jira` (which controls whether the main Jira comment runs). Set `false` to suppress only the wiki-summary comment."
         },
-        "figmaSource": {
-          "type": [
-            "object",
-            "null"
-          ],
-          "additionalProperties": false,
-          "description": "Upstream figma-to-component source for incremental sync (WS-9). Set manually by users who maintain a separate source project and want `/multi-agent:sync` to keep `pipeline/skills/figma-ios/` in step. Null = no sync, import was one-shot.",
-          "properties": {
-            "path": {
-              "type": "string",
-              "description": "Absolute path to the source project root (expects `.instructions/figma/` and `.claude/skills/` subtrees)."
-            },
-            "branch": {
-              "type": "string",
-              "default": "develop",
-              "description": "Source branch to pull from."
-            },
-            "lastSyncedAt": {
-              "type": [
-                "string",
-                "null"
-              ],
-              "format": "date-time",
-              "description": "ISO timestamp of the most recent successful sync."
-            },
-            "lastCommit": {
-              "type": [
-                "string",
-                "null"
-              ],
-              "description": "Source commit SHA captured at the most recent successful sync. Used as the floor for incremental diff."
-            }
-          }
-        },
         "promptLanguage": {
           "type": "string",
           "enum": [

package/pipeline/scripts/README.md

@@ -15,7 +15,7 @@ Validate contracts. Each emits `══ <name> smoke: N passed, M failed ══`
 - `smoke-figma-cross-cli-inventory.sh`  -  figma skill cross-CLI source-tree parity (39 assertions)
 
 ### Figma pipeline (see `pipeline/scripts/README-figma-smokes.md` for the full index)
-- `smoke-figma-android-parity.sh`, `smoke-figma-config-schema.sh`, `smoke-figma-dispatch.sh`, `smoke-figma-skill-import.sh`, `smoke-figma-sync.sh`
+- `smoke-figma-config-schema.sh`, `smoke-figma-dispatch.sh`
 
 ### Phase contracts
 - `smoke-phase-0-multi-repo.sh`  -  Phase 0 multi-repo mode fetch + worktree atomicity
@@ -78,8 +78,6 @@ Shell scripts invoked during pipeline execution.
 - `search-logs.sh`  -  backs `/multi-agent:search`
 - `scan-skills.sh`  -  backs `/multi-agent:scan`
 - `benchmark-phase-0.sh`  -  Phase 0 perf harness
-- `sync-figma-source.sh`  -  WS-9 source sync (figma)
-- `import-figma-skills.sh`  -  developer-only import harness (not run at runtime)
 - `github-ssh-setup.sh`  -  first-run SSH key setup helper
 - `sync-parity-check.sh`  -  manual parity verification helper
 

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

@@ -36,7 +36,7 @@ const EXTERNAL = join(PIPE_ROOT, 'pipeline/skills/shared/external');
 const DRY = args.includes('--dry-run');
 
 const COMMON_PLUGIN = 'ai-common-engineering-toolkit';
-const COMMON_SKILLS = ['accessibility-compliance-accessibility-audit', 'firebase', 'humanizer', 'council', 'search-first', 'agent-introspection-debugging'];
+const COMMON_SKILLS = ['accessibility-compliance-accessibility-audit', 'firebase', 'humanizer', 'council', 'search-first', 'agent-introspection-debugging', 'skill-creator', 'backlog'];
 
 // Apple/Xcode-only skills that match no stack pattern → iOS plugin only.
 const APPLE_ONLY = [

package/pipeline/scripts/fixtures/install-layout.tsv

@@ -1,16 +1,17 @@
 .claude/CLAUDE.md	1
 .claude/agents	8
-.claude/commands	92
+.claude/commands	42
 .claude/lib	24
 .claude/multi-agent-preferences.json	1
+.claude/multi-agent-refs	50
 .claude/rules	12
 .claude/schemas	23
-.claude/scripts	180
+.claude/scripts	177
 .claude/settings.json	1
-.claude/skills	563
+.claude/skills	428
 .copilot/agents	8
 .copilot/copilot-instructions.md	1
 .copilot/lib	24
 .copilot/schemas	23
-.copilot/scripts	180
-.copilot/skills	600
+.copilot/scripts	177
+.copilot/skills	465

package/pipeline/scripts/gen-mode-dispatch.mjs

@@ -97,7 +97,7 @@ const skipNote = skippedIds.length > 0
   ? `${modeLabel} mode does NOT TaskCreate phases ${skippedIds.join("/")}  -  those are not part of the ${modeLabel} phase set (\`${spec.phases.join(" ")}\`). Only register tiles for the active set.`
   : `${modeLabel} mode TaskCreates all 8 phases (no phase is skipped).`;
 
-const orderingNote = `**All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied.** For ${modeLabel} that means: ${phaseSequence}. The native widget renders by creation order, not by phase number  -  out-of-order calls produce visually scrambled tile stacks. Full ordering contract in \`refs/tracker-contract.md\` section "TaskCreate ordering (strict)".`;
+const orderingNote = `**All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied.** For ${modeLabel} that means: ${phaseSequence}. The native widget renders by creation order, not by phase number  -  out-of-order calls produce visually scrambled tile stacks. Full ordering contract in \`$HOME/.claude/multi-agent-refs/tracker-contract.md\` section "TaskCreate ordering (strict)".`;
 
 const localCaveat = spec.local
   ? `\n> **Local mode:** no worktree is created, work happens on the current branch. Phase 0 Init still calls \`init\`  -  the \`--local\` flag is stored in tracker-state.json, and \`:resume\` restores the correct CWD.\n`
@@ -109,7 +109,7 @@ const banner = spec.autopilot
 
 const out = `## Required: Phase Tracker Contract
 
-**The phase tracker is mandatory**  -  the agent cannot skip it. Full spec: [\`refs/tracker-contract.md\`](./refs/tracker-contract.md).
+**The phase tracker is mandatory**  -  the agent cannot skip it. Full spec: [\`$HOME/.claude/multi-agent-refs/tracker-contract.md\`]($HOME/.claude/multi-agent-refs/tracker-contract.md).
 ${banner}${localCaveat}
 Two channels run in parallel at every phase boundary:
 
@@ -135,7 +135,7 @@ bash $HOME/.claude/scripts/phase-tracker.sh tokens <N> <in> <out>
 
 In Claude Code the agent MUST also drive the native TaskList widget so the user sees a sticky phase tile stack  -  this is the only progress signal Claude Code surfaces. Skipping these calls is the #1 source of "I don't see any phases" complaints.
 
-**TaskCreate ordering (strict)**: All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied. The native widget renders by creation order, not by phase number  -  out-of-order calls produce visually scrambled tile stacks (e.g. \`1 ✓ · 2 ✓ · 4 ✓ · 0 ▶ · 3 ☐\`) even when the underlying state is correct. Pre-marking phases as completed/skipped before Phase 0 starts is FORBIDDEN  -  register the tile in order, then flip status via TaskUpdate when the phase actually short-circuits. Full contract in \`refs/tracker-contract.md\` section "TaskCreate ordering (strict)".
+**TaskCreate ordering (strict)**: All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied. The native widget renders by creation order, not by phase number  -  out-of-order calls produce visually scrambled tile stacks (e.g. \`1 ✓ · 2 ✓ · 4 ✓ · 0 ▶ · 3 ☐\`) even when the underlying state is correct. Pre-marking phases as completed/skipped before Phase 0 starts is FORBIDDEN  -  register the tile in order, then flip status via TaskUpdate when the phase actually short-circuits. Full contract in \`$HOME/.claude/multi-agent-refs/tracker-contract.md\` section "TaskCreate ordering (strict)".
 
 \`\`\`text
 # Phase 0 startup  -  register one tile per phase (0..N), capture the taskId, persist it:

package/pipeline/scripts/phase-banner.sh

@@ -21,7 +21,7 @@
 # Localization:
 #   PHASE_LANG=en (default) | tr  -  when set to tr, canonical labels resolve to
 #   Turkish. The `auto` sentinel in place of [name] triggers a table lookup.
-#   Canonical label set mirrors pipeline/commands/multi-agent/refs/phases.md.
+#   Canonical label set mirrors pipeline/multi-agent-refs/phases.md.
 #
 # Output is colored when stdout is a TTY (TERM != dumb). Plain otherwise so
 # logs and CI artifacts stay readable. Always written to stdout  -  log
@@ -32,7 +32,7 @@ set -uo pipefail
 PHASE_LANG="${PHASE_LANG:-en}"
 
 # Canonical phase label table. Keep synced with
-# pipeline/commands/multi-agent/refs/phases.md and the table in
+# pipeline/multi-agent-refs/phases.md and the table in
 # pipeline/skills/shared/multi-agent/SKILL.md.
 phase_label() {
   local phase="$1" lang="${2:-en}"

package/pipeline/scripts/review-scope.mjs

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+/**
+ * @file review-scope.mjs  -  v11.3.0
+ *
+ * Diff-complexity gate for Phase 4 Stage 2. On trivial diffs, every reviewer
+ * model agrees and the 2nd/3rd model + triage cost is paid for nothing (a
+ * recurring practitioner complaint about multi-model review). This decides how
+ * many reviewers to dispatch from the deterministic diff-risk report  -  no LLM.
+ *
+ * Pure function of the diff-risk JSON (read on stdin or --file). A diff is
+ * "trivial" (→ single reviewer) only when ALL hold:
+ *   - total churn (loc_added + loc_removed) <= --loc-floor (default 20)
+ *   - totals.max_score < --risk-floor (default 3.0)
+ *   - NO file carries a high-stakes signal: security_path, migration,
+ *     public_api, no_test_change, test_lines_removed
+ * Otherwise → full (the CLI-aware set: 2 on Claude Code, 3 on Copilot CLI).
+ *
+ * Conservative by design: any doubt → full review. Skipping reviewers trades
+ * coverage for cost, so the bar for "trivial" is deliberately high.
+ *
+ * Usage:
+ *   node diff-risk-score.mjs --base B --head H | node review-scope.mjs
+ *   node test-review-scope: node review-scope.mjs --file risk.json --loc-floor 20 --risk-floor 3.0
+ *
+ * Output (stdout, JSON): { scope: "single"|"full", reason, churn, maxScore, blockers }
+ * Exit 0 always. Invalid/empty input → fail SAFE to "full" (never under-review).
+ */
+import { readFileSync } from "node:fs";
+
+const args = process.argv.slice(2);
+const num = (flag, dflt) => {
+  const i = args.indexOf(flag);
+  return i !== -1 && args[i + 1] != null ? Number(args[i + 1]) : dflt;
+};
+const LOC_FLOOR = num("--loc-floor", 20);
+const RISK_FLOOR = num("--risk-floor", 3.0);
+const fileFlag = args.indexOf("--file");
+
+const HIGH_STAKES = new Set([
+  "security_path",
+  "migration",
+  "public_api",
+  "no_test_change",
+  "test_lines_removed",
+]);
+
+function readInput() {
+  try {
+    return fileFlag !== -1 && args[fileFlag + 1]
+      ? readFileSync(args[fileFlag + 1], "utf8")
+      : readFileSync(0, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+function emit(o) {
+  process.stdout.write(JSON.stringify(o));
+}
+
+function main() {
+  let report;
+  try {
+    report = JSON.parse(readInput());
+  } catch {
+    emit({ scope: "full", reason: "no-risk-data-fail-safe", churn: null, maxScore: null, blockers: [] });
+    return;
+  }
+
+  const t = report?.totals || {};
+  const churn = (t.loc_added ?? 0) + (t.loc_removed ?? 0);
+  const maxScore = t.max_score ?? 0;
+  const files = Array.isArray(report?.files) ? report.files : [];
+
+  const blockers = [];
+  for (const f of files) {
+    for (const s of f.signals || []) {
+      if (HIGH_STAKES.has(s.name)) blockers.push({ file: f.file, signal: s.name });
+    }
+  }
+
+  const trivial = churn <= LOC_FLOOR && maxScore < RISK_FLOOR && blockers.length === 0;
+  const reason = trivial
+    ? `trivial: churn ${churn}<=${LOC_FLOOR}, maxScore ${maxScore}<${RISK_FLOOR}, no high-stakes signals`
+    : blockers.length
+      ? `high-stakes signal(s): ${[...new Set(blockers.map((b) => b.signal))].join(", ")}`
+      : churn > LOC_FLOOR
+        ? `churn ${churn} > ${LOC_FLOOR}`
+        : `maxScore ${maxScore} >= ${RISK_FLOOR}`;
+
+  emit({ scope: trivial ? "single" : "full", reason, churn, maxScore, blockers });
+}
+
+main();

package/pipeline/scripts/scan-agent-config.sh

@@ -31,8 +31,8 @@ add "$ROOT/install/templates/claude-hooks.json"
 add "$ROOT/install/templates/copilot-instructions.md"
 add "$ROOT/pipeline/preferences-template.json"
 for f in "$ROOT"/pipeline/agents/*.md; do add "$f"; done
-for f in "$ROOT"/pipeline/skills/figma-common/figma-setup/scripts/*.py \
-         "$ROOT"/pipeline/skills/figma-ios/figma-to-component/scripts/*.py; do add "$f"; done
+# (figma component skills + their scripts now live in the ai-*-engineering-toolkit
+#  marketplace plugin, not in this repo, so there is nothing figma to scan here.)
 add "$ROOT/pipeline/scripts/agent-guard.sh"
 add "$ROOT/pipeline/scripts/pre-commit-check.sh"
 

package/pipeline/scripts/smoke-agent-log-cost.sh

@@ -20,7 +20,7 @@ RENDERER="$ROOT/pipeline/scripts/render-agent-log-cost.sh"
 TRACKER="$ROOT/pipeline/scripts/phase-tracker.sh"
 LOG_METRIC="$ROOT/pipeline/scripts/log-metric.sh"
 TABLE="$ROOT/pipeline/scripts/cost-table.json"
-LOG_FORMAT_DOC="$ROOT/pipeline/commands/multi-agent/refs/phases/log-format.md"
+LOG_FORMAT_DOC="$ROOT/pipeline/multi-agent-refs/phases/log-format.md"
 
 pass=0
 fail=0

package/pipeline/scripts/smoke-agent-model-routing.sh

@@ -15,8 +15,8 @@ set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 AGENTS_DIR="$ROOT/pipeline/agents"
 ORCH_SKILL="$ROOT/pipeline/skills/shared/core/multi-agent/SKILL.md"
-ORCH_CMD="$ROOT/pipeline/commands/multi-agent.md"
-PHASE4="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-4-review.md"
+ORCH_CMD="$ROOT/pipeline/commands/multi-agent/SKILL.md"
+PHASE4="$ROOT/pipeline/multi-agent-refs/phases/phase-4-review.md"
 
 pass=0
 fail=0
@@ -66,9 +66,9 @@ fi
 
 # --- 4b: orchestrator command file references ---
 if grep -q 'preferredModel' "$ORCH_CMD"; then
-  record_pass "commands/multi-agent.md references preferredModel"
+  record_pass "commands/multi-agent/SKILL.md references preferredModel"
 else
-  record_fail "commands/multi-agent.md missing preferredModel reference"
+  record_fail "commands/multi-agent/SKILL.md missing preferredModel reference"
 fi
 
 # --- 5: Phase 4 review doc references override ---

package/pipeline/scripts/smoke-autopilot-circuit-breaker.sh

@@ -8,8 +8,8 @@
 set -uo pipefail
 
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-DOC="$ROOT/pipeline/commands/multi-agent/refs/features/autopilot-circuit-breaker.md"
-MODES="$ROOT/pipeline/commands/multi-agent/refs/phases/modes.md"
+DOC="$ROOT/pipeline/multi-agent-refs/features/autopilot-circuit-breaker.md"
+MODES="$ROOT/pipeline/multi-agent-refs/phases/modes.md"
 
 PASS=0; FAIL=0
 pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }

package/pipeline/scripts/smoke-channels-approval-gate.sh

@@ -13,8 +13,8 @@ set -euo pipefail
 
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
-CHANNELS="$ROOT/pipeline/commands/multi-agent/channels.md"
-PHASE7="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-7-report.md"
+CHANNELS="$ROOT/pipeline/commands/multi-agent/channels/SKILL.md"
+PHASE7="$ROOT/pipeline/multi-agent-refs/phases/phase-7-report.md"
 
 PASS=0
 FAIL=0

package/pipeline/scripts/smoke-channels-flow.sh

@@ -18,13 +18,13 @@
 set -uo pipefail
 
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-CLAUDE_CMD="$ROOT/pipeline/commands/multi-agent/channels.md"
+CLAUDE_CMD="$ROOT/pipeline/commands/multi-agent/channels/SKILL.md"
 COPILOT_SKILL="$ROOT/pipeline/skills/shared/core/multi-agent-channels/SKILL.md"
-ENRICH_CMD="$ROOT/pipeline/commands/multi-agent/enrich.md"
+ENRICH_CMD="$ROOT/pipeline/commands/multi-agent/enrich/SKILL.md"
 ENRICH_SKILL_DIR="$ROOT/pipeline/skills/shared/core/multi-agent-enrich"
-PHASE7="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-7-report.md"
-MODES="$ROOT/pipeline/commands/multi-agent/refs/phases/modes.md"
-WIKI_CAPTURE="$ROOT/pipeline/commands/multi-agent/refs/wiki-capture.md"
+PHASE7="$ROOT/pipeline/multi-agent-refs/phases/phase-7-report.md"
+MODES="$ROOT/pipeline/multi-agent-refs/phases/modes.md"
+WIKI_CAPTURE="$ROOT/pipeline/multi-agent-refs/wiki-capture.md"
 SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
 MIGRATE="$ROOT/pipeline/scripts/migrate-prefs.mjs"
 TEMPLATE="$ROOT/pipeline/preferences-template.json"

package/pipeline/scripts/smoke-clarify.sh

@@ -24,7 +24,7 @@ ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 AGENT="$ROOT/pipeline/agents/task-clarifier.md"
 SCHEMA="$ROOT/pipeline/schemas/clarify-output.schema.json"
 PREFS_SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
-PHASE_DOC="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
+PHASE_DOC="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
 
 pass=0
 fail=0

package/pipeline/scripts/smoke-commands-skills-parity.sh

@@ -36,7 +36,7 @@ fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
 # Underscore-prefixed files (e.g. _account-picker.md) are internal fragments
 # loaded by other commands via Read; they're not invocable slash commands and
 # intentionally have no matching skill.
-CMDS=$(find "$CMDS_DIR" -maxdepth 1 -name "*.md" ! -name "_*" -exec basename {} .md \; | sort)
+CMDS=$(find "$CMDS_DIR" -mindepth 2 -maxdepth 2 -name "SKILL.md" -exec dirname {} \; | xargs -n1 basename | sort)
 
 # help.md in commands maps to multi-agent-help skill; the main "multi-agent"
 # skill covers the behavior documented across multiple command files, so we
@@ -67,7 +67,7 @@ echo "→ Checking that every multi-agent-* skill has a corresponding command"
 SKILLS=$(find "$SKILLS_DIR" -maxdepth 1 -type d -name "multi-agent-*" -exec basename {} \; | sed 's/^multi-agent-//' | sort)
 
 for skill in $SKILLS; do
-  cmd_file="$CMDS_DIR/$skill.md"
+  cmd_file="$CMDS_DIR/$skill/SKILL.md"
   # A few skills are Copilot-CLI-style conveniences without a Claude slash equivalent:
   case "$skill" in
     autopilot | dev-autopilot) # dash-style shortcut skills, the flags are documented in help.md
@@ -76,7 +76,7 @@ for skill in $SKILLS; do
       ;;
   esac
   if [ -f "$cmd_file" ]; then
-    pass "skills/shared/multi-agent-$skill/ ↔ commands/multi-agent/$skill.md"
+    pass "skills/shared/multi-agent-$skill/ ↔ commands/multi-agent/$skill/SKILL.md"
   else
     fail "skills/shared/multi-agent-$skill/ has no matching command"
   fi

package/pipeline/scripts/smoke-community-gates.sh

@@ -18,7 +18,7 @@
 set -euo pipefail
 
 REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-PHASES_DIR="$REPO_ROOT/pipeline/commands/multi-agent/refs/phases"
+PHASES_DIR="$REPO_ROOT/pipeline/multi-agent-refs/phases"
 
 PASS=0
 FAIL=0

package/pipeline/scripts/smoke-compliance-skills.sh

@@ -24,9 +24,9 @@ APPLE_SKILL="$ROOT/pipeline/skills/shared/core/apple-archive-compliance/SKILL.md
 GOOGLE_SKILL="$ROOT/pipeline/skills/shared/core/google-play-compliance/SKILL.md"
 SIM_TEST="$ROOT/pipeline/commands/sim-test.md"
 SEC_AUDITOR="$ROOT/pipeline/agents/security-auditor.md"
-REVIEW_CMD="$ROOT/pipeline/commands/multi-agent/review.md"
+REVIEW_CMD="$ROOT/pipeline/commands/multi-agent/review/SKILL.md"
 REVIEW_SKILL="$ROOT/pipeline/skills/shared/core/multi-agent-review/SKILL.md"
-CHANNELS_CMD="$ROOT/pipeline/commands/multi-agent/channels.md"
+CHANNELS_CMD="$ROOT/pipeline/commands/multi-agent/channels/SKILL.md"
 CHANNELS_SKILL="$ROOT/pipeline/skills/shared/core/multi-agent-channels/SKILL.md"
 
 PASS=0

package/pipeline/scripts/smoke-cost-summary.sh

@@ -18,7 +18,7 @@ ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 RENDERER="$ROOT/pipeline/scripts/render-cost-summary.sh"
 TABLE="$ROOT/pipeline/scripts/cost-table.json"
 SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
-CHANNELS_DOC="$ROOT/pipeline/commands/multi-agent/channels.md"
+CHANNELS_DOC="$ROOT/pipeline/commands/multi-agent/channels/SKILL.md"
 
 pass=0
 fail=0

package/pipeline/scripts/smoke-cross-cli-behavior.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # smoke-cross-cli-behavior.sh  -  enforces the cross-CLI parity invariant
-# defined in ~/.claude/commands/multi-agent/refs/cross-cli-contract.md.
+# defined in ~/.claude/multi-agent-refs/cross-cli-contract.md.
 #
 # This is a behavioral complement to smoke-sync-parity.sh (which tests the
 # parity checker itself). This script asserts the actual Claude Code and
@@ -41,7 +41,10 @@ fi
 # Underscore-prefixed Claude files (e.g. _account-picker.md) are internal
 # fragments lazy-loaded by other commands; they're not invocable on either CLI
 # and intentionally have no Copilot skill counterpart.
-CLAUDE_LIST=$(find "$CLAUDE_CMDS" -maxdepth 1 -name "*.md" ! -name "_*" -type f -exec basename {} \; 2>/dev/null | sed 's/\.md$//' | sort)
+# Also exclude local-only alias wrappers (frontmatter `local-only: true`)  -  personal
+# aliases to private marketplace-plugin skills, intentionally Claude-only, no Copilot peer.
+CLAUDE_LIST=$(find "$CLAUDE_CMDS" -mindepth 2 -maxdepth 2 -name "SKILL.md" 2>/dev/null \
+  | while IFS= read -r f; do grep -q "^local-only: true" "$f" || basename "$(dirname "$f")"; done | sort)
 COPILOT_LIST=$(find "$COPILOT_SKILLS" -maxdepth 1 -type d -name "multi-agent-*" -exec basename {} \; 2>/dev/null | sed 's/^multi-agent-//' | sort)
 
 if [ "$CLAUDE_LIST" = "$COPILOT_LIST" ]; then
@@ -69,7 +72,7 @@ DEPRECATED=(
 )
 for p in "${DEPRECATED[@]}"; do
   # grep -l returns filenames; empty = no matches
-  FOUND=$(grep -l -F -- "$p" "$CLAUDE_CMDS"/*.md 2>/dev/null || true)
+  FOUND=$(grep -l -F -- "$p" $(find "$CLAUDE_CMDS" -name SKILL.md 2>/dev/null) 2>/dev/null || true)
   if [ -z "$FOUND" ]; then
     pass "no '$p' in Claude commands"
   else
@@ -85,7 +88,7 @@ PERSONAL_HARDCODES=(
   "${USER}_tkgithub"
 )
 for p in "${PERSONAL_HARDCODES[@]}"; do
-  FOUND=$(grep -l -F -- "$p" "$CLAUDE_CMDS"/*.md 2>/dev/null || true)
+  FOUND=$(grep -l -F -- "$p" $(find "$CLAUDE_CMDS" -name SKILL.md 2>/dev/null) 2>/dev/null || true)
   if [ -z "$FOUND" ]; then
     pass "no '$p' leaked into Claude commands"
   else
@@ -97,13 +100,13 @@ done
 echo ""
 echo "→ 4. Canonical placeholders present (sanity)"
 # These MUST exist (regressions would mean someone undid a drift fix)
-if grep -q -F "{owner}" "$CLAUDE_CMDS/sync.md" 2>/dev/null; then
+if grep -q -F "{owner}" "$CLAUDE_CMDS/sync/SKILL.md" 2>/dev/null; then
   pass "sync.md uses canonical '{owner}'"
 else
   fail "sync.md missing '{owner}'  -  drift fix may have regressed"
 fi
 
-if grep -q -F "{website-host}" "$CLAUDE_CMDS/sync.md" 2>/dev/null; then
+if grep -q -F "{website-host}" "$CLAUDE_CMDS/sync/SKILL.md" 2>/dev/null; then
   pass "sync.md uses canonical '{website-host}'"
 else
   fail "sync.md missing '{website-host}'  -  drift fix may have regressed"
@@ -114,7 +117,7 @@ echo ""
 echo "→ 5. Canonical project-name vocabulary in log.md"
 CANONICAL_PROJECTS=("my-ui-components" "my-figma-app" "my-ios-app")
 for c in "${CANONICAL_PROJECTS[@]}"; do
-  if grep -q -F -- "$c" "$CLAUDE_CMDS/log.md" 2>/dev/null; then
+  if grep -q -F -- "$c" "$CLAUDE_CMDS/log/SKILL.md" 2>/dev/null; then
     pass "log.md references '$c'"
   else
     fail "log.md missing canonical '$c'"
@@ -124,7 +127,7 @@ done
 # ──────────────────────────────────────────────────────────────────────────
 echo ""
 echo "→ 6. Contract doc exists (required source of truth)"
-CONTRACT="$CLAUDE_CMDS/refs/cross-cli-contract.md"
+CONTRACT="$HOME/.claude/multi-agent-refs/cross-cli-contract.md"
 if [ -f "$CONTRACT" ]; then
   SIZE=$(wc -l < "$CONTRACT" | tr -d ' ')
   if [ "$SIZE" -ge 100 ]; then
@@ -138,40 +141,11 @@ fi
 
 # ──────────────────────────────────────────────────────────────────────────
 echo ""
-echo "→ 7. Figma skill trees deployed to both CLIs (WS-8b, v5.0.1+)"
-
-CLAUDE_SKILLS="$HOME/.claude/skills"
-FIGMA_TREES=(figma-ios figma-android figma-common)
-
-for tree in "${FIGMA_TREES[@]}"; do
-  claude_tree="$CLAUDE_SKILLS/$tree"
-  claude_note=""
-  # /multi-agent:stack parks inactive-platform trees under skills-inactive/.
-  # A parked tree is still deployed - count it from its parked location so
-  # iOS-stack machines don't fail on the android tree (and vice versa).
-  if [ ! -d "$claude_tree" ] && [ -d "$HOME/.claude/skills-inactive/$tree" ]; then
-    claude_tree="$HOME/.claude/skills-inactive/$tree"
-    claude_note=" (claude: parked by /multi-agent:stack)"
-  fi
-  copilot_tree="$COPILOT_SKILLS/$tree"
-  if [ -d "$claude_tree" ] && [ -d "$copilot_tree" ]; then
-    claude_count=$(find "$claude_tree" -maxdepth 1 -mindepth 1 -type d | wc -l | tr -d ' ')
-    copilot_count=$(find "$copilot_tree" -maxdepth 1 -mindepth 1 -type d | wc -l | tr -d ' ')
-    if [ "$claude_count" -eq "$copilot_count" ]; then
-      pass "$tree deployed to both CLIs ($claude_count skills each)$claude_note"
-    else
-      fail "$tree count mismatch (claude=$claude_count copilot=$copilot_count)$claude_note"
-    fi
-  elif [ -d "$claude_tree" ] || [ -d "$copilot_tree" ]; then
-    fail "$tree deployed to only ONE CLI"
-  else
-    echo "    (tree not installed on either CLI  -  run \`node install.js --all\` to deploy)"
-  fi
-done
-
-# ──────────────────────────────────────────────────────────────────────────
-echo ""
-echo "→ 8. Agent personas deployed to both CLIs"
+# Figma/component skill trees no longer ship in the pipeline (v11.2.0+): they
+# live in the marketplace component plugins (ai-ios-engineering-toolkit /
+# multi-agent-plugins), which each CLI loads through its own plugin channel.
+# The pipeline therefore has no figma tree to deploy or parity-check here.
+echo "→ 7. Agent personas deployed to both CLIs"
 
 CLAUDE_AGENTS="$HOME/.claude/agents"
 COPILOT_AGENTS="$HOME/.copilot/agents"
@@ -207,7 +181,7 @@ fi
 # drift across the phase doc, the schema, and the consensus block.
 echo "→ reviewer-count contract (Claude=2, Copilot=3)"
 REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-P4="$REPO_ROOT/pipeline/commands/multi-agent/refs/phases/phase-4-review.md"
+P4="$REPO_ROOT/pipeline/multi-agent-refs/phases/phase-4-review.md"
 REVSCHEMA="$REPO_ROOT/pipeline/schemas/reviewer-output.schema.json"
 TRSCHEMA="$REPO_ROOT/pipeline/schemas/triage-output.schema.json"
 if grep -qiE "Claude Code (dispatches|=|:) ?2|2-model" "$P4" && grep -qiE "Copilot CLI (dispatches|=|:) ?3|3-model" "$P4"; then

package/pipeline/scripts/smoke-cross-phase-cohesion.sh

@@ -24,7 +24,7 @@
 set -euo pipefail
 
 REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-PHASE_DIR="$REPO_ROOT/pipeline/commands/multi-agent/refs/phases"
+PHASE_DIR="$REPO_ROOT/pipeline/multi-agent-refs/phases"
 SCHEMA_DIR="$REPO_ROOT/pipeline/schemas"
 
 PASS=0

package/pipeline/scripts/smoke-dev-critic.sh

@@ -16,7 +16,7 @@ set -euo pipefail
 
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 AGENT="$ROOT/pipeline/agents/dev-critic.md"
-PHASE_DOC="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-3-dev.md"
+PHASE_DOC="$ROOT/pipeline/multi-agent-refs/phases/phase-3-dev.md"
 PREFS_SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
 CRITIC_SCHEMA="$ROOT/pipeline/schemas/dev-critic-output.schema.json"