@mmerterden/multi-agent-pipeline 11.2.0 → 11.3.1

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

package/pipeline/scripts/smoke-pr-review-actions.sh

@@ -19,8 +19,8 @@ cd "$PIPELINE_ROOT"
 
 FAIL=0
 
-CHANNEL="commands/multi-agent/refs/channels/pr-review-actions.md"
-REVIEW="commands/multi-agent/review.md"
+CHANNEL="multi-agent-refs/channels/pr-review-actions.md"
+REVIEW="commands/multi-agent/review/SKILL.md"
 POSTER="lib/post-pr-review.sh"
 
 # 1. New canonical template + new poster exist.
@@ -34,7 +34,7 @@ if [ ! -x "$POSTER" ]; then
 fi
 
 # 2. Legacy monolith artifacts must not exist or be referenced.
-LEGACY_TEMPLATE="commands/multi-agent/refs/channels/pr-review-comment.md"
+LEGACY_TEMPLATE="multi-agent-refs/channels/pr-review-comment.md"
 LEGACY_RENDERER="lib/render-pr-review-body.sh"
 if [ -e "$LEGACY_TEMPLATE" ]; then
   echo "FAIL [smoke-pr-review-actions]: $LEGACY_TEMPLATE must not exist (monolith comment template forbidden)"

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

