@mmerterden/multi-agent-pipeline 11.3.0 → 11.3.2

package/CHANGELOG.md

@@ -14,6 +14,52 @@ Internal file-layout changes that don't affect the slash-command surface are sti
 
 ---
 
+## [11.3.2] - 2026-07-10
+
+Command rename + website refresh.
+
+- **Renamed `/multi-agent:generate` -> `/multi-agent:create-jira`** (Copilot skill
+  `multi-agent-generate` -> `multi-agent-create-jira`). The command is the
+  consolidated Jira-issue creator that asks the type (Task / Bug / Story); the
+  new name says what it does. Command dir, Copilot skill, dispatcher rows, help
+  (EN + TR), the command inventory in the cross-CLI contract + both sync copies,
+  the skill index + manifest, and the contract smoke were all updated; command
+  count stays 36. The internal ref (`generate-issue.md`) keeps its filename.
+- **Website:** corrected the `multi-agent-plugins` skill count (205 -> 227, the
+  real sum across the five toolkits) and bumped the pipeline card to this version.
+- Also published v11.3.1 to GitHub Packages (both registries were on npmjs only).
+
+## [11.3.1] - 2026-07-10
+
+Self-audit patch (found by running `/multi-agent:refactor` on the pipeline itself): a data-loss fix, a latent gate regression, supply-chain hardening, and a few correctness fixes.
+
+- **Fix (data-loss): uninstall no longer deletes `~/.claude/rules/`.** Install
+  treats `rules/` as user-owned (write-if-missing, never overwritten), but the
+  uninstaller recursively removed the whole tree, destroying personal rules
+  (including the git-attribution rule). Uninstall now preserves `rules/`, and
+  lists it in the PRESERVED summary.
+- **Fix (gate regression): `lint-skills` scoped to `pipeline/skills`.** The
+  v11.3.0 command-layout migration made command files match `find pipeline -name
+  SKILL.md`; slash commands have no `name:` frontmatter, so the skill linter
+  started erroring on all 37 of them (latent because CI is billing-paused and
+  releases were published manually). The linter now only checks actual skills.
+- **Fix: `.skills-index.json` is idempotent** - dropped the `generatedAt`
+  timestamp so regenerating an unchanged skill set produces no diff.
+- **Fix: uninstall strips the Copilot pipeline block regardless of file size** -
+  removed the 50 KB fallback cap that orphaned the block in large
+  `copilot-instructions.md` files.
+- **Fix: install "dev-only excluded" count** is now the real file count (the
+  `fixtures/` directory was under-counted as one entry).
+- **Security (supply-chain):** `release.yml` publishes with `npm publish
+  --provenance` (`id-token: write`); all GitHub Actions pinned to commit SHAs;
+  added `.github/dependabot.yml` (actions + npm dev deps); `credential-store.sh`
+  escapes single quotes in the Windows PowerShell paths.
+- **New: `eval-mine-corpus.mjs`** turns recorded triage decisions
+  (`triage-corpus.jsonl`) into review-gated candidate triage-eval fixtures.
+- **Tests:** added node unit tests for the Phase 4 diff-risk gates
+  (`test/phase4-gates.test.mjs`) so they run in the release lane, not only the
+  bash smoke; `lint-skills` now warns (non-fatal) on terse skill descriptions.
+
 ## [11.3.0] - 2026-07-10
 
 Single-source skill management, an upgraded `refactor` command, and two new Phase 4 diff-risk gates.

package/README.md

@@ -63,7 +63,7 @@ The discipline behind all of this — bounded loops, evidence gates, token-budge
 | Local | `/multi-agent:local "task"` | Full pipeline, current branch (no worktree) |
 | Finish | `/multi-agent:finish` | Run the review→test→commit→report tail over local work |
 
-Helpers: `setup`, `status`, `resume #N`, `review`, `test`, `channels`, `stack`, `update`, `sync`, `refactor`, `jira`, `issue`, `analysis`, `generate-task`, `generate-bug`. Full list: `/multi-agent:help`.
+Helpers: `setup`, `status`, `resume #N`, `review`, `test`, `channels`, `stack`, `update`, `sync`, `refactor`, `jira`, `issue`, `analysis`, `create-jira`. Full list: `/multi-agent:help`.
 
 ## Stacks
 

package/install/claude.mjs

@@ -105,9 +105,13 @@ function installScripts(pipelineSrc, dest, useSymlinks) {
   // removed upstream should not linger.
   wipeDir(dest);
   copyDir(scriptsSrc, dest, { exclude: DEV_ONLY_SCRIPTS, useSymlinks });
-  const scriptCount = countFiles(scriptsSrc) - DEV_ONLY_SCRIPTS.length;
+  // Count files actually excluded, not the array length: DEV_ONLY_SCRIPTS mixes
+  // individual .sh files with the `fixtures` directory (many files), so the
+  // array length under-counts the real exclusion.
+  const excludedCount = DEV_ONLY_SCRIPTS.reduce((n, name) => n + countFiles(join(scriptsSrc, name)), 0);
+  const scriptCount = countFiles(scriptsSrc) - excludedCount;
   console.log(
-    `    -> ${scriptCount} files copied to ${dest} (${DEV_ONLY_SCRIPTS.length} dev-only excluded)`,
+    `    -> ${scriptCount} files copied to ${dest} (${excludedCount} dev-only excluded)`,
   );
 }
 

package/install/copilot.mjs

