@mmerterden/multi-agent-pipeline 11.1.0 → 11.3.0

package/pipeline/scripts/smoke-diff-explain.sh

@@ -28,7 +28,7 @@ TMP=$(mktemp -d)
 
 # ──────────────────────────────────────────────────────────────────────────
 echo "→ 1. Command + skill files exist"
-[ -f "$REPO_ROOT/pipeline/commands/multi-agent/diff-explain.md" ] && pass "diff-explain.md present" || fail "diff-explain.md missing"
+[ -f "$REPO_ROOT/pipeline/commands/multi-agent/diff-explain/SKILL.md" ] && pass "diff-explain.md present" || fail "diff-explain.md missing"
 [ -f "$REPO_ROOT/pipeline/skills/shared/core/multi-agent-diff-explain/SKILL.md" ] && pass "multi-agent-diff-explain SKILL.md present" || fail "Copilot peer missing"
 [ -x "$SCRIPT" ] && pass "diff-explain.mjs is executable" || fail "diff-explain.mjs not executable"
 

package/pipeline/scripts/smoke-diff-risk.sh

@@ -22,7 +22,7 @@ ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 SCORE="$ROOT/pipeline/scripts/diff-risk-score.mjs"
 VALIDATE="$ROOT/pipeline/scripts/validate-diff-risk.mjs"
 SCHEMA="$ROOT/pipeline/schemas/diff-risk.schema.json"
-PHASE4="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-4-review.md"
+PHASE4="$ROOT/pipeline/multi-agent-refs/phases/phase-4-review.md"
 REVIEWER="$ROOT/pipeline/agents/code-reviewer.md"
 PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
 FIX_IOS="$ROOT/pipeline/scripts/fixtures/diff-risk-ios.diff"

package/pipeline/scripts/smoke-evidence-gate.sh

@@ -80,7 +80,7 @@ echo ""
 echo "→ 5. Wiring: phase docs reference the gate"
 GREP_HITS=0
 for doc in phase-3-dev phase-4-review phase-6-commit; do
-  grep -q "evidence-gate" "$ROOT/pipeline/commands/multi-agent/refs/phases/$doc.md" && GREP_HITS=$((GREP_HITS+1))
+  grep -q "evidence-gate" "$ROOT/pipeline/multi-agent-refs/phases/$doc.md" && GREP_HITS=$((GREP_HITS+1))
 done
 if [ "$GREP_HITS" -ge 2 ]; then
   pass "evidence-gate referenced in $GREP_HITS phase docs"

package/pipeline/scripts/smoke-figma-dispatch.sh

@@ -1,19 +1,19 @@
 #!/usr/bin/env bash
-# smoke-figma-dispatch.sh  -  Phase 3 component dispatch contract.
+# smoke-figma-dispatch.sh  -  Phase 3 component dispatch contract (plugin-based).
 #
-# Verifies that multi-agent Phase 3 delegates to the figma-to-component
-# orchestrator (WS-4) instead of embedding figma logic inline.
+# Verifies that multi-agent Phase 3 dispatches component tasks to the
+# ai-<platform>-engineering-toolkit MARKETPLACE PLUGIN (create-component,
+# fallback create-ui-component) instead of a bundled figma-to-component skill.
 #
-# Runs offline  -  scans docs only, no orchestrator invocation.
+# Runs offline  -  scans docs only, no skill invocation.
 
 set -euo pipefail
 
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
-PHASE0="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
-PHASE3="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-3-dev.md"
-DISPATCH="$ROOT/pipeline/commands/multi-agent/refs/component-dispatch.md"
-ORCH_IOS="$ROOT/pipeline/skills/figma-ios/figma-to-component/SKILL.md"
+PHASE0="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
+PHASE3="$ROOT/pipeline/multi-agent-refs/phases/phase-3-dev.md"
+DISPATCH="$ROOT/pipeline/multi-agent-refs/component-dispatch.md"
 
 PASS=0
 FAIL=0
@@ -22,62 +22,47 @@ fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
 
 [ -f "$PHASE0" ] || { echo "error: $PHASE0 missing" >&2; exit 1; }
 [ -f "$PHASE3" ] || { echo "error: $PHASE3 missing" >&2; exit 1; }
-[ -f "$DISPATCH" ] || { echo "error: $DISPATCH missing (WS-4 extracted contract)" >&2; exit 1; }
-[ -f "$ORCH_IOS" ] || { echo "error: orchestrator skill missing at $ORCH_IOS (run WS-2 import first)" >&2; exit 1; }
+[ -f "$DISPATCH" ] || { echo "error: $DISPATCH missing" >&2; exit 1; }
 
