@mmerterden/multi-agent-pipeline 14.2.1 → 15.0.0

package/install/claude.mjs

@@ -14,7 +14,7 @@
  * @module install/claude
  */
 
-import { existsSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "fs";
+import { existsSync, readFileSync, readdirSync, renameSync, rmSync } from "fs";
 import { join, dirname } from "path";
 import { execSync } from "child_process";
 
@@ -35,7 +35,7 @@ import {
   wipeDir,
   writeFile,
 } from "./_common.mjs";
-import { copyExternalSkillsFiltered } from "./_platform-filter.mjs";
+import { EXTERNAL_SKILLS_MANIFEST } from "./_platform-filter.mjs";
 import { DEV_ONLY_SCRIPTS, countDevOnlyFiles } from "./_dev-only-files.mjs";
 import { registerMcpServer } from "./_mcp-register.mjs";
 
@@ -46,6 +46,16 @@ import { registerMcpServer } from "./_mcp-register.mjs";
  */
 export const LEGACY_PRE_COMMIT_MATCHER = "Bash(git commit:*)";
 
+/**
+ * The only skills installed locally on Claude Code. Everything else reaches
+ * Claude Code through the marketplace plugins (`ai-<stack>-toolkit`), namespaced
+ * by the plugin loader. These two stay local by policy: they are pipeline-owned
+ * compliance catalogs that may carry audit rules not meant for the public
+ * marketplace, and `scripts/uninstall.mjs` (PIPELINE_CORE_SKILL_DIRS) already
+ * treats exactly this pair as pipeline-owned.
+ */
+export const PIPELINE_LOCAL_SKILLS = ["apple-archive-compliance", "google-play-compliance"];
+
 /**
  * @param {{
  *   home: string,
@@ -128,13 +138,16 @@ function installCommands(pipelineSrc, dest, useSymlinks) {
   //
   // Preserve local-only alias wrappers (frontmatter `local-only: true`) across
   // the wipe. They live ONLY under ~/.claude (never in pipeline/commands, and
-  // never synced), so without this snapshot+restore they would be destroyed on
-  // every install/update. Pipeline never ships these names, so restore is safe.
-  const preservedWrappers = snapshotLocalOnlyWrappers(ownedCmdDir);
+  // never synced), so without this stash+restore they would be destroyed on
+  // every install/update. The stash is an on-disk rename, not an in-memory
+  // snapshot: the only copy of user-authored content stays on disk at every
+  // instant, so an install interrupted between wipe and restore loses nothing,
+  // and the next run adopts any leftover stash.
+  const wrapperStash = stashLocalOnlyWrappers(ownedCmdDir);
   wipeDir(ownedCmdDir);
 
   copyDir(commandsSrc, dest, { useSymlinks });
-  const restored = restoreLocalOnlyWrappers(ownedCmdDir, preservedWrappers);
+  const restored = unstashLocalOnlyWrappers(ownedCmdDir, wrapperStash);
   console.log(`    -> ${countFiles(commandsSrc)} files copied to ${dest}`);
   if (restored > 0) {
     console.log(`    -> preserved ${restored} local-only alias wrapper(s)`);
@@ -163,36 +176,51 @@ function localizeCommandDescriptions(pipelineSrc, ownedCmdDir) {
   }
 }
 
-// Snapshot single-level command dirs whose SKILL.md declares `local-only: true`
-// (their files are read into memory) so installCommands can restore them after
-// the namespace wipe.
-function snapshotLocalOnlyWrappers(ownedCmdDir) {
-  const out = [];
-  if (!existsSync(ownedCmdDir)) return out;
+// Move command dirs whose SKILL.md declares `local-only: true` into an on-disk
+// stash beside the namespace, so installCommands can restore them after the
+// namespace wipe. Returns the stash path.
+function stashLocalOnlyWrappers(ownedCmdDir) {
+  const stashDir = join(dirname(ownedCmdDir), ".multi-agent-wrapper-stash");
+  if (isDryRun() || !existsSync(ownedCmdDir)) return stashDir;
   for (const name of readdirSync(ownedCmdDir)) {
     const dir = join(ownedCmdDir, name);
     const skill = join(dir, "SKILL.md");
     if (!existsSync(skill)) continue;
     if (!/^local-only:\s*true\s*$/m.test(readFileSync(skill, "utf-8"))) continue;
-    const files = readdirSync(dir)
-      .filter((f) => statSync(join(dir, f)).isFile())
-      .map((f) => ({ rel: f, content: readFileSync(join(dir, f), "utf-8") }));
-    out.push({ name, files });
+    ensureDir(stashDir);
+    const target = join(stashDir, name);
+    if (existsSync(target)) rmSync(target, { recursive: true, force: true });
+    renameSync(dir, target);
   }
-  return out;
+  return stashDir;
 }
 
-// Restore snapshotted local-only wrappers, but never clobber a real command the
-// pipeline just installed under the same name. Returns the count restored.
-function restoreLocalOnlyWrappers(ownedCmdDir, preserved) {
+// Restore stashed local-only wrappers (including any leftover from an earlier
+// interrupted run), but never clobber a real command the pipeline just
+// installed under the same name. Returns the count restored.
+function unstashLocalOnlyWrappers(ownedCmdDir, stashDir) {
+  if (isDryRun() || !existsSync(stashDir)) return 0;
   let n = 0;
-  for (const w of preserved) {
-    const dir = join(ownedCmdDir, w.name);
-    if (existsSync(dir)) continue; // pipeline shipped a real command with this name
-    ensureDir(dir);
-    for (const f of w.files) writeFileSync(join(dir, f.rel), f.content);
+  for (const name of readdirSync(stashDir)) {
+    const from = join(stashDir, name);
+    const to = join(ownedCmdDir, name);
+    if (existsSync(to)) {
+      // The pipeline now ships a real command under a name the user's wrapper
+      // was using, so the wrapper cannot be restored. Say whose content is
+      // being dropped: /multi-agent:save writes exactly these, and a release
+      // claiming a new name would otherwise delete a saved routine in silence.
+      console.log(
+        `    -> WARNING: dropped local-only wrapper '${name}' - this release ships a command ` +
+          `with that name. Re-save it under a different name if you still need it.`,
+      );
+      rmSync(from, { recursive: true, force: true });
+      continue;
+    }
+    ensureDir(ownedCmdDir);
+    renameSync(from, to);
     n++;
   }
+  rmSync(stashDir, { recursive: true, force: true });
   return n;
 }
 
@@ -327,7 +355,7 @@ function runPreDeployScans(pipelineSrc) {
 }
 
 function installSkills(opts) {
-  const { pipelineSrc, dest, indexOnly, useSymlinks, platformFlag } = opts;
+  const { pipelineSrc, dest, indexOnly, useSymlinks } = opts;
   console.log("  [Claude Code] Installing skills...");
 
   // Same symlink guard as the other owned trees: never prune or copy through
@@ -343,40 +371,49 @@ function installSkills(opts) {
   }
 
   const sharedCoreSrc = join(pipelineSrc, "skills", "shared", "core");
-  const sharedExternalSrc = join(pipelineSrc, "skills", "shared", "external");
 
   let claudeSkillCount = 0;
 
-  if (existsSync(sharedCoreSrc)) {
-    copyDir(sharedCoreSrc, dest, { useSymlinks });
-    claudeSkillCount += countFiles(sharedCoreSrc);
+  // Claude Code no longer receives a local copy of the stack skills. The
+  // marketplace plugins (`ai-<stack>-toolkit`) are its only stack-skill source -
+  // a local copy duplicated ~110 skills against the enabled plugins (~10k
+  // tokens/session) and shadowed the plugin the moment it went stale. Only the
+  // two pipeline-owned compliance catalogs stay local (PIPELINE_LOCAL_SKILLS);
+  // they are deliberately not published to the marketplace.
+  ensureDir(dest);
+  for (const name of PIPELINE_LOCAL_SKILLS) {
+    const from = join(sharedCoreSrc, name);
+    if (!existsSync(from)) continue;
+    if (!useSymlinks) wipeDir(join(dest, name));
+    copyDir(from, join(dest, name), { useSymlinks });
+    claudeSkillCount += countFiles(from);
   }
 
-  if (existsSync(sharedExternalSrc)) {
-    const { copied, skipped } = copyExternalSkillsFiltered(sharedExternalSrc, dest, {
-      platformFlag,
-      useSymlinks,
-    });
-    claudeSkillCount += copied;
-    if (skipped > 0) {
-      console.log(
-        `    -> --platform=${platformFlag} filter skipped ${skipped} external skill dir(s)`,
-      );
-    }
+  // Single-standard enforcement: Claude Code invokes pipeline commands via
+  // the `/multi-agent:*` slash-command namespace, so prune duplicate skill
+  // dirs left by older installs that copied shared/core wholesale. This used
+  // to live inside the external-copy branch; it must run unconditionally or
+  // the 51 multi-agent-* dirs return on the first install after a migration.
+  const pruned = pruneLegacyMultiAgentSkills(dest);
+  if (pruned > 0) {
+    console.log(
+      `    -> pruned ${pruned} legacy multi-agent-* skill dirs (slash commands cover these)`,
+    );
+  }
 
-    // Single-standard enforcement: Claude Code invokes pipeline commands via
-    // the `/multi-agent:*` slash-command namespace, so prune duplicate skill
-    // dirs that come from the shared/external/ tree.
-    const pruned = pruneLegacyMultiAgentSkills(dest);
-    if (pruned > 0) {
-      claudeSkillCount -= pruned;
-      console.log(
-        `    -> pruned ${pruned} legacy multi-agent-* skill dirs (slash commands cover these)`,
-      );
-    }
+  // Migration prune: an older install delivered the full external catalog here.
+  // Its manifest names exactly what was delivered, so removal is manifest-scoped -
+  // user-authored skills in the same directory are untouched. Without a manifest
+  // nothing is guessed; the stale copy then outlives this install and the user
+  // can clean it via uninstall --claude.
+  const migrated = pruneManifestDeliveredSkills(dest);
+  if (migrated > 0) {
+    console.log(
+      `    -> migration: removed ${migrated} stack skill dir(s) previously copied here (now plugin-only)`,
+    );
   }
 
-  // Figma component skills moved to the ai-<platform>-engineering-toolkit marketplace
+  // Figma component skills moved to the ai-<platform>-toolkit marketplace
   // plugin and are no longer bundled here. Prune any stale copies left by a
   // pre-migration install so the installed tree stays consistent.
   for (const sub of ["figma-ios", "figma-android", "figma-common", "figma-to-component"]) {
@@ -410,21 +447,69 @@ function installSkills(opts) {
     console.log(`    -> pruned ${orphans} stale flat skill file(s) from an older layout`);
   }
 
-  console.log(`    -> ${claudeSkillCount} skill files installed to ${dest}`);
+  console.log(`    -> ${claudeSkillCount} skill files installed to ${dest} (stack skills: marketplace plugins)`);
 
-  // Keep the shared skills index README in sync.
-  const sharedReadmeSrc = join(pipelineSrc, "skills", "shared", "README.md");
-  if (existsSync(sharedReadmeSrc)) {
-    const claudeReadme = join(dest, "README.md");
+  // The shared skills README described the full local catalog; with the catalog
+  // gone it would document skills that are not here. Drop it, including copies
+  // an older install left behind.
+  const claudeReadme = join(dest, "README.md");
+  if (existsSync(claudeReadme) && !isDryRun()) {
     try {
-      copyFile(sharedReadmeSrc, claudeReadme);
-      console.log(`    -> updated ${claudeReadme}`);
+      rmSync(claudeReadme);
+      console.log(`    -> removed ${claudeReadme} (local catalog no longer installed)`);
     } catch {
       /* non-fatal */
     }
   }
 }
 