@@ -119,9 +119,13 @@ function installScripts(pipelineSrc, dest, useSymlinks) {
   if (!existsSync(scriptsSrc)) return;
   wipeDir(dest);
   copyDir(scriptsSrc, dest, { exclude: DEV_ONLY_SCRIPTS, useSymlinks });
-  const scriptCount = countFiles(scriptsSrc) - DEV_ONLY_SCRIPTS.length;
+  // Count files actually excluded, not the array length: DEV_ONLY_SCRIPTS mixes
+  // individual .sh files with the `fixtures` directory (many files), so the
+  // array length under-counts the real exclusion.
+  const excludedCount = DEV_ONLY_SCRIPTS.reduce((n, name) => n + countFiles(join(scriptsSrc, name)), 0);
+  const scriptCount = countFiles(scriptsSrc) - excludedCount;
   console.log(
-    `    -> ${scriptCount} files copied to ${dest} (${DEV_ONLY_SCRIPTS.length} dev-only excluded)`,
+    `    -> ${scriptCount} files copied to ${dest} (${excludedCount} dev-only excluded)`,
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "11.3.0",
+  "version": "11.3.2",
   "description": "8-phase AI development pipeline with full orchestration on Claude Code and Copilot 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",

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

@@ -77,7 +77,7 @@ Lib scripts (`~/.claude/lib/`):
 | `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. |
 | `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. |
-| `generate ["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. |
+| `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. |
 | `test` or `test [args]` | UI Bug Hunter  -  screenshot + tap + analyze on booted simulator via MCP (read `$HOME/.claude/commands/sim-test.md`). `/multi-agent:test` also resolves here via the `commands/multi-agent/test/SKILL.md` delegate. |
 | `manual-test [#id]` | Phase 5 standalone Manual Test  -  checks out the task branch, prints Xcode / SourceTree hints, waits for user verdict (`ok` / `fix: ...`). |
 | `stack [ios\|android\|backend\|mobile\|all]` | Swap skills for next conversation. No arg = show current stack. |
@@ -117,7 +117,7 @@ This command uses lazy loading for token efficiency. Read the relevant sub-file
 | `local-autopilot` | `$HOME/.claude/commands/multi-agent/local-autopilot/SKILL.md` |
 | `dev-local` | `$HOME/.claude/commands/multi-agent/dev-local/SKILL.md` |
 | `dev-local-autopilot` | `$HOME/.claude/commands/multi-agent/dev-local-autopilot/SKILL.md` |
-| `generate` | `$HOME/.claude/commands/multi-agent/generate/SKILL.md` (loads `$HOME/.claude/multi-agent-refs/generate-issue.md`) |
+| `create-jira` | `$HOME/.claude/commands/multi-agent/create-jira/SKILL.md` (loads `$HOME/.claude/multi-agent-refs/generate-issue.md`) |
 | `stack` | `$HOME/.claude/commands/multi-agent/stack/SKILL.md` |
 | `language` | Handled inline  -  set/show prompt language in preferences |
 | SwiftUI component task (iOS) | `$HOME/.claude/multi-agent-refs/swiftui-guide.md` |

package/pipeline/commands/multi-agent/{generate → create-jira}/SKILL.md

@@ -3,7 +3,7 @@ description: "Create a standards-compliant Jira issue (Task / Bug / Story): asks
 argument-hint: "[\"<free-text description>\"] [figma-url] [swagger-url]  -  all optional, asked interactively when missing"
 ---
 
-# multi-agent generate  -  Standards-Compliant Jira Issue Creator
+# multi-agent create-jira  -  Standards-Compliant Jira Issue Creator
 
 **Input**: $ARGUMENTS
 

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

@@ -111,7 +111,7 @@ Post-Hoc & Side-Channel:
   /multi-agent:analysis ["analysis-name"]  Feature-spec analysis (Figma + Swagger + Confluence + repos) → per-platform v3 doc (23-section Full / 7-section Lite)
   /multi-agent:analysis-resolve [doc]      Resolve Section 20 open questions of an analysis doc, one at a time with source-labeled candidates
   /multi-agent:build-optimize iOS-only Xcode build perf wrapper → benchmark + analyze + recommend-first .build-benchmark/optimization-plan.md
-  /multi-agent:generate ["desc"] [figma-url] [swagger-url]  Create a Jira Task/Bug/Story matching team conventions (asks type + mining + active sprint + auto-sizing sections + preview & approval)
+  /multi-agent:create-jira ["desc"] [figma-url] [swagger-url]  Create a Jira Task/Bug/Story matching team conventions (asks type + mining + active sprint + auto-sizing sections + preview & approval)
   /multi-agent:diff-explain   Map a Phase 4 triage finding back to specific diff lines
   /multi-agent:search         Cross-task log search with smart ranking; --semantic queries triage corpus
   /multi-agent:scan           Skill security scan against tiered pattern catalog
@@ -222,8 +222,8 @@ Examples:
   /multi-agent:review
 
   # Create a Jira issue that matches team conventions (preview + approval before create)
-  /multi-agent:generate "Profile screen empty state" https://figma.com/design/abc?node-id=1-2
-  /multi-agent:generate "Login crash on iOS 17, see attached log"
+  /multi-agent:create-jira "Profile screen empty state" https://figma.com/design/abc?node-id=1-2
+  /multi-agent:create-jira "Login crash on iOS 17, see attached log"
 
 ------------------------------------------------------------
 
@@ -323,7 +323,7 @@ Post-Hoc & Side-Channel:
   /multi-agent:analysis ["analysis-name"]  Feature-spec analizi (Figma + Swagger + Confluence + repolar) → platform başına v3 doküman (23 bölüm Full / 7 bölüm Lite)
   /multi-agent:analysis-resolve [doc]      Analiz dokümanının Bölüm 20 açık sorularını kaynak etiketli adaylarla teker teker çözer
   /multi-agent:build-optimize iOS-only Xcode build performance wrapper → benchmark + analiz + recommend-first .build-benchmark/optimization-plan.md
-  /multi-agent:generate ["açıklama"] [figma-url] [swagger-url]  Takım standartlarına uygun Jira Task/Bug/Story oluştur (tip sorar + convention mining + aktif sprint + auto-sizing bölümler + önizleme & onay)
+  /multi-agent:create-jira ["açıklama"] [figma-url] [swagger-url]  Takım standartlarına uygun Jira Task/Bug/Story oluştur (tip sorar + convention mining + aktif sprint + auto-sizing bölümler + önizleme & onay)
   /multi-agent:diff-explain   Phase 4 triage bulgusunu diff satırlarına eşle
   /multi-agent:search         Task log'larında akıllı arama; --semantic triage corpus'unu sorgular
   /multi-agent:scan           Skill güvenlik taraması (tiered pattern catalog)
@@ -434,8 +434,8 @@ Quality & Telemetry (advisory, default açık  -  prefs.global.* ile kapatılabi
   /multi-agent:review
 
   # Takım standartlarına uygun Jira issue oluştur (oluşturmadan önce önizleme + onay)
-  /multi-agent:generate "Profil ekranı empty state" https://figma.com/design/abc?node-id=1-2
-  /multi-agent:generate "iOS 17'de login crash, log ekte"
+  /multi-agent:create-jira "Profil ekranı empty state" https://figma.com/design/abc?node-id=1-2
+  /multi-agent:create-jira "iOS 17'de login crash, log ekte"
 
 ------------------------------------------------------------
 

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

@@ -242,9 +242,9 @@ This runs on the Claude <-> Copilot axis — the two CLIs the pipeline supports
 **36 commands are synced** (canonical inventory  -  must match `cross-cli-contract.md` section 1; drift = contract violation):
 
 ```
-analysis, analysis-resolve, autopilot, build-optimize, channels, delete, dev,
+analysis, analysis-resolve, autopilot, build-optimize, channels, create-jira, delete, dev,
 dev-autopilot, dev-local, dev-local-autopilot, diff-explain, finish, garbage-collect,
-generate, help, issue, jira, kill, language, local,
+help, issue, jira, kill, language, local,
 local-autopilot, log, manual-test, prune-logs, purge, refactor, resume, review,
 scan, search, setup, stack, status, sync, test, update
 ```

package/pipeline/lib/credential-store.sh

@@ -105,9 +105,11 @@ do_get() {
       val=$(secret-tool lookup service "$key" 2>/dev/null || true)
       ;;
     windows)
+      # Escape single quotes for PowerShell single-quoted strings ('' = literal ').
+      local key_esc="${key//\'/\'\'}"
       val=$(ps_run "
 \$ErrorActionPreference='SilentlyContinue'
-\$c = Get-StoredCredential -Target '$key'
+\$c = Get-StoredCredential -Target '$key_esc'
 if (\$c) { \$c.GetNetworkCredential().Password }
 " 2>/dev/null | tr -d '\r' || true)
       ;;
@@ -137,11 +139,13 @@ do_set() {
       printf '%s' "$val" | secret-tool store --label="$key" service "$key" >/dev/null
       ;;
     windows)
+      # Escape single quotes for PowerShell single-quoted strings ('' = literal ').
+      local key_esc="${key//\'/\'\'}" val_esc="${val//\'/\'\'}"
       # CredentialManager module: New-StoredCredential
       ps_run "
 \$ErrorActionPreference='Stop'
-\$pwd = ConvertTo-SecureString '$val' -AsPlainText -Force
-New-StoredCredential -Target '$key' -UserName '${USER:-${USERNAME:-claude}}' -SecurePassword \$pwd -Persist LocalMachine | Out-Null
+\$pwd = ConvertTo-SecureString '$val_esc' -AsPlainText -Force
+New-StoredCredential -Target '$key_esc' -UserName '${USER:-${USERNAME:-claude}}' -SecurePassword \$pwd -Persist LocalMachine | Out-Null
 " >/dev/null
       ;;
     *)
@@ -159,7 +163,7 @@ do_delete() {
   case "$PLATFORM" in
     macos)   security delete-generic-password -s "$key" >/dev/null 2>&1 || true ;;
     linux)   secret-tool clear service "$key" >/dev/null 2>&1 || true ;;
-    windows) ps_run "Remove-StoredCredential -Target '$key' -ErrorAction SilentlyContinue" >/dev/null 2>&1 || true ;;
+    windows) local key_esc="${key//\'/\'\'}"; ps_run "Remove-StoredCredential -Target '$key_esc' -ErrorAction SilentlyContinue" >/dev/null 2>&1 || true ;;
   esac
 }
 