-# Combined scan  -  both Phase 3 itself and the extracted contract may carry the
-# canonical strings. Use a function so each check reads both.
-has_in_phase3_or_dispatch() {
-  grep -Fq "$1" "$PHASE3" || grep -Fq "$1" "$DISPATCH"
-}
-
-echo "→ 1. Phase 0 classification routes component → figma-to-component"
-if grep -Fq "pipeline/skills/figma-ios/figma-to-component" "$PHASE0"; then
-  pass "Phase 0 references the new orchestrator path"
-else
-  fail "Phase 0 does NOT reference pipeline/skills/figma-ios/figma-to-component"
-fi
-
-if grep -Fq "figma-to-swiftui" "$PHASE0"; then
-  fail "Phase 0 still references legacy 'figma-to-swiftui' (expected 'figma-to-component')"
+echo "→ 1. no bundled figma orchestrator remains in the tree"
+if [ -e "$ROOT/pipeline/skills/figma-ios" ] || [ -e "$ROOT/pipeline/skills/figma-android" ] || [ -e "$ROOT/pipeline/skills/figma-common" ]; then
+  fail "bundled pipeline/skills/figma-* tree still present (should be plugin-only)"
 else
-  pass "Phase 0 has no legacy figma-to-swiftui reference"
+  pass "no pipeline/skills/figma-* tree (component skills live in the plugin)"
 fi
 
 echo ""
-echo "→ 2. Phase 3 has a component dispatch section"
-if grep -Fq "Component tasks  -  delegated dispatch" "$PHASE3"; then
-  pass "Phase 3 has 'Component tasks  -  delegated dispatch' section"
+echo "→ 2. Phase 0 routes component tasks to the plugin component skill"
+if grep -Fq "create-component" "$PHASE0"; then
+  pass "Phase 0 references the plugin create-component skill"
 else
-  fail "Phase 3 missing component dispatch section"
+  fail "Phase 0 does NOT reference create-component"
 fi
-
-if grep -Fq 'taskType === "component"' "$DISPATCH"; then
-  pass "dispatch contract mentions taskType guard"
+if grep -Fq "figma-to-swiftui" "$PHASE0" || grep -Fq "skills/figma-ios/figma-to-component" "$PHASE0"; then
+  fail "Phase 0 still references a legacy/bundled figma orchestrator path"
 else
-  fail "dispatch contract missing taskType guard"
+  pass "Phase 0 has no legacy/bundled figma orchestrator reference"
 fi
 
 echo ""
-echo "→ 3. dispatch documents platform routing (iOS + Android orchestrator selection)"
-if grep -Fq "figma-ios/figma-to-component" "$DISPATCH" && grep -Fq "figma-android" "$DISPATCH"; then
-  pass "dispatch documents iOS + Android orchestrator routing"
+echo "→ 3. dispatch guards taskType and resolves the plugin (dual-name)"
+if grep -Fq 'taskType === "component"' "$DISPATCH"; then
+  pass "dispatch mentions taskType guard"
 else
-  fail "dispatch missing platform-aware orchestrator routing"
+  fail "dispatch missing taskType guard"
 fi
-
-echo ""
-echo "→ 4. dispatch delegates subphase tracking to orchestrator"
-if grep -Fq "subphases[]" "$DISPATCH" || grep -Fq 'subphases\[\]' "$DISPATCH"; then
-  pass "dispatch documents state.phases[3].subphases[] report"
+if grep -Fq "create-component" "$DISPATCH" && grep -Fq "create-ui-component" "$DISPATCH"; then
+  pass "dispatch documents dual-name resolution (create-component / create-ui-component)"
 else
-  fail "dispatch missing subphases[] documentation"
+  fail "dispatch missing dual-name plugin resolution"
 fi
 
-if grep -Fq "phase-tracker" "$DISPATCH"; then
-  pass "dispatch refers to phase-tracker for subphase rendering"
+echo ""
+echo "→ 4. dispatch layer owns subphase state + phase-tracker"
+if grep -Fq 'subphases[]' "$DISPATCH" && grep -Fq "phase-tracker" "$DISPATCH"; then
+  pass "dispatch documents state.phases[3].subphases[] + phase-tracker"
 else
-  fail "dispatch missing phase-tracker reference"
+  fail "dispatch missing subphases[]/phase-tracker documentation"
 fi
 
 echo ""
@@ -87,7 +72,6 @@ if grep -Fq "<!-- progress-contract: applied -->" "$PHASE3"; then
 else
   fail "Phase 3 missing the adoption marker"
 fi