@@ -117,7 +117,7 @@ TCC_PCT_MAX=$(jq -r '.properties.global.properties.triageCrossCheck.properties.s
 
 echo ""
 echo "→ setup.md documents Step 0  -  Language Selection"
-SETUP_DOC="$ROOT/pipeline/commands/multi-agent/setup.md"
+SETUP_DOC="$ROOT/pipeline/commands/multi-agent/setup/SKILL.md"
 if [ -f "$SETUP_DOC" ] && grep -q "^### Step 0  -  Language Selection" "$SETUP_DOC"; then
   pass "setup.md has Step 0  -  Language Selection"
 else

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

@@ -16,9 +16,9 @@ set -euo pipefail
 
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
-CONTRACT="$ROOT/pipeline/commands/multi-agent/refs/progress-contract.md"
+CONTRACT="$ROOT/pipeline/multi-agent-refs/progress-contract.md"
 PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
-PHASE_DIR="$ROOT/pipeline/commands/multi-agent/refs/phases"
+PHASE_DIR="$ROOT/pipeline/multi-agent-refs/phases"
 
 # Flip to "true" to make missing adoption markers blocking. Today: advisory.
 BLOCKING_ADOPTION="${PROGRESS_CONTRACT_BLOCKING:-false}"

package/pipeline/scripts/smoke-push-retry.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"
 PREFS_SCHEMA="$HOME/.claude/schemas/prefs.schema.json"
 
 PASS=0; FAIL=0

package/pipeline/scripts/smoke-repo-map.sh

@@ -280,8 +280,8 @@ else
 fi
 
 # --- 14: Phase 1 + Phase 4 docs wire the injection ------------------------
-P1="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-1-analysis.md"
-P4="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-4-review.md"
+P1="$ROOT/pipeline/multi-agent-refs/phases/phase-1-analysis.md"
+P4="$ROOT/pipeline/multi-agent-refs/phases/phase-4-review.md"
 for f in "$P1" "$P4"; do
   base=$(basename "$f")
   if grep -qF "repoMap.enabled" "$f" && grep -qF "repo-map.mjs" "$f" && grep -qF '${REPO_MAP}' "$f"; then

package/pipeline/scripts/smoke-shadow-git.sh

@@ -24,7 +24,7 @@ set -uo pipefail
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 SG="$ROOT/pipeline/lib/shadow-git.sh"
 PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
-P3="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-3-dev.md"
+P3="$ROOT/pipeline/multi-agent-refs/phases/phase-3-dev.md"
 
 pass=0
 fail=0

package/pipeline/scripts/smoke-skill-authoring.sh

@@ -7,13 +7,10 @@
 # SCOPE: only skills we author. Specifically:
 #
 #   pipeline/skills/shared/core/          -  our orchestration + compliance skills
-#   pipeline/skills/figma-ios/            -  our iOS Phase 3 sub-skills
-#   pipeline/skills/figma-android/        -  our Android Phase 3 sub-skills
 #
 # INTENTIONALLY NOT AUDITED (upstream imports / different schema):
 #
 #   pipeline/skills/shared/external/      -  curated third-party skills (own frontmatter)
-#   pipeline/skills/figma-common/         -  pre-v5 figma-import skills (legacy `# /<name>` format)
 #
 # Rules:
 #   1. Every SKILL.md has YAML frontmatter (--- ... ---)
@@ -46,20 +43,18 @@ pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
 warn() { WARN=$((WARN+1)); echo "  ⚠ $1"; }
 fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
 
-# Only our authored skill trees  -  upstream imports live under external/ +
-# figma-common/ and are exempt (own frontmatter conventions).
+# Only our authored skill trees  -  upstream imports live under external/
+# and are exempt (own frontmatter conventions).
 TARGETS=(
   "$ROOT/pipeline/skills/shared/core"
-  "$ROOT/pipeline/skills/figma-ios"
-  "$ROOT/pipeline/skills/figma-android"
 )
 
 # Collect the list once.
 SKILLS=$(find "${TARGETS[@]}" -name 'SKILL.md' -type f 2>/dev/null | sort)
 SKILL_COUNT=$(echo "$SKILLS" | grep -c . || echo 0)
 
-echo "→ Scope: $SKILL_COUNT authored SKILL.md files under core/ + figma-ios/ + figma-android/"
-echo "  (external/ and figma-common/ intentionally excluded  -  upstream conventions)"
+echo "→ Scope: $SKILL_COUNT authored SKILL.md files under shared/core/"
+echo "  (external/ intentionally excluded  -  upstream conventions)"
 echo ""
 
 echo "→ 1. Every SKILL.md has YAML frontmatter (--- ... ---)"

package/pipeline/scripts/smoke-tasklist-ordering.sh

@@ -30,7 +30,7 @@ record_fail() { fail=$((fail + 1)); failures+=("$1"); printf '  \033[0;31mFAIL\0
 printf '→ smoke-tasklist-ordering (v8.3.1): TaskCreate phase-number ordering contract\n'
 
 # 1. tracker-contract.md  -  primary source of the rule
-TRACKER_CONTRACT="$ROOT/pipeline/commands/multi-agent/refs/tracker-contract.md"
+TRACKER_CONTRACT="$ROOT/pipeline/multi-agent-refs/tracker-contract.md"
 if grep -qE 'TaskCreate ordering \(strict\)' "$TRACKER_CONTRACT" \
    && grep -qE 'phase-number order' "$TRACKER_CONTRACT" \
    && grep -qE 'BEFORE any TaskUpdate' "$TRACKER_CONTRACT"; then
@@ -40,7 +40,7 @@ else
 fi
 
 # 2. Phase 0 init ref doc  -  the agent always reads this on Phase 0
-PHASE0="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
+PHASE0="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
 if grep -qE '(strict|required).*(TaskCreate|ordering)' "$PHASE0" \
    && grep -qE 'phase-number order' "$PHASE0"; then
   record_pass "phase-0-init.md reinforces the ordering rule on Phase 0 entry"
@@ -50,14 +50,14 @@ fi
 
 # 3. Every Claude Code mode entry doc  -  the rule must appear in each
 MODE_ENTRY_DOCS=(
-  "pipeline/commands/multi-agent/dev.md"
-  "pipeline/commands/multi-agent/autopilot.md"
-  "pipeline/commands/multi-agent/local.md"
-  "pipeline/commands/multi-agent/local-autopilot.md"
-  "pipeline/commands/multi-agent/dev-autopilot.md"
-  "pipeline/commands/multi-agent/dev-local.md"
-  "pipeline/commands/multi-agent/dev-local-autopilot.md"
-  "pipeline/commands/multi-agent/finish.md"
+  "pipeline/commands/multi-agent/dev/SKILL.md"
+  "pipeline/commands/multi-agent/autopilot/SKILL.md"
+  "pipeline/commands/multi-agent/local/SKILL.md"
+  "pipeline/commands/multi-agent/local-autopilot/SKILL.md"
+  "pipeline/commands/multi-agent/dev-autopilot/SKILL.md"
+  "pipeline/commands/multi-agent/dev-local/SKILL.md"
+  "pipeline/commands/multi-agent/dev-local-autopilot/SKILL.md"
+  "pipeline/commands/multi-agent/finish/SKILL.md"
 )
 for rel in "${MODE_ENTRY_DOCS[@]}"; do
   abs="$ROOT/$rel"

package/pipeline/scripts/smoke-test-gap.sh

@@ -22,7 +22,7 @@ set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 SCAN="$ROOT/pipeline/scripts/test-gap-scan.mjs"
 VAL="$ROOT/pipeline/scripts/validate-test-gap.mjs"
-PHASE5="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-5-test.md"
+PHASE5="$ROOT/pipeline/multi-agent-refs/phases/phase-5-test.md"
 PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
 RULES_DIR="$ROOT/pipeline/scripts/test-gap-rules"
 FIX_IOS="$ROOT/pipeline/scripts/fixtures/diff-risk-ios.diff"

package/pipeline/scripts/smoke-token-budget.sh

@@ -8,7 +8,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 PIPELINE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 BUDGET_FILE="$PIPELINE_DIR/schemas/token-budget.json"
-PHASES_DIR="$PIPELINE_DIR/commands/multi-agent/refs/phases"
+PHASES_DIR="$PIPELINE_DIR/multi-agent-refs/phases"
 
 if [ ! -f "$BUDGET_FILE" ]; then
   echo "FAIL: token-budget.json not found at $BUDGET_FILE" >&2

package/pipeline/scripts/smoke-token-preflight.sh

@@ -14,8 +14,8 @@ set -euo pipefail
 
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
-PHASE0="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
-KEYCHAIN="$ROOT/pipeline/commands/multi-agent/refs/keychain.md"
+PHASE0="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
+KEYCHAIN="$ROOT/pipeline/multi-agent-refs/keychain.md"
 REFRESH="$ROOT/pipeline/lib/figma-mcp-refresh.sh"
 SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
 TEMPLATE="$ROOT/pipeline/preferences-template.json"

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # smoke-tracker-contract.sh  -  v7.9.1
 #
-# Validates that every mode dispatch file (dev.md, dev-local.md, autopilot.md,
+# Validates that every mode dispatch file (dev/SKILL.md, dev-local/SKILL.md, autopilot/SKILL.md,
 # etc.) carries the mandatory phase-tracker.sh invocation contract.
 #
 # Without this, agent prompts can fall through to TaskCreate/TaskList UI which
@@ -24,19 +24,19 @@ set -uo pipefail
 
 REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 CMDS_DIR="$REPO_ROOT/pipeline/commands/multi-agent"
-CONTRACT_FILE="$CMDS_DIR/refs/tracker-contract.md"
+CONTRACT_FILE="$HOME/.claude/multi-agent-refs/tracker-contract.md"
 
 # Mode dispatch files that must reference the tracker contract.
 # Updated when new mode files ship; no auto-discovery (false positives on
 # helpers like _account-picker, status, log).
 MODE_FILES=(
-  dev.md
-  dev-local.md
-  dev-autopilot.md
-  dev-local-autopilot.md
-  autopilot.md
-  local.md
-  local-autopilot.md
+  dev/SKILL.md
+  dev-local/SKILL.md
+  dev-autopilot/SKILL.md
+  dev-local-autopilot/SKILL.md
+  autopilot/SKILL.md
+  local/SKILL.md
+  local-autopilot/SKILL.md
 )
 
 # Minimum tracker references per file (init + at least one of the verbs).
@@ -155,7 +155,7 @@ fi
 
 # ──────────────────────────────────────────────────────────────────────────
 echo "→ 8. Continuation wiring in finish + manual-test + phase-5"
-FINISH_FILE="$CMDS_DIR/finish.md"
+FINISH_FILE="$CMDS_DIR/finish/SKILL.md"
 if grep -q '\[ ! -f "\$STATE" \]' "$FINISH_FILE"; then
   pass "finish.md guards init behind a state-file existence check"
 else
@@ -166,19 +166,19 @@ if grep -q 'Continuing' "$FINISH_FILE" && grep -q 'cost total' "$FINISH_FILE"; t
 else
   fail "finish.md missing the continuation summary line"
 fi
-MANUAL_FILE="$CMDS_DIR/manual-test.md"
+MANUAL_FILE="$CMDS_DIR/manual-test/SKILL.md"
 if grep -q 'now 5 "awaiting local test (user)"' "$MANUAL_FILE"; then
   pass "manual-test.md sets the waiting state via now 5"
 else
   fail "manual-test.md missing the now 5 waiting state"
 fi
-PHASE5_FILE="$CMDS_DIR/refs/phases/phase-5-test.md"
+PHASE5_FILE="$HOME/.claude/multi-agent-refs/phases/phase-5-test.md"
 if grep -q 'now 5 "awaiting local test (user)"' "$PHASE5_FILE"; then
   pass "phase-5-test.md sets the waiting state via now 5"
 else
   fail "phase-5-test.md missing the now 5 waiting state"
 fi
-RESUME_FILE="$CMDS_DIR/resume.md"
+RESUME_FILE="$CMDS_DIR/resume/SKILL.md"
 if grep -q 'Rebuild the phase tiles' "$RESUME_FILE"; then
   pass "resume.md rebuilds the phase tiles from state"
 else

package/pipeline/scripts/smoke-tracker-tokens-invocation.sh

@@ -23,10 +23,10 @@ FAIL=0
 # Every phase doc that runs LLM calls MUST mention `phase-tracker.sh tokens`
 # at least once (either in a code fence or inline).
 declare -a LLM_PHASES=(
-  "commands/multi-agent/refs/phases/phase-1-analysis.md:1"
-  "commands/multi-agent/refs/phases/phase-2-planning.md:2"
-  "commands/multi-agent/refs/phases/phase-3-dev.md:3"
-  "commands/multi-agent/refs/phases/phase-4-review.md:4"
+  "multi-agent-refs/phases/phase-1-analysis.md:1"
+  "multi-agent-refs/phases/phase-2-planning.md:2"
+  "multi-agent-refs/phases/phase-3-dev.md:3"
+  "multi-agent-refs/phases/phase-4-review.md:4"
 )
 
 for entry in "${LLM_PHASES[@]}"; do
@@ -46,7 +46,7 @@ done
 
 # tracker-contract.md is the canonical location for the tokens API. Make sure
 # it documents the invocation pattern with both args.
-CONTRACT="commands/multi-agent/refs/tracker-contract.md"
+CONTRACT="multi-agent-refs/tracker-contract.md"
 if [ ! -f "$CONTRACT" ]; then
   echo "FAIL [smoke-tracker-tokens-invocation]: $CONTRACT missing"
   FAIL=$((FAIL + 1))

package/pipeline/scripts/smoke-triage-memory.sh

@@ -23,8 +23,8 @@ set -uo pipefail
 
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 TM="$ROOT/pipeline/scripts/triage-memory.mjs"
-PHASE7="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-7-report.md"
-PHASE4="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-4-review.md"
+PHASE7="$ROOT/pipeline/multi-agent-refs/phases/phase-7-report.md"
+PHASE4="$ROOT/pipeline/multi-agent-refs/phases/phase-4-review.md"
 PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
 SCHEMA="$ROOT/pipeline/schemas/triage-corpus.schema.json"
 

package/pipeline/scripts/smoke-update-check.sh

@@ -17,7 +17,7 @@ set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 SCRIPT="$ROOT/pipeline/scripts/update-check.sh"
 PREFS_SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
-PHASE0_DOC="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
+PHASE0_DOC="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
 
 pass=0
 fail=0

package/pipeline/scripts/smoke-url-enrichment.sh

@@ -23,8 +23,8 @@ check() {
   fi
 }
 
-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"
 SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
 
 echo "→ 1. phase-0-init.md documents Step 1b URL Enrichment"

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

@@ -27,7 +27,7 @@ set -euo pipefail
 
 REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 SCRIPTS_DIR="$REPO_ROOT/pipeline/scripts"
-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-verify-by-test.sh

@@ -15,9 +15,9 @@
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-PHASE4_DOC="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-4-review.md"
-PHASE3_DOC="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-3-dev.md"
-FEATURE_DOC="$ROOT/pipeline/commands/multi-agent/refs/features/verify-by-test.md"
+PHASE4_DOC="$ROOT/pipeline/multi-agent-refs/phases/phase-4-review.md"
+PHASE3_DOC="$ROOT/pipeline/multi-agent-refs/phases/phase-3-dev.md"
+FEATURE_DOC="$ROOT/pipeline/multi-agent-refs/features/verify-by-test.md"
 PREFS_SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
 TRIAGE_SCHEMA="$ROOT/pipeline/schemas/triage-output.schema.json"
 VALIDATOR="$ROOT/pipeline/scripts/validate-triage.mjs"