package/pipeline/multi-agent-refs/cross-cli-contract.md

@@ -9,9 +9,9 @@
 ## 1. Command Inventory (36 commands)
 
 ```
-analysis, analysis-resolve, autopilot, build-optimize, channels, delete, dev,
+analysis, analysis-resolve, autopilot, build-optimize, channels, create-jira, delete, dev,
 dev-autopilot, dev-local, dev-local-autopilot, diff-explain, finish, garbage-collect,
-generate, help, issue, jira, kill, language, local,
+help, issue, jira, kill, language, local,
 local-autopilot, log, manual-test, prune-logs, purge, refactor, resume, review,
 scan, search, setup, stack, status, sync, test, update
 ```
@@ -19,7 +19,7 @@ scan, search, setup, stack, status, sync, test, update
 Categories:
 
 - **Interactive pickers** (single-purpose, not modes): `jira`, `issue`
-- **Issue generator** (one-shot, no worktree, asks type Task/Bug/Story, hard approval gate before create): `generate`
+- **Issue generator** (one-shot, no worktree, asks type Task/Bug/Story, hard approval gate before create): `create-jira`
 - **Full 8-phase modes**: `autopilot`, `local`, `local-autopilot`
 - **Fast modes** (Init -> Dev(Opus) -> Commit -> Report): `dev`, `dev-autopilot`, `dev-local`, `dev-local-autopilot`
 - **Tail modes** (run the pipeline tail over already-done local work): `finish`

package/pipeline/multi-agent-refs/generate-issue.md

@@ -1,6 +1,6 @@
 # Generate Issue  -  Shared Flow (generate)
 
-> **TLDR**  -  Shared 12-step flow for `/multi-agent:generate`. Asks the issue type (Task / Bug / Story), mines the target project's existing same-type issues to learn team conventions, detects the active sprint, drafts a standards-compliant issue from a fixed standard template with auto-sizing sections, asks the user about every genuinely unknown field, renders a full preview, and creates the Jira issue only after explicit approval. Creates exactly one Jira issue per run  -  no branches, no commits, no worktrees.
+> **TLDR**  -  Shared 12-step flow for `/multi-agent:create-jira`. Asks the issue type (Task / Bug / Story), mines the target project's existing same-type issues to learn team conventions, detects the active sprint, drafts a standards-compliant issue from a fixed standard template with auto-sizing sections, asks the user about every genuinely unknown field, renders a full preview, and creates the Jira issue only after explicit approval. Creates exactly one Jira issue per run  -  no branches, no commits, no worktrees.
 
 Consumed by `generate.md`. This ref is never invoked directly.
 

package/pipeline/scripts/build-skills-index.mjs

@@ -13,8 +13,7 @@
 //   name           -  frontmatter `name:` (fallback: directory name)
 //   description    -  frontmatter `description:` (first 300 chars)
 //   platform       -  frontmatter `platform:` if set (ios / android / generic)
-//   group          -  derived from path: core / figma-ios / figma-android /
-//                    figma-common / external
+//   group          -  derived from path: core / external
 //   triggerKeywords  -  frontmatter `trigger-keywords:` (comma-separated
 //                    values lowercased)  -  authors can add these to tighten
 //                    match score. Missing → empty list.