-
 if grep -Fq "<!-- progress-contract: applied -->" "$PHASE0"; then
   pass "Phase 0 carries the adoption marker"
 else
@@ -95,28 +79,33 @@ else
 fi
 
 echo ""
-echo "→ 6. Phase 3 emits dispatch progress lines"
-if grep -qE '→ dispatching figma-to-component' "$PHASE3"; then
-  pass "Phase 3 documents '→ dispatching figma-to-component <name>' emission"
+echo "→ 6. Phase 3 emits the plugin dispatch progress line"
+if grep -qE '→ dispatching create-component' "$PHASE3"; then
+  pass "Phase 3 documents '→ dispatching create-component <name>' emission"
 else
   fail "Phase 3 missing dispatch progress line"
 fi
 
 echo ""
-echo "→ 7. dispatch has failure + retry semantics for orchestrator"
-if grep -Fq "retryCount" "$DISPATCH" && grep -qE '(resume via|resumes instead of restarting)' "$DISPATCH"; then
-  pass "dispatch documents retryCount + orchestrator resume path"
+echo "→ 7. dispatch has failure + retry semantics"
+if grep -Fq "retryCount" "$DISPATCH"; then
+  pass "dispatch documents retryCount"
 else
-  fail "dispatch missing retry / resume documentation"
+  fail "dispatch missing retryCount documentation"
 fi
 
 echo ""
-echo "→ 8. dispatch covers multi-repo report"
-if grep -Fq "state.projects[]" "$DISPATCH" || grep -Fq 'state\.projects\[\]' "$DISPATCH"; then
+echo "→ 8. dispatch covers multi-repo + intentional cross-CLI divergence"
+if grep -Fq 'state.projects[]' "$DISPATCH"; then
   pass "dispatch documents multi-repo report"
 else
   fail "dispatch missing multi-repo report paragraph"
 fi
+if grep -Fiq "Copilot" "$DISPATCH"; then
+  pass "dispatch documents the Copilot cross-CLI divergence"
+else
+  fail "dispatch missing cross-CLI divergence note"
+fi
 
 echo ""
 echo "══ figma-dispatch smoke: $PASS passed, $FAIL failed ══"

package/pipeline/scripts/smoke-gate-hooks.sh

@@ -62,7 +62,7 @@ else
 fi
 
 # 4. picker-contract documents the hook template + the phase-enforced caveat
-PC="$ROOT/pipeline/commands/multi-agent/refs/picker-contract.md"
+PC="$ROOT/pipeline/multi-agent-refs/picker-contract.md"
 if grep -q "claude-hooks.json" "$PC" && grep -q "phase-enforced" "$PC"; then
   pass "picker-contract references the template + the phase-enforced gates caveat"
 else

package/pipeline/scripts/smoke-generate-issue.sh

@@ -16,13 +16,13 @@ set -euo pipefail
 
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
-CMD="$ROOT/pipeline/commands/multi-agent/generate.md"
-REF="$ROOT/pipeline/commands/multi-agent/refs/generate-issue.md"
+CMD="$ROOT/pipeline/commands/multi-agent/generate/SKILL.md"
+REF="$ROOT/pipeline/multi-agent-refs/generate-issue.md"
 SKILL="$ROOT/pipeline/skills/shared/core/multi-agent-generate/SKILL.md"
-DISPATCHER="$ROOT/pipeline/commands/multi-agent.md"
-CONTRACT="$ROOT/pipeline/commands/multi-agent/refs/cross-cli-contract.md"
-SYNC="$ROOT/pipeline/commands/multi-agent/sync.md"
-HELP="$ROOT/pipeline/commands/multi-agent/help.md"
+DISPATCHER="$ROOT/pipeline/commands/multi-agent/SKILL.md"
+CONTRACT="$ROOT/pipeline/multi-agent-refs/cross-cli-contract.md"
+SYNC="$ROOT/pipeline/commands/multi-agent/sync/SKILL.md"
+HELP="$ROOT/pipeline/commands/multi-agent/help/SKILL.md"
 
 PASS=0
 FAIL=0
@@ -34,7 +34,7 @@ for f in "$CMD" "$REF" "$SKILL"; do
   if [ -f "$f" ]; then pass "exists: ${f#$ROOT/}"; else fail "missing: ${f#$ROOT/}"; fi
 done
 # old split commands must be gone
