@mmerterden/multi-agent-pipeline 10.5.0 → 10.7.0

package/pipeline/commands/multi-agent/sync.md

@@ -1,6 +1,6 @@
 ---
-description: "One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, Cursor/Antigravity/Copilot Chat orchestration adapters, pipeline repo, website, and remote-control."
-argument-hint: "[release] [--no-adapters] [--platform=<macos|linux|windows>]"
+description: "One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, pipeline repo, website, and remote-control."
+argument-hint: "[release] [--platform=<macos|linux|windows>]"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, WebFetch
 ---
 
@@ -14,9 +14,8 @@ When invoked, it synchronizes all 7 targets in order. It detects what changed, u
 
 | Arg | Meaning |
 |---|---|
-| (none) | Full ecosystem sync: global targets (Claude, Copilot, Codex CLI, pipeline repo, website, remote-control) AND per-project adapter files (Cursor / Antigravity / Copilot Chat) in `prefs.global.projectsTouched[]`. Step 2b runs by default. Files are refreshed and a LOCAL commit is made per project; push stays the user's call (never automatic). |
+| (none) | Full ecosystem sync: Claude Code, Copilot CLI, pipeline repo, website, remote-control. |
 | `release` | Full sync + version bump + tag + npm publish + website deploy |
-| `--no-adapters` | Skip Step 2b (per-project adapter refresh). Use when you want only the global targets and must not touch any project repo (e.g. mid-feature-branch in a project). |
 | `--platform=<macos\|linux\|windows>` | Override automatic platform detection. For CI / cross-platform smoke. |
 | `"change description"` | Apply the description to every target at once |
 
@@ -27,8 +26,6 @@ When invoked, it synchronizes all 7 targets in order. It detects what changed, u
 | 0 | Figma source (deprecated) | `prefs.global.figmaSource.path` | skip (see memory `feedback_figma_source_deprecated`) |
 | 1 | Claude Code (source of truth) | `~/.claude/commands/multi-agent.md` + `~/.claude/commands/multi-agent/` + `~/.claude/agents/` + `~/.claude/scripts/` + `~/.claude/lib/` | source |
 | 2 | Copilot CLI | `~/.copilot/copilot-instructions.md` + `~/.copilot/skills/` | <- from Claude |
-| 2a | OpenAI Codex CLI (global, auto when `~/.codex` present) | `~/.codex/prompts/multi-agent.md` + `~/.codex/AGENTS.md` + `~/.codex/config.toml` | <- from Claude |
-| 2b | Cursor / Antigravity / Copilot Chat adapters (default; skip with `--no-adapters`) | `.cursor/rules/multi-agent.mdc`, `.github/copilot-instructions.md` in each project root | <- from Claude (template) |
 | 3 | multi-agent-pipeline repo | `~/multi-agent-pipeline/pipeline/` | <- from Claude (genericized) |
 | 4 | Website | `{owner}/{website-host}` | <- version + features |
 | 5 | Remote Control | `{owner}/remote-control` | <- pipeline references |
@@ -62,13 +59,6 @@ Step 0: FIGMA_SYNC  SKIP (deprecated  -  feedback_figma_source_deprecated)
 Step 1: PLATFORM    Detect macOS / Linux / Windows (Git Bash / WSL); export PLATFORM env
 Step 1.5: DETECT    Compare timestamps, find stale targets
 Step 2: COPILOT     Claude Code -> Copilot CLI (instructions + 34 sub-command skills)