@@ -66,9 +65,6 @@ function parseFrontmatter(raw) {
 function groupFromPath(rel) {
   if (rel.startsWith("shared/core/")) return "core";
   if (rel.startsWith("shared/external/")) return "external";
-  if (rel.startsWith("figma-ios/")) return "figma-ios";
-  if (rel.startsWith("figma-android/")) return "figma-android";
-  if (rel.startsWith("figma-common/")) return "figma-common";
   return "other";
 }
 
@@ -107,7 +103,8 @@ entries.sort((a, b) => a.name.localeCompare(b.name));
 
 const json = {
   schemaVersion: "1.0.0",
-  generatedAt: new Date().toISOString(),
+  // No generatedAt timestamp: the index is a committed build artifact and must
+  // be idempotent, so regenerating on an unchanged skill set produces no diff.
   skillCount: entries.length,
   entries,
 };

package/pipeline/scripts/eval-mine-corpus.mjs

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+// eval-mine-corpus.mjs  -  grow the triage eval set from real production runs.
+//
+// The pipeline already records every Phase 4 triage decision to
+// `~/.claude/logs/multi-agent/triage-corpus.jsonl` (one line per finding:
+// severity/file/line/issue/fix/reviewer + the classification the run gave it,
+// plus an optional human `reason`/`reviewer`). Hand-authoring eval fixtures is
+// the bottleneck; this closes the loop by turning those real decisions into
+// CANDIDATE regression fixtures in the exact shape `eval-triage.mjs` consumes.
+//
+// It is review-gated on purpose: candidates land in
+// `pipeline/eval/triage-candidates/<task_id>/` (which eval-triage does NOT
+// walk), each validated against the triage schema. A maintainer reviews them,
+// fills scope/diffSummary, and moves the good ones into
+// `pipeline/eval/triage/<NN>-<name>/` to adopt them.
+//
+// Highest-signal cases (a human left a `reason` or `reviewer`) are emitted
+// first and marked, since those encode a deliberate triage judgement.
+//
+// Usage:
+//   node pipeline/scripts/eval-mine-corpus.mjs                 # default corpus path
+//   node pipeline/scripts/eval-mine-corpus.mjs --corpus <path>
+//   node pipeline/scripts/eval-mine-corpus.mjs --limit 20      # cap candidates
+//   node pipeline/scripts/eval-mine-corpus.mjs --dry-run       # report, write nothing
+//
+// Exit codes: 0 ok (including "nothing to mine"), 2 usage/setup error.
+
+import { readdirSync, readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { spawnSync } from "node:child_process";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const root = resolve(here, "..", "..");
+const evalTriageDir = join(root, "pipeline", "eval", "triage");
+const candidatesDir = join(root, "pipeline", "eval", "triage-candidates");
+const validator = join(root, "pipeline", "scripts", "validate-triage.mjs");
+
+const args = process.argv.slice(2);
+const opts = { corpus: null, limit: Infinity, dryRun: false };
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === "--corpus") opts.corpus = args[++i];
+  else if (args[i] === "--limit") opts.limit = Number(args[++i]) || Infinity;
+  else if (args[i] === "--dry-run") opts.dryRun = true;
+  else if (args[i] === "-h" || args[i] === "--help") {
+    console.log("Usage: eval-mine-corpus.mjs [--corpus <path>] [--limit N] [--dry-run]");
+    process.exit(0);
+  }
+}
+
+const corpusPath =
+  opts.corpus || join(homedir(), ".claude", "logs", "multi-agent", "triage-corpus.jsonl");
+
+if (!existsSync(corpusPath)) {
+  console.log(`eval-mine-corpus: no corpus at ${corpusPath} - nothing to mine.`);
+  process.exit(0);
+}
+
+// Parse the JSONL corpus, skipping blank/malformed lines (never crash on data).
+const rows = [];
+for (const line of readFileSync(corpusPath, "utf-8").split("\n")) {
+  const s = line.trim();
+  if (!s) continue;
+  try {
+    const r = JSON.parse(s);
+    if (r && r.task_id && r.issue && r.classification) rows.push(r);
+  } catch {
+    /* skip malformed line */
+  }
+}
+
+if (rows.length === 0) {
+  console.log("eval-mine-corpus: corpus has no usable rows - nothing to mine.");
+  process.exit(0);
+}
+
+// task_ids that already have an adopted fixture: skip so we only propose new cases.
+const adopted = new Set();
+if (existsSync(evalTriageDir)) {
+  for (const name of readdirSync(evalTriageDir)) {
+    const inputPath = join(evalTriageDir, name, "input.json");
+    if (existsSync(inputPath)) {
+      try {
+        const meta = JSON.parse(readFileSync(join(evalTriageDir, name, "meta.json"), "utf-8"));
+        if (meta.task_id) adopted.add(meta.task_id);
+      } catch {
+        /* no meta.json -> can't dedup by task_id, that's fine */
+      }
+    }
+  }
+}
+
+// Group corpus rows by task_id.
+const byTask = new Map();
+for (const r of rows) {
+  if (!byTask.has(r.task_id)) byTask.set(r.task_id, []);
+  byTask.get(r.task_id).push(r);
+}
+
+const toFinding = (r) => ({
+  severity: r.severity,
+  file: r.file,
+  // Triage contract requires an integer line >= 0; corpus may carry null for a
+  // file-level finding, so coerce to 0 (the schema's file-level sentinel).
+  line: Number.isInteger(r.line) ? r.line : 0,
+  issue: r.issue,
+  fix: r.fix ?? null,
+  reviewer: r.reviewer ?? null,
+});
+
+// Build a candidate per task. Highest-signal first (has a human reason/reviewer).
+const candidates = [];
+for (const [taskId, findings] of byTask) {
+  if (adopted.has(taskId)) continue;
+  const rawFindings = findings.map(toFinding);
+  const accepted = [];
+  const deferred = [];
+  const rejected = [];
+  for (const r of findings) {
+    if (r.classification === "accepted") accepted.push(toFinding(r));
+    else if (r.classification === "deferred")
+      deferred.push({ finding: toFinding(r), reason: r.reason || "TODO: reason (from corpus)" });
+    else if (r.classification === "rejected")
+      rejected.push({ finding: toFinding(r), reason: r.reason || "TODO: reason (from corpus)" });
+  }
+  const hasHumanSignal = findings.some((r) => r.reason || r.reviewer);
+  const title = findings.find((f) => f.task_title)?.task_title || taskId;
+  candidates.push({
+    taskId,
+    hasHumanSignal,
+    input: {
+      rawFindings,
+      // Corpus does not record scope/diff; a maintainer fills these before adopting.
+      scope: `TODO: scope for ${title}`,
+      diffSummary: "TODO: diff summary",
+    },
+    expected: {
+      accepted,
+      deferred,
+      rejected,
+      // Blockers loop back to dev, so a run with an accepted blocker is not approved.
+      approved: accepted.every((f) => f.severity !== "blocking"),
+    },
+  });
+}
+
+candidates.sort((a, b) => Number(b.hasHumanSignal) - Number(a.hasHumanSignal));
+const selected = candidates.slice(0, opts.limit);
+
+if (selected.length === 0) {
+  console.log("eval-mine-corpus: no new task_ids to propose (all already adopted).");
+  process.exit(0);
+}
+
+let written = 0;
+let invalid = 0;
+for (const c of selected) {
+  const safe = c.taskId.replace(/[^A-Za-z0-9._-]/g, "_");
+  const dir = join(candidatesDir, safe);
+  const tag = c.hasHumanSignal ? " [human-signal]" : "";
+  if (opts.dryRun) {
+    console.log(`  would emit candidate: ${safe} (${c.input.rawFindings.length} findings)${tag}`);
+    continue;
+  }
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, "input.json"), JSON.stringify(c.input, null, 2) + "\n");
+  writeFileSync(join(dir, "expected.json"), JSON.stringify(c.expected, null, 2) + "\n");
+  writeFileSync(
+    join(dir, "meta.json"),
+    JSON.stringify({ task_id: c.taskId, source: "eval-mine-corpus", hasHumanSignal: c.hasHumanSignal }, null, 2) + "\n",
+  );
+  // Validate the emitted expected.json against the triage contract; flag if bad.
+  const res = spawnSync("node", [validator, join(dir, "expected.json")], { encoding: "utf-8" });
+  const ok = res.status === 0;
+  if (!ok) invalid++;
+  console.log(`  emitted: triage-candidates/${safe}${tag} ${ok ? "(schema OK)" : "(SCHEMA FAIL - review)"}`);
+  written++;
+}
+
+if (!opts.dryRun) {
+  console.log("");
+  console.log(`eval-mine-corpus: ${written} candidate(s) written to pipeline/eval/triage-candidates/`);
+  if (invalid > 0) console.log(`  ${invalid} failed schema validation - fix before adopting.`);
+  console.log("  Review each, fill scope/diffSummary, then move good ones into");
+  console.log("  pipeline/eval/triage/<NN>-<name>/ to add them to the eval suite.");
+}

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