+/**
+ * Remove the external stack skills an older install copied into `dest`, scoped
+ * strictly to the delivery manifest that install wrote. NOTICE files rode along
+ * with the external catalog, so they go with it.
+ *
+ * @param {string} dest - the installed skills directory
+ * @returns {number} directories removed
+ */
+function pruneManifestDeliveredSkills(dest) {
+  const manifestPath = join(dest, EXTERNAL_SKILLS_MANIFEST);
+  if (!existsSync(manifestPath)) return 0;
+  if (isDryRun()) {
+    console.log(`    [dry-run] would remove externally-delivered skills named in ${manifestPath}`);
+    return 0;
+  }
+  let removed = 0;
+  try {
+    const names = JSON.parse(readFileSync(manifestPath, "utf-8"));
+    for (const name of Array.isArray(names) ? names : []) {
+      // The two local compliance catalogs are never external-delivered, but a
+      // corrupted manifest must not be able to take them out.
+      if (PIPELINE_LOCAL_SKILLS.includes(name)) continue;
+      const dir = join(dest, name);
+      if (!existsSync(dir)) continue;
+      try {
+        rmSync(dir, { recursive: true, force: true });
+        removed++;
+      } catch {
+        /* non-fatal */
+      }
+    }
+    for (const entry of readdirSync(dest)) {
+      if (entry.startsWith("NOTICE-") && entry.endsWith(".md")) {
+        try {
+          rmSync(join(dest, entry));
+        } catch {
+          /* non-fatal */
+        }
+      }
+    }
+    rmSync(manifestPath, { force: true });
+  } catch {
+    /* unreadable manifest: leave everything in place rather than guess */
+  }
+  return removed;
+}
+
 function ensureClaudeMd(home, pipelineSrc) {
   console.log("  [Claude Code] Checking CLAUDE.md template...");
   const CLAUDE_MD = join(home, ".claude", "CLAUDE.md");

package/install/codex.mjs

@@ -10,7 +10,7 @@
  * name + description into a single prompt block and silently drops entries once
  * that block overflows - measured at install-design time, one 142-skill plugin
  * surfaced only 75 of its skills AND evicted an unrelated user skill. So the
- * pipeline contributes exactly one skill (`multi-agent`) and keeps its 42
+ * pipeline contributes exactly one skill (`multi-agent`) and keeps its
  * sub-command specs as reference files that cost nothing until read. Converting
  * them into peer skills would silently lose pipeline commands.
  *
@@ -34,7 +34,15 @@ import {
 import { DEV_ONLY_SCRIPTS, countDevOnlyFiles } from "./_dev-only-files.mjs";
 import { registerMcpServer } from "./_mcp-register.mjs";
 import { installCodexAgents } from "./_codex-agents.mjs";
-import { installAuthoredPluginSkills, pipelineOwnedSkillNames } from "./_plugin-skills.mjs";
+import {
+  installAuthoredPluginSkills,
+  pipelineOwnedSkillNames,
+  pluginsToDeliver,
+} from "./_plugin-skills.mjs";
+import {
+  partitionExternalSkillsByPlugins,
+  writeExternalSkillsManifest,
+} from "./_platform-filter.mjs";
 import { generateCodexInstructions } from "./_codex-instructions.mjs";
 import { mergeManagedBlock } from "./_managed-block.mjs";
 
@@ -230,7 +238,12 @@ function installRouterSkill(pipelineSrc, skillsDir) {
   const dest = join(skillsDir, "multi-agent");
   ensureDir(dest);
   writeFile(join(dest, "SKILL.md"), skill);
-  console.log(`    -> 1 router skill written to ${dest} (42 command specs stay as refs)`);
+
+  const commandsDir = join(pipelineSrc, "commands", "multi-agent");
+  const specCount = existsSync(commandsDir)
+    ? readdirSync(commandsDir, { withFileTypes: true }).filter((e) => e.isDirectory()).length
+    : 0;
+  console.log(`    -> 1 router skill written to ${dest} (${specCount} command specs stay as refs)`);
 }
 
 /**
@@ -264,7 +277,7 @@ function pruneLegacyCommandSkills(skillsDir) {
 }
 
 /**
- * Install the reference tree: the shared `multi-agent-refs/` docs plus the 42
+ * Install the reference tree: the shared `multi-agent-refs/` docs plus every
  * sub-command specs, all path-rewritten. These are read on demand and never
  * enter the skills block.
  */
@@ -279,10 +292,10 @@ function installRefs(pipelineSrc, dest) {
   let count = 0;
   if (existsSync(refsSrc)) count += copyTreeRewritten(refsSrc, dest);
 
-  // The 42 sub-command specs. Skip ONLY the top-level dispatcher SKILL.md -
+  // The sub-command specs. Skip ONLY the top-level dispatcher SKILL.md -
   // it already shipped as the router skill. The filter is on the path relative
   // to the copy root, not the basename: every sub-command spec is itself named
-  // SKILL.md, so a basename filter would copy 42 empty directories and leave
+  // SKILL.md, so a basename filter would copy N empty directories and leave
   // the orchestrator with nothing to read.
   if (existsSync(commandsSrc)) {
     count += copyTreeRewritten(commandsSrc, join(dest, "commands"), (rel) => rel !== "SKILL.md");
@@ -389,7 +402,24 @@ function installSkillRefs(pipelineSrc, dest, home, platformFlag) {
   wipeDir(dest);
 
   let count = 0;
-  if (existsSync(externalSrc)) count += copyTreeRewritten(externalSrc, dest);
+  if (existsSync(externalSrc)) {
+    // Active-stack filter (same contract as Copilot): Codex used to receive all
+    // 151 external skills regardless of stack - platformFlag only shaped the
+    // authored-plugin delivery below. The enabled-plugin set from
+    // ~/.claude/settings.json now bounds this copy too, so a Claude+Codex user
+    // sees one consistent stack surface across both hosts. The manifest makes
+    // the delivery inspectable; the wholesale wipeDir above already handles
+    // staleness on every install.
+    const { names: enabled, source: selectionSource } = pluginsToDeliver(home, platformFlag);
+    const { keep, skipped } = partitionExternalSkillsByPlugins(externalSrc, enabled);
+    for (const name of keep) {
+      count += copyTreeRewritten(join(externalSrc, name), join(dest, name));
+    }
+    writeExternalSkillsManifest(dest, keep);
+    console.log(
+      `    -> stack filter (${selectionSource}): ${keep.length} kept, ${skipped.length} skipped`,
+    );
+  }
 
   // `shared/core` also holds two skills that are NOT pipeline sub-commands:
   // apple-archive-compliance and google-play-compliance. Copying only `external`

package/install/copilot.mjs

@@ -24,11 +24,18 @@ import {
   wipeDir,
   writeFile,
 } from "./_common.mjs";
-import { copyExternalSkillsFiltered } from "./_platform-filter.mjs";
+import {
+  partitionExternalSkillsByPlugins,
+  writeExternalSkillsManifest,
+} from "./_platform-filter.mjs";
 import { DEV_ONLY_SCRIPTS, countDevOnlyFiles } from "./_dev-only-files.mjs";
 import { generateCopilotInstructions } from "./_copilot-instructions.mjs";
 import { legacyTrailingContent, mergeManagedBlock } from "./_managed-block.mjs";
-import { installAuthoredPluginSkills, pipelineOwnedSkillNames } from "./_plugin-skills.mjs";
+import {
+  installAuthoredPluginSkills,
+  pipelineOwnedSkillNames,
+  pluginsToDeliver,
+} from "./_plugin-skills.mjs";
 import { registerMcpServer } from "./_mcp-register.mjs";
 
 /**
@@ -357,16 +364,34 @@ function installSkills(opts) {
   }
 
   if (existsSync(sharedExternalSrc)) {
-    const { copied, skipped } = copyExternalSkillsFiltered(sharedExternalSrc, dest, {
-      platformFlag,
-      useSymlinks,
-    });
-    copilotSkillCount += copied;
-    if (skipped > 0) {
-      console.log(
-        `    -> --platform=${platformFlag} filter skipped ${skipped} external skill dir(s)`,
-      );
+    // Active-stack filter: Copilot has no plugin loader, so its local copy is the
+    // only stack-skill source it has - but it should still carry the SAME stack
+    // set the enabled plugins serve on Claude Code, not the whole catalog. The
+    // enabled set comes from ~/.claude/settings.json (pluginsToDeliver); the
+    // --platform flag stays as the fallback for machines without one.
+    const { names: enabled, source: selectionSource } = pluginsToDeliver(home, platformFlag);
+    const { keep, skipped } = partitionExternalSkillsByPlugins(sharedExternalSrc, enabled);
+    ensureDir(dest);
+    for (const name of keep) {
+      const src = join(sharedExternalSrc, name);
+      const dst = join(dest, name);
+      if (!useSymlinks) wipeDir(dst);
+      copyDir(src, dst, { useSymlinks });
+      copilotSkillCount += countFiles(src);
+    }
+    // Stale prune: a skill delivered by a previous, wider stack selection must
+    // leave when the selection narrows, or the old stack lingers forever.
+    for (const name of skipped) {
+      const stale = join(dest, name);
+      if (!existsSync(stale) || isDryRun()) continue;
+      try {
+        rmSync(stale, { recursive: true, force: true });
+      } catch {
+        /* non-fatal */
+      }
     }
+    writeExternalSkillsManifest(dest, keep);
+    console.log(`    -> stack filter (${selectionSource}): ${keep.length} kept, ${skipped.length} skipped`);
   }
 
   // The pre-migration figma-* skill copies are gone; the plugin owns component work

package/install/index.mjs

@@ -187,7 +187,9 @@ function printSummary(opts) {
   // hand-registered entry became the only reason it worked on any given machine.
   console.log("  For UI testing, the dev-toolkit MCP server is registered automatically:");
   if (forClaude) {
-    console.log("    Claude Code: claude mcp add --scope user dev-toolkit  (user scope, all projects)");
+    console.log(
+      "    Claude Code: claude mcp add --scope user dev-toolkit  (user scope, all projects)",
+    );
   }
   if (forCopilot) {
     console.log("    Copilot CLI: copilot mcp add dev-toolkit");
@@ -195,7 +197,9 @@ function printSummary(opts) {
   if (forCodex) {
     console.log("    Codex CLI:   codex mcp add dev-toolkit");
   }
-  console.log("    Skipped only when the host CLI is not on PATH - the command to run is printed above.");
+  console.log(
+    "    Skipped only when the host CLI is not on PATH - the command to run is printed above.",
+  );
   console.log("");
   console.log("  Uninstall everything: npx @mmerterden/multi-agent-pipeline uninstall");
   console.log("  (Personal access tokens in keychain are preserved.)");

package/install/templates/codex-instructions.md

@@ -62,7 +62,7 @@ failure this layout exists to prevent.
 
 Codex assembles every discovered skill's name + description into one prompt block
 and **silently drops entries when that block overflows**. The pipeline therefore
-contributes exactly **one** skill (`multi-agent`) and keeps its 42 sub-command
+contributes exactly **one** skill (`multi-agent`) and keeps every sub-command
 specs as reference files that cost nothing until read. Do not convert those specs
 into peer skills: doing so evicts other skills, including ones from installed
 plugins, with no error surfaced.

package/install/templates/copilot-instructions.md

@@ -33,17 +33,20 @@
 - **Fast + Local (multi-agent-dev-local)**: Dev on current branch - no worktree
 - **Fastest + Local (multi-agent-dev-local-autopilot)**: Dev + autopilot, no worktree
 
-## Prompt Language (en/tr)
+## Language axes (en/tr)
 
-The pipeline honors `prefs.global.promptLanguage` (set via `/multi-agent:setup` or
-`/multi-agent:language en|tr`). This controls the language of **interactive prompts
-only** - e.g. the Phase 6 pre-commit local-checkout test prompt, Plan Approval Gate
-questions, multi-repo branch picker labels, and phase-banner.sh banners (when
-PHASE_LANG env is unset, it auto-reads prefs).
+Two prefs, two jobs - the full matrix lives in `multi-agent-refs/rules.md`
+"Language Application" and that file wins on any disagreement:
 
-Default: `en`. Supported: `en`, `tr`. Commit messages, PR bodies, Jira comments,
-and any external-facing payload **always stay in English** regardless of this
-setting - only the user-facing prompts change.
+- `prefs.global.promptLanguage` is **locked to `en`**: every LLM-facing prompt,
+  spec file and instruction stays English.
+- `prefs.global.outputLanguage` (set via `/multi-agent:setup` or
+  `/multi-agent:language en|tr`) drives what humans read: interactive prompts,
+  phase banners, AND the external payload **bodies** - PR description, Jira
+  comment, Confluence/Wiki pages all render in it.
+
+Always English regardless of either pref: commit messages, branch names, PR
+titles, code identifiers, file paths, and `AskUserQuestion` label/header.
 
 When writing TR prompts, use the same keyword/menu numbers as EN (e.g. `[1-4]`)
 so the user's input pattern stays language-agnostic.
@@ -242,7 +245,7 @@ Cost block reads `phase-tracker.sh tokens` accumulators × `cost-table.json` pri
 
 ## Stack Selection
 
-Stack skill sets ship as versioned plugins in the `multi-agent-plugins` marketplace. Selecting a stack enables the matching plugin(s) in the target repo's `.claude/settings.json` `enabledPlugins`; the `ai-common-engineering-toolkit` is always enabled alongside. There is no session-start auto-swap script. Select or change the stack with:
+Stack skill sets ship as versioned plugins in the `multi-agent-plugins` marketplace. Selecting a stack enables the matching plugin(s) in the target repo's `.claude/settings.json` `enabledPlugins`; the `ai-common-toolkit` is always enabled alongside. There is no session-start auto-swap script. Select or change the stack with:
 
 ```bash
 multi-agent-stack [ios|android|mobile|backend|frontend|fullstack|all]
@@ -299,8 +302,8 @@ if [ "$(jq '.projects | length' "$STATE_FILE")" -ge 2 ]; then
 fi
 ```
 
-Full contract: `~/.copilot/skills/multi-agent/refs/multi-repo-integration-build.md`
-(or on GitHub: https://github.com/mmerterden/multi-agent-pipeline/blob/main/pipeline/multi-agent-refs/multi-repo-integration-build.md)
+Full contract: https://github.com/mmerterden/multi-agent-pipeline/blob/main/pipeline/multi-agent-refs/multi-repo-integration-build.md
+(the Copilot install ships no local refs tree, so the contract lives on GitHub only)
 
 ## Permissions Expectation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "14.2.1",
+  "version": "15.0.0",
   "description": "8-phase AI development pipeline with full orchestration on Claude Code, Copilot CLI and Codex CLI. Analysis, planning, TDD, CLI-aware parallel review with consensus surfacing + Fable triage, default-FAIL evidence gates, secret + intent guards, per-phase cost ledger, persistent learnings memory, wiki generation, commit automation. Token-preserving uninstall.",
   "type": "module",
   "main": "index.js",
@@ -89,7 +89,6 @@
     "!pipeline/scripts/sync-parity-check.sh",
     "!pipeline/scripts/benchmark-phase-0.sh",
     "!pipeline/scripts/fixtures/**",
-    "!pipeline/scripts/test-gap-rules/**",
     "!pipeline/eval/**",
     "pipeline/scripts/smoke-schema-validation.sh",
     "pipeline/scripts/smoke-cross-cli-behavior.sh"

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

@@ -12,7 +12,7 @@ Parse the user input and route to the correct sub-command.
 
 **Input**: $ARGUMENTS
 
-> **Language (read FIRST)**: Before any status output, read `prefs.global.outputLanguage` from `$HOME/.claude/multi-agent-preferences.json` and render every conversational line in it. `AskUserQuestion` and external payloads stay English. Full contract: `$HOME/.claude/multi-agent-refs/rules.md` "Language Application".
+> **Language (read FIRST)**: Before any status output, read `prefs.global.outputLanguage` from `$HOME/.claude/multi-agent-preferences.json` and render every conversational line in it. `AskUserQuestion` `label`/`header` stay English, but its `question` and option `description`s render in `outputLanguage`; external payload bodies follow `outputLanguage` too (identifiers, commit messages, branch names stay English). Full contract: `$HOME/.claude/multi-agent-refs/rules.md` "Language Application".
 
 ## Canonical Invocation (per CLI)
 
@@ -78,6 +78,7 @@ Lib scripts (`~/.claude/lib/`):
 | `review-jira [KEY\|url]` | Grade a Jira issue's readiness for the pipeline (scope / AC / repro / design / API / stack), then post the gaps as a Jira comment. Read-only on code. |
 | `review-issue [#N\|repo#N\|url]` | Grade a GitHub issue's readiness for the pipeline, then post the gaps as an issue comment. Read-only on code. |
 | `analysis ["<feature>"]` | Standalone feature-spec analizi: Figma / Swagger / Confluence / Jira / repo girdileri sabit 7-bölümlük şablona dökülür, humanizer'dan geçer, Local/Confluence/Jira hedef(ler)ine post edilir. Worktree veya commit yok. Dev'e zincirleme yok. |
+| `complaint-analysis ["<run-name>"] [--file <path>] [<jira-id\|confluence-url> ...]` | Müşteri şikayeti triyajı: şikayetler (serbest metin / csv-xlsx-txt-json dosya / Jira issue / Confluence URL) redakte edilerek alınır, trxId/conversationId ile Graylog kanıtı çekilir, seçili client + BFF repolarında salt-okunur eşleştirme yapılır; verdict: client/bff (kök neden + citation + mevcut mimariyi referans alan fix planı + hazır dev prompt'u) veya core (core ekibine yönlendirme önerisi) veya insufficient-evidence. Rapor + Stop; worktree, commit, dev zinciri yok. |
 | `build-optimize` | iOS-only Xcode build performance wrapper. Vendored `xcode-build-orchestrator`'a dispatch eder; benchmark + compilation / project / SPM analyzer'lar + recommend-first plan `.build-benchmark/optimization-plan.md`. Non-iOS stack'lerde fail-fast. |
 | `channels [PR-url\|#N\|Jira-url\|Jira-id] [--channels pr,jira,confluence,wiki] [--content normal,test,auto-diff,note] [--message "..."]` | Post task report to multi-select channels (PR description, Jira comment, Confluence page, Wiki pages) with multi-select content sources. Humanizer pass per-channel. Bitbucket PR updates use reviewer-preserving PUT. Phase 7 delegates to this command; also invocable post-hoc for fixes made outside the pipeline. No worktree. |
 | `create-jira ["desc"] [figma-url] [swagger-url]` | Create a standards-compliant Jira issue: asks the type (**Task** / **Bug** / **Story**), mines the project's recent same-type issues for conventions (summary format, labels, priority, test-scenario style), detects the active sprint, drafts from a standard template with auto-sizing sections (Design Reference / API Contract / Screenshots appear only when their source is given), asks about unknown fields, then full draft preview + explicit approval before create. No worktree, no commits. |
@@ -120,6 +121,7 @@ This command uses lazy loading for token efficiency. Read the relevant sub-file
 | `review-jira` | `$HOME/.claude/commands/multi-agent/review-jira/SKILL.md` (loads `$HOME/.claude/multi-agent-refs/readiness-review.md`) |
 | `review-issue` | `$HOME/.claude/commands/multi-agent/review-issue/SKILL.md` (loads `$HOME/.claude/multi-agent-refs/readiness-review.md`) |
 | `analysis` | `$HOME/.claude/commands/multi-agent/analysis/SKILL.md` |
+| `complaint-analysis` | `$HOME/.claude/commands/multi-agent/complaint-analysis/SKILL.md` |
 | `build-optimize` | `$HOME/.claude/commands/multi-agent/build-optimize/SKILL.md` |
 | `local` | `$HOME/.claude/commands/multi-agent/local/SKILL.md` |
 | `local-autopilot` | `$HOME/.claude/commands/multi-agent/local-autopilot/SKILL.md` |
@@ -207,7 +209,7 @@ When the user supplies an ID/URL/free-text:
 2. **Pick account**  -  always asked (autopilot picks default)
 3. **Fetch issue**  -  `lib/issue-fetcher.sh "$INPUT"` (Jira/GitHub fetch + maturity)
 4. **Repo picker**  -  only for `gh-num` (e.g. `316`) when repo is ambiguous, multi-select
-5. **Maturity check**  -  blocker halts (autopilot too), warning prompt/log
+5. **Maturity check**  -  blocker halts (autopilot too), warning prompt/log. For a Jira input specifically, an empty own description with a non-empty parent surfaces as `description_empty_parent_available` (warning, not blocker)  -  ask the tailored parent-description question from `jira/SKILL.md`'s maturity section instead of the generic "Continue?" prompt.
 6. **Dev context**  -  always runs, empty submit allowed
 7. → Interactive Launcher → Phase 0
 

package/pipeline/commands/multi-agent/analysis/SKILL.md

@@ -505,9 +505,9 @@ For each `platform` in `state.analysisSpec.platforms[]`:
 
 2. **Per-platform markdown render**: for each platform in `state.analysisSpec.platforms[]`, concatenate the per-platform spec into one markdown file. Tables in pipe-syntax. Numbering uses plain `## 1.`, `## 2.`, ... - omitted sections do **not** create gaps. Visible numbering is sequential 1..N over the rendered set.
 
-3. **Humanizer pass (MANDATORY: actually invoke the `humanizer` skill on the rendered markdown - the punctuation grep alone does NOT satisfy this step)** (`technical-explanatory` tone for the scratch buffer; per-channel re-humanize happens in Phase 4 when actually emitting):
+3. **Humanizer pass (MANDATORY: actually invoke the `ai-common-toolkit:humanizer` skill on the rendered markdown - the punctuation grep alone does NOT satisfy this step)** (`technical-explanatory` tone for the scratch buffer; per-channel re-humanize happens in Phase 4 when actually emitting):
    ```
-   humanizer skill input:
+   ai-common-toolkit:humanizer skill input:
      language: <tr|en>
      tone: technical-explanatory
      stripFancyPunctuation: true
@@ -543,7 +543,7 @@ options:
 
 Conditional follow-ups:
 - If `Confluence` selected: ask `header="Parent page"`, free-text via Other for the parent page key or URL. One Confluence page per platform is created under this parent, each titled `<Feature> - <Platform>`.
-- If `Jira` selected: if Step 5 Q4 produced Jira IDs, AskUserQuestion (single-select) to pick which one; otherwise ask via Other. Per Locked decision 9 + design choice "single description with platform separators", the chosen issue receives one combined description body holding all per-platform sections under `## Platform: <X>` headings.
+- If `Jira` selected: if Step 5 Q4 produced Jira IDs, AskUserQuestion (single-select) to pick which one; otherwise ask via Other. Per Locked decision 9 + design choice "single description with platform separators", the chosen issue receives one combined description body holding all per-platform sections under `h2. Platform: <X>` separators (wiki markup  -  the description field does not render Markdown; conversion happens at dispatch, see Phase 4).
 
 Result: `state.analysisSpec.outputs.requested[]`.
 
@@ -565,7 +565,7 @@ Iterate `state.analysisSpec.outputs.requested`. For each target:
 |--------|--------|
 | Local | For each per-platform draft, `cp /tmp/analysis-<feature-slug>-<ts>/<feature>-<platform>.md` into `analysis/<feature>-<platform>.md` in the matching repo's working tree. When multiple repos exist for the same platform, the file is duplicated into each and the dispatch report lists every destination. **No commit.** |
 | Confluence | Re-humanize each per-platform draft with `formal-stakeholder` tone. One Confluence page per platform under the chosen parent, titled `<Feature> - <Platform>`. Cross-link siblings inside each page via `<ac:link><ri:page ri:content-title="<Feature> - <OtherPlatform>"/></ac:link>`. Markdown -> storage XML via `$HOME/.claude/multi-agent-refs/channels/confluence.md`. Re-emit on existing pages uses PUT with version bump. |
-| Jira | Re-humanize the combined body with `informal-technical` tone. Concatenate per-platform drafts under `## Platform: iOS`, `## Platform: Android`, `## Platform: Backend`, `## Platform: Frontend` separators (in the order platforms were selected). PUT the chosen issue's description via `$HOME/.claude/multi-agent-refs/channels/jira.md`. |
+| Jira | Re-humanize the combined body with `informal-technical` tone. Concatenate per-platform drafts under `h2. Platform: iOS`, `h2. Platform: Android`, `h2. Platform: Backend`, `h2. Platform: Frontend` separators (in the order platforms were selected), then run the whole body through the markdown → Jira wiki conversion table in `$HOME/.claude/multi-agent-refs/channels/jira.md`  -  the `description` field renders wiki markup, so raw `##`/`**`/backticks arrive as literal text. Write with `PUT /rest/api/2/issue/{key}` body `{"fields": {"description": <converted body>}}` (`channels/jira.md` documents only the comment POST; the description update is this PUT). Same rawfile + `--data-binary` transport rules. |
 
 **Output capture**: fill `state.analysisSpec.outputs.localPaths[]` (one entry per per-platform-per-repo write), `outputs.confluencePageUrls[]` (one entry per platform), `outputs.jiraIssueKey` (single string).
 
@@ -662,7 +662,7 @@ When `phase == "cancelled_at_pass_b_preview"`:
 | `~/.claude/lib/extract-conventions.sh` | Phase 1c convention extractor (7 pattern groups, JSON output, confidence levels) |
 | `~/.claude/lib/figma-screenshot.sh` | Phase 2b Tier 2 Figma image downloader (REST API, section drill, 2x scale PNG, manifest.json) |
 | `~/.claude/lib/md2confluence-v3.py` | Phase 4 Confluence dispatch (multipart attachments, `<ac:image>` injection, mermaid macro + fallback, tooltip footnote macro, punctuation gate) |
-| `$HOME/.claude/skills/humanizer/SKILL.md` | Phase 3 tone pass |
+| `ai-common-toolkit:humanizer` | Phase 3 tone pass |
 | 8-locale set (ar, de, en, es, fr, it, ru, tr) + localization-key naming (inline) | Section 10 localization generation |
 | `$HOME/.claude/multi-agent-refs/channels/confluence.md` | Phase 4 Confluence dispatch |
 | `$HOME/.claude/multi-agent-refs/channels/jira.md` | Phase 4 Jira dispatch |