-Step 2a: CODEX      Claude Code -> Codex CLI (global ~/.codex prompt + AGENTS.md + config.toml mcp)
-                     -  runs via `node pipeline/scripts/sync-adapters.mjs`, which fires the
-                        codex adapter ONCE (global) when `~/.codex` exists on this machine
-Step 2b: ADAPTERS   Cursor / Antigravity / Copilot Chat per-project rule files refresh
-                     -  RUNS BY DEFAULT: refreshes all projectsTouched[] targets + the pipeline repo
-                     -  `--no-adapters` skips this step entirely
-                     -  writes files + a LOCAL commit per project; push stays the user's call
 Step 3: REPO        Claude Code -> pipeline repo (genericized, personal data scrub, bash -n on all sh)
 Step 3c: PLUGINS    pipeline shared/external -> multi-agent-plugins marketplace (rebuild knowledge/,
                      bump changed plugins' patch version, commit + push the plugins repo)
@@ -134,65 +124,6 @@ If nothing is stale → report "All targets up to date" and stop.
 4. **Do not duplicate**  -  summary in Copilot, full spec in Claude. Keep this distinction.
 5. **Report**  -  show a short diff summary after sync
 
-## Step 2b  -  Per-Project Adapter Sync (default; skip with `--no-adapters`)
-
-Cursor and GitHub Copilot Chat do not have global skill directories like Claude Code (`~/.claude/`) or Copilot CLI (`~/.copilot/`). They consume the pipeline through a separate rule file per project. So for them, sync runs **per-project**, over every repo in `prefs.global.projectsTouched[]`.
-
-This step RUNS BY DEFAULT. The only side effect on a project repo is a refresh of the marker-wrapped adapter files plus a LOCAL commit; **push is never automatic** (see below), so sync cannot publish anything to a project's remote on its own. If you still need to keep a project repo completely untouched this run (e.g. you are mid-feature-branch and do not want even a local commit), pass `--no-adapters` to skip the step.
-
-| Adapter | Per-project files | Created by setup |
-|---|---|---|
-| Cursor | `.cursor/rules/multi-agent-*.mdc` + `.cursor/agents/ma-*.md` + `.cursor/commands/multi-agent.md` + `.cursor/mcp.json` | `multi-agent:setup` `--cursor` flag |
-| Antigravity | `.agent/rules/multi-agent-*.md` + `.agent/workflows/multi-agent.md` + `AGENTS.md` + `.agent/mcp_config.json` | `multi-agent:setup` `--antigravity` flag |
-| Copilot Chat (VS Code) | `.github/copilot-instructions.md` + `.github/agents/ma-*.agent.md` + `.github/prompts/multi-agent.prompt.md` + `.vscode/mcp.json` | `multi-agent:setup` `--copilot-chat` flag |
-
-These three are FULL-orchestration adapters (subagents/workflow + a `/multi-agent` command + the dev-toolkit MCP server), not just knowledge layers. Claude Code and Copilot CLI run the pipeline natively and are synced via the global flow above, not here.
-
-**OpenAI Codex CLI is NOT in this per-project table.** Codex is a global-config tool: its custom prompts and MCP servers live under `~/.codex/` and there is no per-project prompt directory. So Codex is synced in the GLOBAL flow (Step 2a), not per-project - `sync-adapters.mjs` fires the codex adapter once when `~/.codex` exists, writing `~/.codex/prompts/multi-agent.md`, `~/.codex/AGENTS.md`, and the `[mcp_servers.dev-toolkit]` block in `~/.codex/config.toml`. Installed via `multi-agent:setup` `--codex` flag (or `node install.js --codex`). Codex has no subagent fan-out, so the Phase 4 parallel review degrades to a sequential adversarial two-pass.
-
-### Flow
-
-Adapter sync orchestration goes through `pipeline/scripts/sync-adapters.mjs`  -  this script discovers per-project marker files (`.cursor*`, `.github/copilot-instructions.md`, `.agent`/`AGENTS.md`) and dispatches the matching adapter module (`pipeline/adapters/{cursor,copilot-chat,antigravity}.mjs`, each of which also emits its orchestration layer).
-
-1. Read the `prefs.global.projectsTouched[]` list (LRU, max 20 entries). Each entry is in the form `{ path, adapters: [...] }`: a record of which adapters are installed in that project.
-
-2. One command, all projects:
-   ```bash
-   node pipeline/scripts/sync-adapters.mjs --all
-   ```
-
-   For each target the script:
-   - If a `.cursor/` or `.cursorrules` marker is present, runs the **cursor** adapter → `pipeline/adapters/cursor.mjs install()` emits 174+ `.cursor/rules/multi-agent-*.mdc` files + one legacy `.cursorrules` digest.
-   - If a `.copilot/` or `.github/copilot-instructions.md` marker is present, runs the **copilot-chat** adapter.
-   - The pipeline repo itself (when `pipeline/` + `.git/` are present) always gets the cursor sync  -  the maintainer's canonical cursor consumer.
-   - If no marker is present, skips (`[skip]`).
-
-3. Dry-run view:
-   ```bash
-   node pipeline/scripts/sync-adapters.mjs --doctor
-   ```
-
-4. Single-project refresh (this repo or another target):
-   ```bash
-   node pipeline/scripts/sync-adapters.mjs --target=/path/to/repo --platform=ios
-   ```
-
-5. Commits are made separately per project (no cross-project commit):
-   ```bash
-   cd "$PROJ"
-   if ! git diff --cached --quiet; then
-     git commit -m "chore(adapter): sync multi-agent rules"
-     # NOTE: push is not automatic  -  it's the user's call. Sync only makes a local commit.
-   fi
-   ```
-
-4. Push is **not automatic**. Adapter sync leaves the commit local by default; the push decision for each project branch is the user's (whether the project branch is shared requires external knowledge).
-
-### Skip conditions
-
-- If `--no-adapters` is given, Step 2b is skipped entirely (the report says "skipped (--no-adapters)").
-- `prefs.global.projectsTouched[]` empty -> "no project adapter installs recorded  -  run `multi-agent:setup` in a project first". Step 2b is a no-op (nothing to refresh), not an error.
-- Project directory deleted -> the entry is subject to LRU pruning (sync does not error there).
 
 ---
 
@@ -217,7 +148,7 @@ Adapter sync orchestration goes through `pipeline/scripts/sync-adapters.mjs`  -
 5. **Files NOT synced** (local-only, may contain personal data):
    - `~/.claude/multi-agent-preferences.json`
    - `~/.claude/CLAUDE.md`, `~/.claude/rules/`, `~/.claude/knowledge/`
-   - `~/.claude/scripts/`  -  EXCEPT `pre-commit-check.sh`, `stack-swap.sh` (legacy, retained for manual use), and `build-stack-plugins.mjs` (generic, synced)
+   - `~/.claude/scripts/`  -  EXCEPT `pre-commit-check.sh` and `build-stack-plugins.mjs` (generic, synced)
    - `~/.claude/settings.json`
 
 6. **Cross-platform smoke gate** (final step of the REPO sync, before push):
@@ -340,7 +271,7 @@ When invoked with the `release` argument:
 
 ## Sub-Command Sync (Claude Code <-> Copilot CLI Skills)
 
-This step runs only on the Claude <-> Copilot axis. Cursor / Copilot Chat do not have a global command directory; they consume the pipeline through the per-project rule files in Step 2b, so they have no sub-command-level sync target.
+This runs on the Claude <-> Copilot axis — the two CLIs the pipeline supports natively.
 
 | Claude Code | Copilot CLI |
 |-------------|-------------|

package/pipeline/commands/multi-agent/update.md

@@ -51,6 +51,15 @@ Update the pipeline in one command. Existing preferences are preserved; only ski
    fi
    ```
 
+4c. **Prune retired adapter files** (Cursor / Antigravity / Codex / Copilot Chat were removed in v10.7.0 — the pipeline now targets Claude Code + Copilot CLI only):
+   ```bash
+   # Global Codex adapter prompt is safe to remove (no longer produced).
+   rm -f "$HOME/.codex/prompts/multi-agent.md"
+   echo "  -> pruned retired global Codex adapter prompt (if present)"
+   # Per-project adapter files (.cursor/, .agent/, .github/copilot-instructions.md)
+   # live in your repos and are left untouched — remove them manually if you like.
+   ```
+
 5. **Migrate preferences** (if there is an old schema):
    ```bash
    if [ -f "$HOME/.claude/scripts/migrate-prefs.mjs" ]; then

package/pipeline/scripts/README.md

@@ -52,7 +52,6 @@ Validate contracts. Each emits `══ <name> smoke: N passed, M failed ══`
 - `smoke-prefs-language.sh`  -  `prefs.global.promptLanguage` contract
 - `smoke-progress-contract.sh`  -  progress-line quiet/normal/verbose
 - `smoke-search.sh`  -  `/multi-agent:search` log search + smart ranking
-- `smoke-stack-swap.sh`  -  `/multi-agent:stack` auto-detect + manual override
 - `smoke-subagent-validators.sh`  -  Phase 1/2 validator schemas
 - `smoke-telemetry.sh`  -  opt-in telemetry contract
 - `smoke-validator-contradiction.sh`  -  Phase 4 approved/blocking contradiction detection

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

@@ -13,7 +13,7 @@
  * plugin repo and are NEVER touched here — only the `knowledge/` layer + plugin.json
  * knowledge entries are regenerated.
  *
- * Routing mirrors pipeline/scripts/stack-swap.sh patterns. Genuinely cross-stack
+ * Routing uses the per-stack skill patterns (formerly carried by stack-swap.sh). Genuinely cross-stack
  * skills go to ai-common-engineering-toolkit (not into each stack plugin). Apple/
  * Xcode-only vendored skills that match no stack pattern belong to iOS only.
  *
@@ -45,7 +45,7 @@ const APPLE_ONLY = [
   'xcode-compilation-analyzer', 'xcode-project-analyzer',
 ];
 
-// stack → matching pattern (mirrors stack-swap.sh IOS/ANDROID/BACKEND/FRONTEND patterns)
+// stack → matching pattern (per-stack routing patterns (formerly in stack-swap.sh))
 const STACK_PATTERNS = {
   'ai-ios-engineering-toolkit': /(swiftui|swift-|ios-|hig-|apple-|storekit|widgetkit|healthkit|homekit|mapkit|musickit|passkit|pencilkit|realitykit|weatherkit|alarmkit|callkit|cloudkit|coreml|core-|eventkit|energykit|permissionkit|tipkit|shareplay|live-activities|background-processing|app-store|app-clips|app-intents|authentication|contacts-framework|device-integrity|macos-|natural-language|photos-camera|push-notifications|speech-recognition|swiftdata|vision-framework|debugging-instruments|help-skills)/i,
   'ai-android-engineering-toolkit': /(android|compose-|kotlin-|room-database|retrofit-|gradle-|play-store)/i,

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

@@ -226,13 +226,6 @@ if grep -q '"reviewerCount"' "$TRSCHEMA" && grep -qi "Claude Code = 2, Copilot C
 else
   fail "triage consensus.reviewerCount does not document the 2/3 split"
 fi
-# The 3 adapter platforms must document their concrete reviewer set (a 2-model
-# cross-vendor review configured to each platform's available models).
-if grep -qi "Adapter platforms" "$P4" && grep -qi "cross-vendor" "$P4" && grep -q "ma-code-reviewer-x" "$P4"; then
-  pass "phase-4-review documents the adapter-platform cross-vendor reviewer set"
-else
-  fail "phase-4-review does not document the adapter-platform reviewer set"
-fi
 
 echo ""
 echo "══ cross-cli-behavior smoke: $PASS passed, $FAIL failed ══"

package/pipeline/scripts/smoke-install-layout.sh

@@ -4,7 +4,7 @@
 # the same on-disk output as the pre-v8.0.0 monolithic installer.
 #
 # v8.0.0 split install.js (1246 LOC) into ./install/{index,claude,copilot,
-# _common,_platform-filter,_telemetry,_adapters,_dev-only-files,
+# _common,_platform-filter,_telemetry,_dev-only-files,
 # _copilot-instructions}.mjs. The legacy install.js stayed as a thin shim
 # that imports install/index.mjs and calls runInstall(process.argv).
 #
@@ -66,7 +66,6 @@ expected_modules=(
   "_common.mjs"
   "_platform-filter.mjs"
   "_telemetry.mjs"
-  "_adapters.mjs"
   "_copilot-instructions.mjs"
   "_dev-only-files.mjs"
 )

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

@@ -62,19 +62,20 @@ echo "→ 3. Phase wiring references the contract"
 grep -q "model-fallback.md" "$P0" && ok "phase-0-init wires the date gate" || fail "phase-0-init missing fallback wiring"
 grep -q "model-fallback.md" "$P4" && ok "phase-4-review wires the per-dispatch triggers" || fail "phase-4-review missing fallback wiring"
 
-echo "→ 4. Personas declare opus as preferred (fallback is dispatch-time, not file-time)"
-OPUS_COUNT=$(grep -l "^preferredModel: opus" "$REPO_ROOT"/pipeline/agents/*.md 2>/dev/null | wc -l | tr -d ' ')
-if [ "$OPUS_COUNT" -ge 5 ]; then
-  ok "opus personas intact ($OPUS_COUNT files)"
+echo "→ 4. Top-tier personas declare their preferred model (fallback is dispatch-time, not file-time)"
+# Fable 5 is the top tier again: architect + Reviewer-1 (+ triage) personas pin it.
+FABLE_COUNT=$(grep -l "^preferredModel: fable" "$REPO_ROOT"/pipeline/agents/*.md 2>/dev/null | wc -l | tr -d ' ')
+if [ "$FABLE_COUNT" -ge 4 ]; then
+  ok "fable top-tier personas present ($FABLE_COUNT files)"
 else
-  fail "expected >=5 opus personas, found $OPUS_COUNT"
+  fail "expected >=4 fable personas (architects + Reviewer-1), found $FABLE_COUNT"
 fi
-# Fable 5 is retired - no persona should still pin it.
-FABLE_LEFT=$(grep -l "^preferredModel: fable" "$REPO_ROOT"/pipeline/agents/*.md 2>/dev/null | wc -l | tr -d ' ')
-if [ "$FABLE_LEFT" -eq 0 ]; then
-  ok "no persona still pins retired fable tier"
+# Opus stays a valid tier — the first fallback below fable, and the top tier for security personas.
+OPUS_COUNT=$(grep -l "^preferredModel: opus" "$REPO_ROOT"/pipeline/agents/*.md 2>/dev/null | wc -l | tr -d ' ')
+if [ "$OPUS_COUNT" -ge 1 ]; then
+  ok "opus personas intact ($OPUS_COUNT files)"
 else
-  fail "expected 0 fable personas (fable retired), found $FABLE_LEFT"
+  fail "expected >=1 opus persona (fallback tier / security), found $OPUS_COUNT"
 fi
 
 echo ""

package/pipeline/skills/shared/core/multi-agent-finish/SKILL.md

@@ -35,7 +35,7 @@ Phases 1-3 (Analysis / Planning / Dev) are skipped by design  -  the branch's lo
 
 ```bash
 multi-agent finish                 # current branch vs base; Jira id from branch name
-multi-agent finish DIJITAL-12345    # explicit Jira id for the Phase 7 comment
+multi-agent finish PROJ-12345    # explicit Jira id for the Phase 7 comment
 multi-agent finish --base develop   # override base branch for the diff
 multi-agent finish autopilot        # no gate prompts: auto-fix, auto-PR, auto-comment
 ```

package/pipeline/skills/shared/core/multi-agent-stack/SKILL.md

@@ -47,4 +47,4 @@ multi-agent-stack all              # all four stack toolkits + common
 - Enablement is per-repo and declarative — commit `.claude/settings.json` so teammates get the same stack.
 - Restart the conversation to pick up newly enabled plugins.
 - Pipeline Phase 1 stack detection is independent (it reads project files); `stack` only sets which plugin skill set is active.
-- Legacy: `stack-swap.sh` is retained for manual/offline use but is no longer wired to any hook.
+- The old `stack-swap.sh` skill-dir swap has been removed; stack selection is entirely plugin enablement.

package/pipeline/skills/shared/core/multi-agent-sync/SKILL.md

@@ -90,7 +90,7 @@ If nothing is stale -> report "All targets up to date" and stop.
 5. **Files NOT synced** (local-only, may contain personal data):
    - `~/.claude/multi-agent-preferences.json`
    - `~/.claude/CLAUDE.md`, `~/.claude/rules/`, `~/.claude/knowledge/`
-   - `~/.claude/scripts/`  -  EXCEPT `pre-commit-check.sh`, `stack-swap.sh` (legacy, retained), and `build-stack-plugins.mjs` (generic, synced)
+   - `~/.claude/scripts/`  -  EXCEPT `pre-commit-check.sh` and `build-stack-plugins.mjs` (generic, synced)
    - Step 3c (PLUGINS): rebuild the `{owner}/multi-agent-plugins` marketplace from `shared/external` via `build-stack-plugins.mjs` (bumps changed plugins' patch version), then commit + push the plugins repo
    - `~/.claude/settings.json`
 

package/install/_adapters.mjs

@@ -1,73 +0,0 @@
-/**
- * Third-party adapter dispatch.
- *
- * Each adapter (Cursor / Copilot Chat) is dynamically imported only when its
- * flag is set, so the default Claude / Copilot install path stays free of
- * adapter module load cost.
- *
- * As of v8.5.4 the previously-shipped Windsurf / Cline / Zed / Continue
- * adapters were removed — pipeline owner did not use them, and keeping them
- * green added smoke-test surface for no real benefit. Their files were
- * deleted from `pipeline/adapters/`. Reintroducing any of them is a one-file
- * add against `_base.mjs`.
- *
- * @module install/_adapters
- */
-
-import { join } from "path";
-
-/**
- * @typedef {object} AdapterFlags
- * @property {boolean} cursor
- * @property {boolean} copilotChat
- * @property {boolean} antigravity
- * @property {boolean} codex
- */
-
-/**
- * @param {AdapterFlags} flags
- * @returns {boolean}
- */
-export function anyAdapterRequested(flags) {
-  return flags.cursor || flags.copilotChat || flags.antigravity || flags.codex;
-}
-
-/**
- * @param {{
- *   pipelineRoot: string,
- *   pipelineSrc: string,
- *   target: string,
- *   platformFilter: "ios"|"android"|"all",
- *   flags: AdapterFlags,
- * }} ctx
- */
-export async function installAdapters(ctx) {
-  const { pipelineRoot, target, platformFilter, flags } = ctx;
-  console.log("");
-  console.log("  Third-party tool adapters (knowledge layer only)");
-  console.log(`  Target: ${target}`);
-  console.log("");
-
-  const adapterCommonOpts = {
-    pipelineSrc: ctx.pipelineSrc,
-    target,
-    platformFilter,
-  };
-
-  const adapterTargets = [
-    flags.cursor && "./pipeline/adapters/cursor.mjs",
-    flags.copilotChat && "./pipeline/adapters/copilot-chat.mjs",
-    flags.antigravity && "./pipeline/adapters/antigravity.mjs",
-    flags.codex && "./pipeline/adapters/codex.mjs",
-  ].filter(Boolean);
-
-  for (const modPath of adapterTargets) {
-    try {
-      const adapter = (await import(join(pipelineRoot, modPath))).default;
-      console.log(`  [${adapter.name}] Installing...`);
-      adapter.install(adapterCommonOpts);
-    } catch (e) {
-      console.error(`    -> Adapter load failed (${modPath}): ${e.message}`);
-    }
-  }
-}