@@ -6,12 +6,12 @@
 .claude/multi-agent-refs	50
 .claude/rules	12
 .claude/schemas	23
-.claude/scripts	177
+.claude/scripts	178
 .claude/settings.json	1
 .claude/skills	428
 .copilot/agents	8
 .copilot/copilot-instructions.md	1
 .copilot/lib	24
 .copilot/schemas	23
-.copilot/scripts	177
+.copilot/scripts	178
 .copilot/skills	465

package/pipeline/scripts/lint-skills.mjs

@@ -21,7 +21,11 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const repoRoot = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
-const files = execSync("find pipeline -name SKILL.md", { cwd: repoRoot, encoding: "utf-8" })
+// Scope to pipeline/skills only. Slash commands under pipeline/commands also use
+// the <name>/SKILL.md layout now, but they are command definitions
+// (description + allowed-tools, name derived from the dir), NOT skills, so the
+// skill frontmatter contract (required `name:`) does not apply to them.
+const files = execSync("find pipeline/skills -name SKILL.md", { cwd: repoRoot, encoding: "utf-8" })
   .trim()
   .split("\n")
   .filter(Boolean)
@@ -29,6 +33,10 @@ const files = execSync("find pipeline -name SKILL.md", { cwd: repoRoot, encoding
 
 const errors = [];
 const fail = (file, msg) => errors.push(`${file}: ${msg}`);
+// Non-fatal quality signals (a terse description routes poorly). Warnings never
+// fail the gate; they surface skills whose frontmatter could trigger better.
+const warnings = [];
+const warn = (file, msg) => warnings.push(`${file}: ${msg}`);
 
 for (const file of files) {
   const raw = readFileSync(join(repoRoot, file), "utf-8");
@@ -61,6 +69,18 @@ for (const file of files) {
     fail(file, "description is empty");
   } else if (fields.description.length > 1024) {
     fail(file, `description exceeds 1024 chars (${fields.description.length})`);
+  } else {
+    // Routing quality: a description of a few words rarely says what the skill
+    // does AND when to use it, so the model cannot decide to trigger it.
+    // Skip YAML block scalars (`description: |` / `>`): this line-based parser
+    // only sees the indicator, not the real multi-line text, so a word count
+    // would be a false positive.
+    const desc = fields.description;
+    const isBlockScalar = /^[|>][+-]?\d*$/.test(desc);
+    const words = desc.split(/\s+/).filter(Boolean).length;
+    if (!isBlockScalar && words < 6) {
+      warn(file, `description is terse (${words} words) - say what it does AND when to use it`);
+    }
   }
 
   if ("user-invocable" in fields && !["true", "false"].includes(fields["user-invocable"])) {
@@ -72,6 +92,11 @@ for (const file of files) {
   }
 }
 
+if (warnings.length > 0) {
+  console.warn(`lint-skills: ${warnings.length} warning(s) (non-fatal):`);
+  for (const w of warnings) console.warn("  " + w);
+}
+
 if (errors.length > 0) {
   console.error(`lint-skills: ${errors.length} error(s) across ${files.length} SKILL.md files`);
   for (const e of errors) console.error("  " + e);

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# smoke-generate-issue.sh  -  contract for /multi-agent:generate.
+# smoke-generate-issue.sh  -  contract for /multi-agent:create-jira.
 #
 # Verifies:
 #   1. All 3 files exist (1 command, shared ref, 1 Copilot/plugin SKILL.md).
@@ -16,9 +16,9 @@ set -euo pipefail
 
 HERE="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$HERE/../.." && pwd)"
-CMD="$ROOT/pipeline/commands/multi-agent/generate/SKILL.md"
+CMD="$ROOT/pipeline/commands/multi-agent/create-jira/SKILL.md"
 REF="$ROOT/pipeline/multi-agent-refs/generate-issue.md"
-SKILL="$ROOT/pipeline/skills/shared/core/multi-agent-generate/SKILL.md"
+SKILL="$ROOT/pipeline/skills/shared/core/multi-agent-create-jira/SKILL.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"
@@ -43,7 +43,7 @@ echo ""
 echo "→ 2. frontmatter keys"
 head -5 "$CMD" | grep -q '^description:' && pass "description: ${CMD##*/}" || fail "description missing: ${CMD##*/}"
 head -5 "$CMD" | grep -q '^argument-hint:' && pass "argument-hint: ${CMD##*/}" || fail "argument-hint missing: ${CMD##*/}"
-head -8 "$SKILL" | grep -q '^name: multi-agent-generate$' && pass "name: multi-agent-generate" || fail "name wrong: $SKILL"
+head -8 "$SKILL" | grep -q '^name: multi-agent-create-jira$' && pass "name: multi-agent-create-jira" || fail "name wrong: $SKILL"
 head -8 "$SKILL" | grep -q '^language: en' && pass "language en" || fail "language missing: $SKILL"
 head -8 "$SKILL" | grep -q '^user-invocable: true' && pass "user-invocable" || fail "user-invocable missing: $SKILL"
 
@@ -89,15 +89,15 @@ 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/SKILL.md" "$DISPATCHER" && pass "dispatcher loading row" || fail "dispatcher loading row missing"
+grep -Fq '| `create-jira ' "$DISPATCHER" && pass "dispatcher routing: create-jira" || fail "dispatcher routing missing: generate"
+grep -Fq "create-jira/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 -Eq '(^|[ ,])create-jira([ ,]|$)' "$CONTRACT" && pass "contract list has create-jira" || fail "contract list missing generate"
 grep -Fq "**36 commands are synced**" "$SYNC" && pass "sync count = 36" || fail "sync count wrong"
 SYNC_SKILL="$ROOT/pipeline/skills/shared/core/multi-agent-sync/SKILL.md"
 grep -Fq "**36 commands are synced**" "$SYNC_SKILL" && pass "sync SKILL count = 36" || fail "sync SKILL count wrong (Copilot parity)"
-grep -Fq "generate" "$ROOT/pipeline/skills/shared/core/multi-agent-help/SKILL.md" && pass "help SKILL lists generate" || fail "help SKILL missing generate (Copilot parity)"
-grep -c "multi-agent:generate" "$HELP" | awk '{exit !($1>=2)}' && pass "help.md has EN + TR entries" || fail "help.md entries incomplete"
+grep -Fq "create-jira" "$ROOT/pipeline/skills/shared/core/multi-agent-help/SKILL.md" && pass "help SKILL lists create-jira" || fail "help SKILL missing create-jira (Copilot parity)"
+grep -c "multi-agent:create-jira" "$HELP" | awk '{exit !($1>=2)}' && pass "help.md has EN + TR entries" || fail "help.md entries incomplete"
 # no stale split-command references anywhere in the synced surfaces
 if grep -rqE "generate-task|generate-bug" "$DISPATCHER" "$CONTRACT" "$SYNC" "$HELP" "$CMD" "$REF" "$SKILL"; then
   fail "stale generate-task/generate-bug reference found"

package/pipeline/scripts/uninstall.mjs

@@ -134,8 +134,13 @@ function stripManagedBlock(filePath) {
   const re =
     /\s*<!-- multi-agent-pipeline:begin -->[\s\S]*?<!-- multi-agent-pipeline:end -->\s*/m;
   if (!re.test(content)) {
-    // Legacy: maybe the whole file is ours (Copilot wrote it before markers)
-    if (content.includes("# Multi-Agent Development Pipeline") && content.length < 50000) {
+    // Copilot's install (install/copilot.mjs) does not wrap the block in
+    // begin/end markers; it always writes the pipeline section LAST, from the
+    // `# Multi-Agent Development Pipeline` heading to EOF, keeping any user
+    // content ABOVE it. So slicing from that heading to EOF reliably removes
+    // only our section regardless of file size (no arbitrary size cap - a cap
+    // used to orphan the block in files >50 KB).
+    if (content.includes("# Multi-Agent Development Pipeline")) {
       // Heuristic: Copilot's generateCopilotInstructions output. Only strip the
       // pipeline section, not the whole file.
       const marker = "# Multi-Agent Development Pipeline";
@@ -244,8 +249,9 @@ async function main() {
   console.log("  PRESERVED (never touched):");
   console.log("    - Personal access tokens in OS credential store (Keychain / Credential Manager / libsecret)");
   console.log("    - ~/.claude/CLAUDE.md (your customizations)");
+  console.log("    - ~/.claude/rules/ (user-owned; installed write-if-missing, never overwritten)");
   console.log("    - ~/.claude/multi-agent-preferences.json (your settings)");
-  console.log("    - User content outside <!-- multi-agent-pipeline:begin/end --> markers");
+  console.log("    - Your own content in copilot-instructions.md above the pipeline section");
   console.log("");
 
   if (!(await confirm("  Proceed? (y/N) "))) {
@@ -259,7 +265,12 @@ async function main() {
     const CLAUDE = join(HOME, ".claude");
     rmIfExists(join(CLAUDE, "commands", "multi-agent"));
     rmIfExists(join(CLAUDE, "scripts"));
-    rmIfExists(join(CLAUDE, "rules"));
+    // NOTE: ~/.claude/rules/ is USER-OWNED. install lays baseline rules down
+    // write-if-missing and NEVER overwrites them (install/claude.mjs
+    // installRules, skipExisting) so users can evolve their global rules
+    // locally. Deleting the tree here would destroy those personal edits
+    // (e.g. the git-attribution rule) -- asymmetric data loss. Leave rules
+    // in place on uninstall, exactly like CLAUDE.md and preferences.
     const skills = join(CLAUDE, "skills");
     let n = rmMatchingDirs(skills, (name) => name === "multi-agent" || name.startsWith("multi-agent-"));
     n += rmMatchingDirs(skills, (name) => name === "figma-ios" || name === "figma-android" || name === "figma-common" || name === "figma-to-component");

package/pipeline/skills/.skill-manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-09T19:01:45Z",
+  "generatedAt": "2026-07-10T13:07:43Z",
   "skillCount": 187,
   "entries": [
     {
@@ -13,11 +13,11 @@
     },
     {
       "path": "shared/core/multi-agent-analysis-resolve/SKILL.md",
-      "sha256": "53e05855937c28986e9328589ecc9e7361473bf71a548a1207c325a13da82488"
+      "sha256": "e1c400e1db0ed1c8956a9989f6232c4d45a6b9002331379a2e119b344e948622"
     },
     {
       "path": "shared/core/multi-agent-analysis/SKILL.md",
-      "sha256": "1711d118edd37fb64051f9dba3d9bf8f7a7565ff3b91e5336f547cff905d6d5b"
+      "sha256": "8d37d4d90493ccda7a39084651537fd4d28f2bdde82ecaac835d8c0f2d996363"
     },
     {
       "path": "shared/core/multi-agent-autopilot/SKILL.md",
@@ -25,11 +25,15 @@
     },
     {
       "path": "shared/core/multi-agent-build-optimize/SKILL.md",
-      "sha256": "9ffd6f8eb758c079bb6b84817023566dc46ff8a1e2d4b6f23e5ab3c0300b23dc"
+      "sha256": "0ba38c451d193063cf20e5efe6e6af1e1c738e03448d8f917259a8e2f6b2cd9b"
     },
     {
       "path": "shared/core/multi-agent-channels/SKILL.md",
-      "sha256": "d31fea96c01fb48b7dbbd496cb378593fe3b17d2ee821c093e8997fe2d4ba61f"
+      "sha256": "122792d25a2b7329af80086b6e0e563a7b8c3ec2e954ceb7e7c9dc8ea7cf71ba"
+    },
+    {
+      "path": "shared/core/multi-agent-create-jira/SKILL.md",
+      "sha256": "40caf0489ad8322cd00d792a244e772d4ddb6ccfd7c3807729d6b17590e7f81c"
     },
     {
       "path": "shared/core/multi-agent-delete/SKILL.md",
@@ -57,19 +61,15 @@
     },
     {
       "path": "shared/core/multi-agent-finish/SKILL.md",
-      "sha256": "086438494380328e3ed06c7e0ad87351c0b620d7e46dd9ff406b503c35a4ad92"
+      "sha256": "3e8e430f7aee626be96129a9d0ae6c9ac5ef0dbf80cbe580dde2d7fb5fccfed1"
     },
     {
       "path": "shared/core/multi-agent-garbage-collect/SKILL.md",
       "sha256": "24736f163e645e2bee7d552e555ae6e32cd3fc3d15c844813a75b908a58d52fd"
     },
-    {
-      "path": "shared/core/multi-agent-generate/SKILL.md",
-      "sha256": "be92e3c2599bbbab79bd4368ac8a62c55f97e49363e195926039dc2d1111324f"
-    },
     {
       "path": "shared/core/multi-agent-help/SKILL.md",
-      "sha256": "0a8da9321dcae6d5dc3be664fcaaa5c575d346d29acf39c65aea99f37a9629ba"
+      "sha256": "15755c1abd508f708e548529c869bc937f1ea038bbabb1cf47dfc3a8b0343346"
     },
     {
       "path": "shared/core/multi-agent-issue/SKILL.md",
@@ -113,7 +113,7 @@
     },
     {
       "path": "shared/core/multi-agent-refactor/SKILL.md",
-      "sha256": "bbf735fc92cd0d8577f5f9a6ec8ded7afeb6017e54be1207b79e3a2ab73a24e1"
+      "sha256": "f8a9495f6aebacba634672d6c9416046521cbdfa769746c9ff3a4a993482a85a"
     },
     {
       "path": "shared/core/multi-agent-resume/SKILL.md",
@@ -145,7 +145,7 @@
     },
     {
       "path": "shared/core/multi-agent-sync/SKILL.md",
-      "sha256": "c9459954dfd20f9b823a9ef7730baa474a1332efbbe76c92558153569c4de99b"
+      "sha256": "0ec56a2a802bbd59843bf8e9a6adfdae8c1e626ea07700914cf12e0d0c00dace"
     },
     {
       "path": "shared/core/multi-agent-test/SKILL.md",
@@ -157,7 +157,7 @@
     },
     {
       "path": "shared/core/multi-agent/SKILL.md",
-      "sha256": "0efe9bacd0e459c58260fb25e31e82d82aa73437e5c7953f680eab49484a76b3"
+      "sha256": "758646b660047bb4595528a57153afda0e1b331c70ad8c04bbd18066fc4bb336"
     },
     {
       "path": "shared/external/accessibility-compliance-accessibility-audit/SKILL.md",

package/pipeline/skills/.skills-index.json

@@ -1,6 +1,5 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-09T19:01:45.304Z",
   "skillCount": 187,
   "entries": [
     {
@@ -786,6 +785,15 @@
       "triggerPaths": [],
       "relativePath": "shared/core/multi-agent-channels/SKILL.md"
     },
+    {
+      "name": "multi-agent-create-jira",
+      "description": "Create a standards-compliant Jira issue (Task / Bug / Story): asks the type, mines project conventions, drafts from a standard template with auto-sizing sections, full preview + explicit approval before create.",
+      "platform": null,
+      "group": "core",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/core/multi-agent-create-jira/SKILL.md"
+    },
     {
       "name": "multi-agent-delete",
       "description": "Uninstall the pipeline from Claude Code + Copilot CLI. Keychain access tokens are left untouched. Asks for double confirmation.",
@@ -858,15 +866,6 @@
       "triggerPaths": [],
       "relativePath": "shared/core/multi-agent-garbage-collect/SKILL.md"
     },
-    {
-      "name": "multi-agent-generate",
-      "description": "Create a standards-compliant Jira issue (Task / Bug / Story): asks the type, mines project conventions, drafts from a standard template with auto-sizing sections, full preview + explicit approval before create.",
-      "platform": null,
-      "group": "core",
-      "triggerKeywords": [],
-      "triggerPaths": [],
-      "relativePath": "shared/core/multi-agent-generate/SKILL.md"
-    },
     {
       "name": "multi-agent-help",
       "description": "Multi-agent pipeline usage guide  -  renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatibility).",
@@ -968,7 +967,7 @@
     },
     {
       "name": "multi-agent-refactor",
-      "description": "Analyse the project, score it, draft an improvement plan, take approval, develop, then ask whether to sync.",
+      "description": "Analyse the project: extract adapted best-practices, hunt real bugs + improvement areas, check upstream drift of derived skills, draft one plan, take approval, develop, then ask whether to sync.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],

package/pipeline/skills/shared/core/{multi-agent-generate → multi-agent-create-jira}/SKILL.md

@@ -1,12 +1,12 @@
 ---
-name: multi-agent-generate
+name: multi-agent-create-jira
 language: en
 description: "Create a standards-compliant Jira issue (Task / Bug / Story): asks the type, mines project conventions, drafts from a standard template with auto-sizing sections, full preview + explicit approval before create."
 user-invocable: true
 argument-hint: "[\"<free-text description>\"] [figma-url] [swagger-url]  -  all optional, asked interactively when missing"
 ---
 
-# multi-agent generate  -  Standards-Compliant Jira Issue Creator
+# multi-agent create-jira  -  Standards-Compliant Jira Issue Creator
 
 **Input**: $ARGUMENTS
 

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

@@ -98,7 +98,7 @@ Utility Commands (dash form on Copilot, colon form on Claude Code):
   /multi-agent:purge          Worktree + logs  -  full reset (double confirm)
   /multi-agent:channels       Post multi-channel report (Jira/Confluence/Wiki/PR)
   /multi-agent:review         Review current diff only
-  /multi-agent:generate ["desc"] [figma-url] [swagger-url]  Create a Jira Task/Bug/Story matching team conventions (asks type + preview + approval)
+  /multi-agent:create-jira ["desc"] [figma-url] [swagger-url]  Create a Jira Task/Bug/Story matching team conventions (asks type + preview + approval)
   /multi-agent:sync           Sync ecosystem (Claude + Copilot + website)
   /multi-agent:setup          Keychain tokens + Git identity + language onboarding
   /multi-agent:language [en|tr]  Show or set prompt language
@@ -234,7 +234,7 @@ Utility Komutları:
   /multi-agent:purge          Worktree + log'lar  -  tam reset (çift onay)
   /multi-agent:channels       Multi-channel rapor gönder (Jira/Confluence/Wiki/PR)
   /multi-agent:review         Sadece mevcut diff'i review et
-  /multi-agent:generate ["açıklama"] [figma-url] [swagger-url]  Takım standartlarına uygun Jira Task/Bug/Story oluştur (tip sorar + önizleme + onay)
+  /multi-agent:create-jira ["açıklama"] [figma-url] [swagger-url]  Takım standartlarına uygun Jira Task/Bug/Story oluştur (tip sorar + önizleme + onay)
   /multi-agent:sync           Ekosistemi senkronize et
   /multi-agent:setup          Keychain token + Git kimliği + dil onboarding
   /multi-agent:language [en|tr]  Prompt dilini göster veya ayarla

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

@@ -139,9 +139,9 @@ When invoked with the `release` argument:
 **36 commands are synced** (canonical inventory  -  must match `cross-cli-contract.md` section 1; drift = contract violation):
 
 ```
-analysis, analysis-resolve, autopilot, build-optimize, channels, delete, dev,
+analysis, analysis-resolve, autopilot, build-optimize, channels, create-jira, delete, dev,
 dev-autopilot, dev-local, dev-local-autopilot, diff-explain, finish, garbage-collect,
-generate, help, issue, jira, kill, language, local,
+help, issue, jira, kill, language, local,
 local-autopilot, log, manual-test, prune-logs, purge, refactor, resume, review,
 scan, search, setup, stack, status, sync, test, update
 ```

package/pipeline/skills/skills-index.md

@@ -94,6 +94,7 @@
 | core | `multi-agent-autopilot` |  -  | Launch any task in autopilot mode: skips every confirmation, runs end-to-end autonomously. |
 | core | `multi-agent-build-optimize` |  -  | Wrapper that dispatches to xcode-build-orchestrator on iOS repos. Benchmarks the current Xcode build, runs compilation / project / SPM analy |
 | core | `multi-agent-channels` |  -  | Multi-channel reporter  -  Jira/Confluence/Wiki/PR description. Multi-select channels + content, humanizer pass, reviewer-preserving Bitbuck |
+| core | `multi-agent-create-jira` |  -  | Create a standards-compliant Jira issue (Task / Bug / Story): asks the type, mines project conventions, drafts from a standard template with |
 | core | `multi-agent-delete` |  -  | Uninstall the pipeline from Claude Code + Copilot CLI. Keychain access tokens are left untouched. Asks for double confirmation. |
 | core | `multi-agent-dev` |  -  | Fast development mode: Init → Dev (Opus) → Test → Commit → Report. Analysis, planning, and review phases are skipped. |
 | core | `multi-agent-dev-autopilot` |  -  | Fastest mode: Dev (Opus) plus Autopilot. Init → Dev → Commit → Report with zero confirmations. |
@@ -102,7 +103,6 @@
 | core | `multi-agent-diff-explain` |  -  | Map Phase 4 triage findings to branch diff lines. Read-only post-hoc command, used after review to answer 'which finding lines up with which |
 | core | `multi-agent-finish` |  -  | Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenari |
 | core | `multi-agent-garbage-collect` |  -  | Sweep leftover /tmp scratch (picker state, review diffs, channel payloads, analysis drafts) from past runs. Dry-run first; confirms before d |
-| core | `multi-agent-generate` |  -  | Create a standards-compliant Jira issue (Task / Bug / Story): asks the type, mines project conventions, drafts from a standard template with |
 | core | `multi-agent-help` |  -  | Multi-agent pipeline usage guide  -  renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatib |
 | core | `multi-agent-issue` |  -  | List unassigned GitHub issues, pick one, auto-assign, and launch the multi-agent pipeline. |
 | core | `multi-agent-jira` |  -  | List open Jira issues, pick one, and launch the multi-agent pipeline. |
@@ -114,7 +114,7 @@
 | core | `multi-agent-manual-test` |  -  | Switch to the active task's branch and prepare it for manual testing in Xcode. Phase 5 standalone (the UI Bug Hunter lives at multi-agent-te |
 | core | `multi-agent-prune-logs` |  -  | Delete per-task project logs under ~/.claude/logs/multi-agent (filter by age/project/task). Audit trail + metrics are preserved. Dry-run fir |
 | core | `multi-agent-purge` |  -  | ⚠️ Wipes every worktree, branch, log, and state file. Irreversible; asks for double confirmation. |
-| core | `multi-agent-refactor` |  -  | Analyse the project, score it, draft an improvement plan, take approval, develop, then ask whether to sync. |
+| core | `multi-agent-refactor` |  -  | Analyse the project: extract adapted best-practices, hunt real bugs + improvement areas, check upstream drift of derived skills, draft one p |
 | core | `multi-agent-resume` |  -  | Resume a stopped or failed task from the phase where it left off. |
 | core | `multi-agent-review` |  -  | Run parallel review on the current branch's diff: 2 models on Claude Code (Fable + Sonnet), 3 models on Copilot CLI (GPT + Opus + Sonnet). R |
 | core | `multi-agent-scan` |  -  | Skill security scan: walks local skill directories against a tiered pattern catalog. |