-for f in "$ROOT/pipeline/commands/multi-agent/generate-task.md" "$ROOT/pipeline/commands/multi-agent/generate-bug.md"; do
+for f in "$ROOT/pipeline/commands/multi-agent/generate-task/SKILL.md" "$ROOT/pipeline/commands/multi-agent/generate-bug/SKILL.md"; do
   if [ -f "$f" ]; then fail "stale file present: ${f#$ROOT/}"; else pass "removed: ${f##*/}"; fi
 done
 [ "$FAIL" -eq 0 ] || { echo "══ generate-issue smoke: $PASS passed, $FAIL failed ══"; exit 1; }
@@ -90,7 +90,7 @@ grep -Fqi "swagger" "$REF" && pass "swagger context present" || fail "swagger co
 echo ""
 echo "→ 8. registration + count consistency (36)"
 grep -Fq '| `generate ' "$DISPATCHER" && pass "dispatcher routing: generate" || fail "dispatcher routing missing: generate"
-grep -Fq "generate.md" "$DISPATCHER" && pass "dispatcher loading row" || fail "dispatcher loading row missing"
+grep -Fq "generate/SKILL.md" "$DISPATCHER" && pass "dispatcher loading row" || fail "dispatcher loading row missing"
 grep -Fq "## 1. Command Inventory (36 commands)" "$CONTRACT" && pass "contract count = 36" || fail "contract count wrong"
 grep -Eq '(^|[ ,])generate, help([ ,]|$)' "$CONTRACT" && pass "contract list has generate" || fail "contract list missing generate"
 grep -Fq "**36 commands are synced**" "$SYNC" && pass "sync count = 36" || fail "sync count wrong"

package/pipeline/scripts/smoke-handoff-contract.sh

@@ -12,9 +12,9 @@
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-OPS="$ROOT/pipeline/commands/multi-agent/refs/phases/operations.md"
-LOGFMT="$ROOT/pipeline/commands/multi-agent/refs/phases/log-format.md"
-RESUME="$ROOT/pipeline/commands/multi-agent/resume.md"
+OPS="$ROOT/pipeline/multi-agent-refs/phases/operations.md"
+LOGFMT="$ROOT/pipeline/multi-agent-refs/phases/log-format.md"
+RESUME="$ROOT/pipeline/commands/multi-agent/resume/SKILL.md"
 
 pass=0
 fail=0

package/pipeline/scripts/smoke-identity-isolation.sh

@@ -16,8 +16,8 @@ set -uo pipefail
 # machines that haven't re-run install.js after a pipeline update.
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
-PHASE0="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
-SETUP="$ROOT/pipeline/commands/multi-agent/setup.md"
+PHASE0="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
+SETUP="$ROOT/pipeline/commands/multi-agent/setup/SKILL.md"
 PREFS_SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
 
 PASS=0; FAIL=0

package/pipeline/scripts/smoke-intent-guard.sh

@@ -14,7 +14,7 @@ set -uo pipefail
 
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 CLASSIFY="$ROOT/pipeline/lib/classify-intent.sh"
-PHASE0="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
+PHASE0="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
 PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
 
 PASS=0

package/pipeline/scripts/smoke-issue-comment-template.sh

@@ -19,8 +19,8 @@ cd "$PIPELINE_ROOT"
 
 FAIL=0
 
-TEMPLATE="commands/multi-agent/refs/channels/issue-comment.md"
-PHASE7="commands/multi-agent/refs/phases/phase-7-report.md"
+TEMPLATE="multi-agent-refs/channels/issue-comment.md"
+PHASE7="multi-agent-refs/phases/phase-7-report.md"
 
 # 1. Template file exists.
 if [ ! -f "$TEMPLATE" ]; then

package/pipeline/scripts/smoke-issue-jira-triad.sh

@@ -14,9 +14,9 @@ set -euo pipefail
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
 PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
-PHASE0="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
-PHASE7="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-7-report.md"
-TRIAD="$ROOT/pipeline/commands/multi-agent/refs/issue-jira-triad.md"
+PHASE0="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
+PHASE7="$ROOT/pipeline/multi-agent-refs/phases/phase-7-report.md"
+TRIAD="$ROOT/pipeline/multi-agent-refs/issue-jira-triad.md"
 
 PASS=0
 FAIL=0
@@ -59,7 +59,7 @@ fi
 
 echo ""
 echo "→ 4. Channels Wiki adapter documents wiki → Jira auto-link"
-CHANNELS="$(cd "$HERE/../.." && pwd)/pipeline/commands/multi-agent/channels.md"
+CHANNELS="$(cd "$HERE/../.." && pwd)/pipeline/commands/multi-agent/channels/SKILL.md"
 if grep -Fq "Wiki → Jira" "$CHANNELS" || grep -Fq "wiki summary to Jira" "$CHANNELS" \
    || grep -Fq "Wiki → Jira comment" "$CHANNELS" || grep -Fq "wiki pages" "$CHANNELS"; then
   pass "channels.md documents the wiki → Jira report"

package/pipeline/scripts/smoke-language-axis.sh

@@ -42,7 +42,7 @@ declare -a FORBIDDEN_PHRASES=(
 # (it's the rule source), CHANGELOG (history), STABILITY-FIX-PLAN (history),
 # and feedback memory (notes the rule, can quote it).
 TARGETS=(
-  "commands/multi-agent/refs/phases/*.md"
+  "multi-agent-refs/phases/*.md"
   "commands/multi-agent/*.md"
   "skills/shared/core/multi-agent/SKILL.md"
 )
@@ -51,10 +51,10 @@ TARGETS=(
 # setup.md (Step 0 sets the language and explains why label stays English),
 # refs/picker-contract.md (UI contract spec).
 declare -a ALLOWLIST=(
-  "commands/multi-agent/refs/rules.md"
-  "commands/multi-agent/language.md"
-  "commands/multi-agent/setup.md"
-  "commands/multi-agent/refs/picker-contract.md"
+  "multi-agent-refs/rules.md"
+  "commands/multi-agent/language/SKILL.md"
+  "commands/multi-agent/setup/SKILL.md"
+  "multi-agent-refs/picker-contract.md"
 )
 
 is_allowlisted() {
@@ -83,7 +83,7 @@ for pattern in "${FORBIDDEN_PHRASES[@]}"; do
 done
 
 # Positive assertion: rules.md must contain the per-field language matrix.
-RULES="commands/multi-agent/refs/rules.md"
+RULES="multi-agent-refs/rules.md"
 if [ -f "pipeline/$RULES" ]; then
   if ! grep -q "Per-field language matrix" "pipeline/$RULES"; then
     echo "FAIL [smoke-language-axis]: $RULES must contain the 'Per-field language matrix' section"

package/pipeline/scripts/smoke-learnings-ledger.sh

@@ -75,9 +75,9 @@ echo "$briefA" | grep -q 'repoB only fact' && fail "repoA brief leaked repoB con
 
 echo ""
 echo "→ 5. wiring + docs"
-grep -q 'learnings-ledger.mjs' "$ROOT/pipeline/commands/multi-agent/refs/phases/phase-1-analysis.md" && pass "phase-1 injects the brief" || fail "phase-1 wiring missing"
-grep -q 'learnings-ledger.mjs' "$ROOT/pipeline/commands/multi-agent/refs/phases/phase-4-review.md" && pass "phase-4 triage injects rejected prefs" || fail "phase-4 wiring missing"
-grep -q 'learnings-ledger.mjs' "$ROOT/pipeline/commands/multi-agent/refs/phases/phase-7-report.md" && pass "phase-7 distills the ledger" || fail "phase-7 wiring missing"
+grep -q 'learnings-ledger.mjs' "$ROOT/pipeline/multi-agent-refs/phases/phase-1-analysis.md" && pass "phase-1 injects the brief" || fail "phase-1 wiring missing"
+grep -q 'learnings-ledger.mjs' "$ROOT/pipeline/multi-agent-refs/phases/phase-4-review.md" && pass "phase-4 triage injects rejected prefs" || fail "phase-4 wiring missing"
+grep -q 'learnings-ledger.mjs' "$ROOT/pipeline/multi-agent-refs/phases/phase-7-report.md" && pass "phase-7 distills the ledger" || fail "phase-7 wiring missing"
 grep -q '"learningsLedger"' "$ROOT/pipeline/schemas/prefs.schema.json" && pass "prefs exposes learningsLedger" || fail "prefs toggle missing"
 [ -f "$ROOT/pipeline/schemas/learnings-ledger.schema.json" ] && pass "ledger schema present" || fail "ledger schema missing"
 

package/pipeline/scripts/smoke-mode-dispatch-drift.sh

@@ -3,8 +3,8 @@
 # smoke-mode-dispatch-drift.sh  -  assert each mode dispatch file's tracker
 # section is consistent with the canonical generator output.
 #
-# Each mode dispatch file (dev.md, dev-autopilot.md, dev-local.md,
-# dev-local-autopilot.md, autopilot.md, local.md, local-autopilot.md) must
+# Each mode dispatch file (dev/SKILL.md, dev-autopilot/SKILL.md, dev-local/SKILL.md,
+# dev-local-autopilot/SKILL.md, autopilot/SKILL.md, local/SKILL.md, local-autopilot/SKILL.md) must
 # carry an inline "## Required: Phase Tracker Contract" section. v7.9.1 added
 # this contract; v8.0.0 added gen-mode-dispatch.mjs as the canonical
 # generator.
@@ -15,13 +15,13 @@
 # section is regenerated from it, never hand-edited.
 #
 # Mode → mode-name mapping (each pair is `<file>:<gen-mode>`):
-#   dev.md                   → dev
-#   dev-autopilot.md         → dev-autopilot
-#   dev-local.md             → dev-local
-#   dev-local-autopilot.md   → dev-local-autopilot
-#   autopilot.md             → autopilot
-#   local.md                 → local
-#   local-autopilot.md       → local-autopilot
+#   dev/SKILL.md                   → dev
+#   dev-autopilot/SKILL.md         → dev-autopilot
+#   dev-local/SKILL.md             → dev-local
+#   dev-local-autopilot/SKILL.md   → dev-local-autopilot
+#   autopilot/SKILL.md             → autopilot
+#   local/SKILL.md                 → local
+#   local-autopilot/SKILL.md       → local-autopilot
 #
 # Exit codes: 0=pass, 1=drift detected
 set -euo pipefail
@@ -32,10 +32,10 @@ GEN="$REPO_ROOT/pipeline/scripts/gen-mode-dispatch.mjs"
 
 [ -f "$GEN" ] || { echo "FAIL: gen-mode-dispatch.mjs missing"; exit 2; }
 
-declare -a MODE_FAST_WITH_TEST=("dev.md")
-declare -a MODE_FAST_NO_TEST=("dev-autopilot.md" "dev-local.md" "dev-local-autopilot.md")
+declare -a MODE_FAST_WITH_TEST=("dev/SKILL.md")
+declare -a MODE_FAST_NO_TEST=("dev-autopilot/SKILL.md" "dev-local/SKILL.md" "dev-local-autopilot/SKILL.md")
 declare -a MODE_FAST=("${MODE_FAST_WITH_TEST[@]}" "${MODE_FAST_NO_TEST[@]}")
-declare -a MODE_FULL=("autopilot.md" "local.md" "local-autopilot.md")
+declare -a MODE_FULL=("autopilot/SKILL.md" "local/SKILL.md" "local-autopilot/SKILL.md")
 
 PASS=0
 FAIL=0
@@ -83,7 +83,7 @@ for f in "${MODE_FAST[@]}" "${MODE_FULL[@]}"; do
 done
 
 echo ""
-echo "→ 2a. Fast-mode files that keep User Test (dev.md) declare 5 phases (0/3/5/6/7)"
+echo "→ 2a. Fast-mode files that keep User Test (dev/SKILL.md) declare 5 phases (0/3/5/6/7)"
 for f in "${MODE_FAST_WITH_TEST[@]}"; do
   assert_phases "$f" "0:Init" "3:Dev" "5:Test" "6:Commit" "7:Report"
 done
@@ -132,9 +132,9 @@ echo "→ 6. Each mode file's tracker section is byte-equal to the generator out
 # mode file's tracker section without updating the generator. Fix:
 #   node pipeline/scripts/gen-mode-dispatch.mjs --mode=<m> > /tmp/gen.md
 #   <splice into the file's tracker section, or run the helper sync script>
-for pair in "dev.md:dev" "dev-autopilot.md:dev-autopilot" "dev-local.md:dev-local" \
-            "dev-local-autopilot.md:dev-local-autopilot" "autopilot.md:autopilot" \
-            "local.md:local" "local-autopilot.md:local-autopilot"; do
+for pair in "dev/SKILL.md:dev" "dev-autopilot/SKILL.md:dev-autopilot" "dev-local/SKILL.md:dev-local" \
+            "dev-local-autopilot/SKILL.md:dev-local-autopilot" "autopilot/SKILL.md:autopilot" \
+            "local/SKILL.md:local" "local-autopilot/SKILL.md:local-autopilot"; do
   file="${pair%:*}"
   mode="${pair#*:}"
   path="$CMD_DIR/$file"

package/pipeline/scripts/smoke-model-fallback.sh

@@ -10,10 +10,10 @@ set -uo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-DOC="$REPO_ROOT/pipeline/commands/multi-agent/refs/features/model-fallback.md"
+DOC="$REPO_ROOT/pipeline/multi-agent-refs/features/model-fallback.md"
 TEMPLATE="$REPO_ROOT/pipeline/preferences-template.json"
-P0="$REPO_ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
-P4="$REPO_ROOT/pipeline/commands/multi-agent/refs/phases/phase-4-review.md"
+P0="$REPO_ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
+P4="$REPO_ROOT/pipeline/multi-agent-refs/phases/phase-4-review.md"
 
 PASS=0
 FAIL=0

package/pipeline/scripts/smoke-multi-repo-integration.sh

@@ -13,7 +13,7 @@ set -uo pipefail
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
 SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
-DOC="$ROOT/pipeline/commands/multi-agent/refs/multi-repo-integration-build.md"
+DOC="$ROOT/pipeline/multi-agent-refs/multi-repo-integration-build.md"
 
 PASS=0
 FAIL=0
@@ -53,7 +53,7 @@ grep -qE "phase-tracker\.sh sub 6 0" "$DOC" && pass "doc wires tracker sub-step"
 
 echo ""
 echo "→ 4. phase-6-commit.md references the new Step 0"
-PHASE6="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-6-commit.md"
+PHASE6="$ROOT/pipeline/multi-agent-refs/phases/phase-6-commit.md"
 grep -q "Step 0  -  Multi-Repo Integration Build" "$PHASE6" \
   && pass "phase-6-commit has Step 0 entry" || fail "phase-6-commit missing Step 0"
 grep -q "multi-repo-integration-build.md" "$PHASE6" \

package/pipeline/scripts/smoke-multi-repo-worktree.sh

@@ -4,7 +4,7 @@
 
 set -uo pipefail
 
-PHASE3="$HOME/.claude/commands/multi-agent/refs/phases/phase-3-dev.md"
+PHASE3="$HOME/.claude/multi-agent-refs/phases/phase-3-dev.md"
 
 PASS=0; FAIL=0
 pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }

package/pipeline/scripts/smoke-no-token-prompt.sh

@@ -34,11 +34,11 @@ PATTERNS=(
 TARGET_GLOB=(
   "scripts/*.sh"
   "scripts/*.mjs"
-  "commands/multi-agent/refs/channels/*.md"
-  "commands/multi-agent/refs/phases/*.md"
-  "commands/multi-agent/dev.md"
-  "commands/multi-agent/dev-autopilot.md"
-  "commands/multi-agent/autopilot.md"
+  "multi-agent-refs/channels/*.md"
+  "multi-agent-refs/phases/*.md"
+  "commands/multi-agent/dev/SKILL.md"
+  "commands/multi-agent/dev-autopilot/SKILL.md"
+  "commands/multi-agent/autopilot/SKILL.md"
 )
 
 # Build a single grep invocation: all patterns via repeated -e flags,

package/pipeline/scripts/smoke-phase-0-multi-repo.sh

@@ -11,7 +11,7 @@ set -uo pipefail
 # Source-tree read (authoritative). Installed tree may lag behind.
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
-PHASE0="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
+PHASE0="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
 PREFS_SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
 STATE_SCHEMA="$ROOT/pipeline/schemas/agent-state.schema.json"
 

package/pipeline/scripts/smoke-phase-6-multi.sh

@@ -4,7 +4,7 @@
 
 set -uo pipefail
 
-PHASE6="$HOME/.claude/commands/multi-agent/refs/phases/phase-6-commit.md"
+PHASE6="$HOME/.claude/multi-agent-refs/phases/phase-6-commit.md"
 
 PASS=0; FAIL=0
 pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }

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

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# smoke-phase4-gates.sh  -  contract for the two Phase 4 diff-risk consumers:
+#   test-integrity-gate.mjs (A2)  -  test_lines_removed -> blocking finding
+#   review-scope.mjs (A3)         -  trivial diff -> single reviewer, else full
+# Both are pure functions of the diff-risk JSON (fed on stdin). Deterministic,
+# no git, no LLM. Fail-safe: bad input -> integrity emits 0 findings, scope -> full.
+#
+# Exit 0 = all pass, 1 = any failure.
+
+set -uo pipefail
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+INTEG="$ROOT/pipeline/scripts/test-integrity-gate.mjs"
+SCOPE="$ROOT/pipeline/scripts/review-scope.mjs"
+command -v node >/dev/null 2>&1 || { echo "error: node required" >&2; exit 127; }
+[ -f "$INTEG" ] && [ -f "$SCOPE" ] || { echo "FAIL: gate scripts missing" >&2; exit 1; }
+
+PASS=0; FAIL=0
+pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
+
+echo "→ A2 test-integrity-gate"
+OUT=$(echo '{"files":[{"file":"FooTests.swift","signals":[{"name":"test_lines_removed","weight":3,"value":9}]},{"file":"Foo.swift","signals":[{"name":"loc_changed"}]}]}' | node "$INTEG")
+echo "$OUT" | grep -q '"count":1' && pass "flags a shrinking test file (count=1)" || fail "did not flag test shrink: $OUT"
+echo "$OUT" | grep -q '"tag":"test_integrity"' && pass "finding tagged test_integrity + blocking" || fail "missing tag/severity"
+echo "$OUT" | grep -q '"severity":"blocking"' && pass "severity blocking" || fail "not blocking"
+OUT2=$(echo '{"files":[{"file":"Foo.swift","signals":[{"name":"loc_changed"}]}]}' | node "$INTEG")
+echo "$OUT2" | grep -q '"count":0' && pass "clean diff -> 0 findings" || fail "false positive on clean diff"
+OUT3=$(echo 'not-json' | node "$INTEG")
+echo "$OUT3" | grep -q '"count":0' && pass "bad input -> fail-open 0 findings" || fail "bad input not handled"
+
+echo "→ A3 review-scope"
+S1=$(echo '{"totals":{"loc_added":5,"loc_removed":3,"max_score":1.2,"files":1},"files":[{"file":"README.md","signals":[{"name":"loc_changed"}]}]}' | node "$SCOPE")
+echo "$S1" | grep -q '"scope":"single"' && pass "trivial diff -> single reviewer" || fail "trivial not single: $S1"
+S2=$(echo '{"totals":{"loc_added":200,"loc_removed":40,"max_score":2,"files":6},"files":[]}' | node "$SCOPE")
+echo "$S2" | grep -q '"scope":"full"' && pass "large churn -> full" || fail "large churn not full: $S2"
+S3=$(echo '{"totals":{"loc_added":5,"loc_removed":1,"max_score":3,"files":1},"files":[{"file":"Auth.swift","signals":[{"name":"security_path","weight":3}]}]}' | node "$SCOPE")
+echo "$S3" | grep -q '"scope":"full"' && pass "high-stakes signal -> full (even if small)" || fail "security not full: $S3"
+S4=$(echo '{"totals":{"loc_added":3,"loc_removed":1,"max_score":3,"files":1},"files":[{"file":"X","signals":[{"name":"test_lines_removed"}]}]}' | node "$SCOPE")
+echo "$S4" | grep -q '"scope":"full"' && pass "test_lines_removed forces full review" || fail "test shrink not full: $S4"
+S5=$(echo 'garbage' | node "$SCOPE")
+echo "$S5" | grep -q '"scope":"full"' && pass "bad input -> fail-safe full" || fail "bad input not fail-safe: $S5"
+
+echo ""
+echo "══ phase4-gates smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

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

@@ -19,13 +19,13 @@ FAIL=0
 pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
 fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
 
-PHASE2="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-2-planning.md"
+PHASE2="$ROOT/pipeline/multi-agent-refs/phases/phase-2-planning.md"
 SCHEMA="$ROOT/pipeline/schemas/agent-state.schema.json"
 SKILL="$ROOT/pipeline/skills/shared/core/multi-agent/SKILL.md"
-MODES="$ROOT/pipeline/commands/multi-agent/refs/phases/modes.md"
-AUTOPILOT="$ROOT/pipeline/commands/multi-agent/autopilot.md"
-DEV="$ROOT/pipeline/commands/multi-agent/dev.md"
-DEVAUTO="$ROOT/pipeline/commands/multi-agent/dev-autopilot.md"
+MODES="$ROOT/pipeline/multi-agent-refs/phases/modes.md"
+AUTOPILOT="$ROOT/pipeline/commands/multi-agent/autopilot/SKILL.md"
+DEV="$ROOT/pipeline/commands/multi-agent/dev/SKILL.md"
+DEVAUTO="$ROOT/pipeline/commands/multi-agent/dev-autopilot/SKILL.md"
 
 echo "→ 1. Phase 2 doc declares the gate + sub-modes"
 grep -q "Plan Approval Gate" "$PHASE2" && pass "phase-2 has 'Plan Approval Gate'" || fail "phase-2 missing gate heading"

package/pipeline/scripts/smoke-plan-todos.sh

@@ -23,9 +23,9 @@ ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 HELPER="$ROOT/pipeline/lib/plan-todos.sh"
 SCHEMA="$ROOT/pipeline/schemas/plan-todos.schema.json"
 PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
-P2="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-2-planning.md"
-P3="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-3-dev.md"
-P7="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-7-report.md"
+P2="$ROOT/pipeline/multi-agent-refs/phases/phase-2-planning.md"
+P3="$ROOT/pipeline/multi-agent-refs/phases/phase-3-dev.md"
+P7="$ROOT/pipeline/multi-agent-refs/phases/phase-7-report.md"
 
 pass=0
 fail=0