@mmerterden/multi-agent-pipeline 11.4.0 → 12.0.0

package/install/copilot.mjs

@@ -22,7 +22,9 @@ import {
   copyFile,
   countFiles,
   ensureDir,
+  ensureRealDir,
   isDryRun,
+  removePipelineAgentFiles,
   wipeDir,
   writeFile,
 } from "./_common.mjs";
@@ -61,17 +63,55 @@ export function installCopilot(ctx) {
   installSkills({ pipelineSrc, dest: COPILOT_SKILLS, indexOnly, useSymlinks, platformFlag });
 }
 
+/** Start of the pipeline-managed span in copilot-instructions.md. */
+export const INSTRUCTIONS_START_MARKER = "# Multi-Agent Development Pipeline";
+
+/**
+ * Explicit end marker written after the pipeline section (v11.4.1+). Updates
+ * replace only the start..end span, so anything the user appends AFTER the
+ * pipeline section survives. Pre-marker files fall back to
+ * `legacyTrailingContent` bounding.
+ */
+export const INSTRUCTIONS_END_MARKER =
+  "<!-- multi-agent-pipeline:copilot-instructions:end -->";
+
+/**
+ * Legacy files (written before the end marker existed) have no explicit
+ * terminator. Bound the pipeline span at the next top-level "# " heading
+ * after the start marker when one exists OUTSIDE fenced code blocks (the
+ * pipeline body carries bash comments like "# Bootstrap once ..." inside
+ * fences that must not be mistaken for headings); otherwise the span runs
+ * to EOF, which matches the pre-marker behavior.
+ *
+ * @param {string} section - file content from the start marker onward
+ * @returns {string} user content trailing the pipeline span ("" if none)
+ */
+export function legacyTrailingContent(section) {
+  const lines = section.split("\n");
+  let inFence = false;
+  for (let i = 1; i < lines.length; i++) {
+    if (/^\s*(```|~~~)/.test(lines[i])) {
+      inFence = !inFence;
+      continue;
+    }
+    if (!inFence && /^# /.test(lines[i])) return lines.slice(i).join("\n");
+  }
+  return "";
+}
+
 function writeInstructionsFile(path) {
   const pipelineSection = generateCopilotInstructions();
+  const managedBlock =
+    pipelineSection.trimEnd() + "\n\n" + INSTRUCTIONS_END_MARKER + "\n";
 
   if (!existsSync(path)) {
-    writeFile(path, pipelineSection + "\n");
+    writeFile(path, managedBlock);
     console.log("    -> Created copilot-instructions.md with pipeline");
     return;
   }
 
   let existing = readFileSync(path, "utf-8");
-  const marker = "# Multi-Agent Development Pipeline";
+  const marker = INSTRUCTIONS_START_MARKER;
 
   // Drift cleanup (v5.6.2): detect pre-v5.0 pipeline sections that predate
   // the stable marker and strip them. These blocks ("## Multi-Agent Task
@@ -103,12 +143,26 @@ function writeInstructionsFile(path) {
   }
 
   if (existing.includes(marker)) {
-    const before = existing.split(marker)[0].trimEnd();
-    writeFile(path, before + "\n\n" + pipelineSection + "\n");
+    const startIdx = existing.indexOf(marker);
+    const before = existing.slice(0, startIdx).trimEnd();
+    const fromStart = existing.slice(startIdx);
+    // Replace only the start..end span. User content appended AFTER the
+    // pipeline section (below the end marker, or below the next top-level
+    // heading in legacy files) is preserved.
+    const endIdx = fromStart.indexOf(INSTRUCTIONS_END_MARKER);
+    const trailing =
+      endIdx >= 0
+        ? fromStart.slice(endIdx + INSTRUCTIONS_END_MARKER.length)
+        : legacyTrailingContent(fromStart);
+    let out = before.length > 0 ? before + "\n\n" : "";
+    out += managedBlock;
+    const trailingClean = trailing.replace(/^[\r\n]+/, "").trimEnd();
+    if (trailingClean.length > 0) out += "\n" + trailingClean + "\n";
+    writeFile(path, out);
     const suffix = cleaned ? " (also scrubbed pre-v5.0 drift section)" : "";
     console.log(`    -> Updated existing pipeline section in copilot-instructions.md${suffix}`);
   } else {
-    writeFile(path, existing.trimEnd() + "\n\n" + pipelineSection + "\n");
+    writeFile(path, existing.trimEnd() + "\n\n" + managedBlock);
     console.log("    -> Appended pipeline section to copilot-instructions.md");
   }
 }
@@ -117,6 +171,9 @@ function installScripts(pipelineSrc, dest, useSymlinks) {
   console.log("  [Copilot CLI] Installing scripts...");
   const scriptsSrc = join(pipelineSrc, "scripts");
   if (!existsSync(scriptsSrc)) return;
+  // Replace a --link-era symlink with a real dir before wiping/copying so the
+  // install can never land inside the developer's repo checkout.
+  if (!useSymlinks) ensureRealDir(dest);
   wipeDir(dest);
   copyDir(scriptsSrc, dest, { exclude: DEV_ONLY_SCRIPTS, useSymlinks });
   // Count files actually excluded, not the array length: DEV_ONLY_SCRIPTS mixes
@@ -133,7 +190,13 @@ function installAgents(pipelineSrc, dest, useSymlinks) {
   console.log("  [Copilot CLI] Installing agent definitions...");
   const agentsSrc = join(pipelineSrc, "agents");
   if (!existsSync(agentsSrc)) return;
-  wipeDir(dest);
+  // ~/.copilot/agents also holds user-authored agent files. Never wipe the
+  // whole dir; remove only the pipeline-shipped agent files (name set derived
+  // from the source tree so it cannot go stale), then copy the fresh set in.
+  if (!useSymlinks) {
+    ensureRealDir(dest);
+    removePipelineAgentFiles(dest, agentsSrc);
+  }
   copyDir(agentsSrc, dest, { useSymlinks });
   console.log(`    -> ${countFiles(agentsSrc)} files copied to ${dest}`);
 }
@@ -142,6 +205,7 @@ function installSchemas(pipelineSrc, dest, useSymlinks) {
   console.log("  [Copilot CLI] Installing JSON schemas...");
   const schemasSrc = join(pipelineSrc, "schemas");
   if (!existsSync(schemasSrc)) return;
+  if (!useSymlinks) ensureRealDir(dest);
   wipeDir(dest);
   copyDir(schemasSrc, dest, { useSymlinks });
   console.log(`    -> ${countFiles(schemasSrc)} files copied to ${dest}`);
@@ -151,6 +215,7 @@ function installLib(pipelineSrc, dest, useSymlinks) {
   console.log("  [Copilot CLI] Installing shell libraries...");
   const libSrc = join(pipelineSrc, "lib");
   if (!existsSync(libSrc)) return;
+  if (!useSymlinks) ensureRealDir(dest);
   wipeDir(dest);
   copyDir(libSrc, dest, { useSymlinks });
   console.log(`    -> ${countFiles(libSrc)} files copied to ${dest}`);
@@ -160,6 +225,10 @@ function installSkills(opts) {
   const { pipelineSrc, dest, indexOnly, useSymlinks, platformFlag } = opts;
   console.log("  [Copilot CLI] Installing skills...");
 
+  // Same symlink guard as the other owned trees: never prune or copy through
+  // a --link-era symlink into the repo checkout.
+  if (!useSymlinks) ensureRealDir(dest);
+
   if (indexOnly) {
     try {
       mkdirSync(dest, { recursive: true });

package/install/index.mjs

@@ -11,9 +11,12 @@
 import { dirname } from "path";
 import { fileURLToPath } from "url";
 
+import { readFileSync } from "fs";
+import { join } from "path";
+
 import { installClaude } from "./claude.mjs";
 import { installCopilot } from "./copilot.mjs";
-import { setDryRun } from "./_common.mjs";
+import { setDryRun, writeFile } from "./_common.mjs";
 import { sendInstallTelemetry } from "./_telemetry.mjs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -95,6 +98,10 @@ export async function runInstall(argv) {
   if (forClaude) installClaude(installerCtx);
   if (forCopilot) installCopilot(installerCtx);
 
+  // Version marker: update-check.sh falls back to this for npx-only installs
+  // that have no pipeline repo clone to read a version from.
+  writeVersionMarkers({ home: HOME, forClaude, forCopilot });
+
   if (dryRun) {
     console.log("");
     console.log("  Dry-run complete — nothing was written. Re-run without --dry-run to install.");
@@ -108,6 +115,32 @@ export async function runInstall(argv) {
   sendInstallTelemetry({ packageRoot: PIPELINE_ROOT, flags });
 }
 
+/**
+ * Stamp the installed package version into each target so the advisory
+ * update check works without a repo clone. Failure is non-fatal.
+ *
+ * @param {{home: string, forClaude: boolean, forCopilot: boolean}} opts
+ */
+export function writeVersionMarkers({ home, forClaude, forCopilot }) {
+  let version;
+  try {
+    version = JSON.parse(readFileSync(join(PIPELINE_ROOT, "package.json"), "utf-8")).version;
+  } catch {
+    return;
+  }
+  if (!version) return;
+  const targets = [];
+  if (forClaude) targets.push(join(home, ".claude", ".pipeline-version"));
+  if (forCopilot) targets.push(join(home, ".copilot", ".pipeline-version"));
+  for (const target of targets) {
+    try {
+      writeFile(target, `${version}\n`);
+    } catch {
+      // advisory only - never fail the install over the marker
+    }
+  }
+}
+
 /**
  * @param {string[]} flags
  * @returns {"ios"|"android"|"all"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "11.4.0",
+  "version": "12.0.0",
   "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",
@@ -18,7 +18,8 @@
     "test:unit": "node --test test/*.test.mjs",
     "test:smoke": "node pipeline/scripts/run-smokes.mjs",
     "lint:skills": "node pipeline/scripts/lint-skills.mjs",
-    "test:coverage": "c8 --reporter=text --reporter=lcov node --test test/*.test.mjs && c8 report",
+    "test:quick": "node --test test/*.test.mjs && node pipeline/scripts/lint-skills.mjs",
+    "test:coverage": "c8 --check-coverage --reporter=text --reporter=lcov node --test test/*.test.mjs && c8 report",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write \"**/*.{js,mjs,json,md,yml}\" --ignore-path .gitignore",
@@ -69,17 +70,10 @@
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
-    "!pipeline/scripts/figma-placeholder-map.json",
-    "!pipeline/scripts/sync-figma-source.sh",
-    "!pipeline/scripts/import-figma-skills.sh",
-    "!pipeline/scripts/smoke-figma-skill-import.sh",
     "!pipeline/scripts/smoke-figma-config-schema.sh",
     "!pipeline/scripts/smoke-personal-data.sh",
     "!pipeline/scripts/smoke-install-leak-gate.sh",
-    "!pipeline/scripts/README-figma-smokes.md",
-    "!pipeline/scripts/.last-figma-sync-plan.json",
-    "!docs/GENERICITY-REVIEW.md",
-    "!docs/STABILITY-FIX-PLAN.md"
+    "!docs/internal/**"
   ],
   "devDependencies": {
     "@eslint/js": "^10.0.1",

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

@@ -1,5 +1,6 @@
 ---
 description: "Task orchestrator  -  full pipeline via Jira ID + branch or GitHub Issue URL: analysis, plan, TDD development, parallel review + Fable triage (CLI-aware: 2-model on Claude Code, 3-model on Copilot CLI), commit, log"
+description-tr: "Görev orkestratörü - Jira ID + branch veya GitHub Issue URL ile tam pipeline: analiz, plan, TDD geliştirme, paralel review + Fable triyajı (CLI'ya göre: Claude Code'da 2, Copilot CLI'da 3 model), commit, log"
 allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, WebFetch, WebSearch, NotebookEdit, Skill
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Standalone feature-spec analysis. Platform-agnostic concept layer with repo-driven convention extraction (Phase 1c) and per-platform Pass B render. 23 main sections + 3 footer in Full mode; 7 sections in Lite mode (auto for small features). Collects Figma / Swagger / Confluence / Jira / Standards (Confluence + Wiki + local file) / Firebase / repo inputs. Stops after emit - does not chain into /multi-agent:dev."
+description-tr: "Bağımsız özellik-spesifikasyonu analizi. Repo'dan konvansiyon çıkarımıyla (Faz 1c) platform-bağımsız kavram katmanı ve platform başına Pass B render. Full modda 23 ana + 3 dipnot bölümü; Lite modda 7 bölüm (küçük işlerde otomatik). Figma / Swagger / Confluence / Jira / Standartlar (Confluence + Wiki + yerel dosya) / Firebase / repo girdilerini toplar. Çıktıyı üretince durur - /multi-agent:dev'e zincirlenmez."
 argument-hint: "[\"<analysis-name>\"] [--lite | --full] [--no-cache] [--preview-conventions]"
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Resolve the Section 20 Risks and Open Questions of an analysis v3 document one row at a time. Proposes up to 3 source-labeled answer candidates per row (from evidence / from repo / AI reasoned), merges the chosen answer into the target body section, and updates the doc in place with a Section 23 changelog bump. Companion to /multi-agent:analysis - same Locked decisions apply (citation discipline, humanizer punctuation, no MCP, no auto-commit). Optional sibling propagation for per-platform file sets."
+description-tr: "Analiz v3 dokümanının Bölüm 20 Riskler ve Açık Sorular satırlarını tek tek çözer. Satır başına en fazla 3 kaynak-etiketli cevap adayı önerir (kanıttan / repodan / AI çıkarımı), seçilen cevabı ilgili gövde bölümüne işler ve dokümanı Bölüm 23 changelog artışıyla yerinde günceller. /multi-agent:analysis'in eşlikçisi - aynı Kilitli kararlar geçerli (alıntı disiplini, humanizer noktalama, MCP yok, otomatik commit yok). Platform bazlı dosya setleri için isteğe bağlı kardeş yayılımı."
 argument-hint: "[path/to/analysis/<feature>-<platform>.md] [--autonomous]"
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Launch any task in autopilot mode: skips every confirmation, runs end-to-end autonomously."
+description-tr: "Herhangi bir görevi autopilot modunda başlatır: tüm onayları atlar, uçtan uca otonom çalışır."
 argument-hint: '"task"  -  issue URL, Jira ID, free-text, or #id (for resume)'
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Thin wrapper that dispatches to xcode-build-orchestrator on iOS projects. Benchmarks current Xcode build, runs compilation / project / SPM analyzers, produces a recommend-first optimization plan, and re-benchmarks after the developer approves changes."
+description-tr: "iOS projelerinde xcode-build-orchestrator'a delege eden ince sarmalayıcı. Mevcut Xcode build'ini ölçer, derleme / proje / SPM analizlerini koşar, önce-öneri yaklaşımlı bir optimizasyon planı üretir ve geliştirici onayından sonra yeniden ölçer."
 argument-hint: "(none - operates on current repo)"
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Multi-channel reporter  -  Jira/Confluence/Wiki/PR description/Board status. Multi-select channels + content, humanizer pass, reviewer-preserving Bitbucket PR PUT, GitHub Projects v2 board status move. Phase 7 delegates to this skill; users can invoke post-hoc by Jira ID / PR URL / branch."
+description-tr: "Çok kanallı raporlayıcı - Jira/Confluence/Wiki/PR açıklaması/Board durumu. Çoklu kanal + içerik seçimi, humanizer geçişi, reviewer'ı koruyan Bitbucket PR PUT, GitHub Projects v2 board durum taşıma. Faz 7 bu skill'e delege eder; Jira ID / PR URL / branch ile sonradan da çağrılabilir."
 argument-hint: '<Jira-id | PR-url | #N | Jira-url> [--channels pr,jira,confluence,wiki,board] [--content normal,technical,test,auto-diff,note] [--message "..."] [--message-file path] [--board-status <key>] [--dry-run] [--append] [--ready]'
 allowed-tools: Read, Write, Edit, Bash, Grep, WebFetch, AskUserQuestion
 ---

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

@@ -1,5 +1,6 @@
 ---
 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."
+description-tr: "Standartlara uygun Jira issue oluşturur (Task / Bug / Story): türü sorar, proje konvansiyonlarını çıkarır, otomatik boyutlanan bölümlerle standart şablondan taslak hazırlar, oluşturmadan önce tam önizleme + açık onay alır."
 argument-hint: "[\"<free-text description>\"] [figma-url] [swagger-url]  -  all optional, asked interactively when missing"
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Fast development mode: Init → Dev (Opus) → Test → Commit → Report. Analysis, planning, and review phases are skipped."
+description-tr: "Hızlı geliştirme modu: Init → Dev (Opus) → Test → Commit → Report. Analiz, planlama ve review fazları atlanır."
 ---
 
 # multi-agent dev  -  Fast Development Mode (--dev)

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

@@ -1,5 +1,6 @@
 ---
 description: "Fastest mode: Dev (Opus) plus Autopilot. Init → Dev → Commit → Report with zero confirmations."
+description-tr: "En hızlı mod: Dev (Opus) + Autopilot. Init → Dev → Commit → Report, sıfır onay."
 ---
 
 # multi-agent dev autopilot  -  Fastest Path

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

@@ -1,5 +1,6 @@
 ---
 description: "Fast mode + local  -  Init → Dev(Opus) → Commit → Report, no worktree."
+description-tr: "Hızlı mod + lokal - Init → Dev(Opus) → Commit → Report, worktree yok."
 allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, WebFetch, Skill
 ---
 
@@ -20,7 +21,7 @@ Phase 7: Report     → Jira / Wiki + log + knowledge/memory
 
 `--dev local` skips Phase 1 (Analysis), Phase 2 (Planning + Approval Gate), Phase 4 (Review), and Phase 5 (User Test  -  local/autopilot variants skip the interactive test gate). It differs from `--dev` on two axes: no git worktree is created (development happens directly on the current branch in `$PROJECT_ROOT`), and the interactive User Test phase is skipped.
 
-> **Want the quality tail afterwards?** Since this mode skips Review + Test, run [`/multi-agent:finish`](./finish.md) on the same branch when you're done to add parallel review, a build+test success gate, PR, and a Jira technical-analysis + test-scenario comment  -  without re-developing.
+> **Want the quality tail afterwards?** Since this mode skips Review + Test, run [`/multi-agent:finish`](../finish/SKILL.md) on the same branch when you're done to add parallel review, a build+test success gate, PR, and a Jira technical-analysis + test-scenario comment  -  without re-developing.
 
 ## When to use it
 

package/pipeline/commands/multi-agent/dev-local-autopilot/SKILL.md

@@ -1,5 +1,6 @@
 ---
 description: "Fastest + local  -  Dev(Opus) + autopilot, no worktree, zero interaction."
+description-tr: "En hızlı + lokal - Dev(Opus) + autopilot, worktree yok, sıfır etkileşim."
 allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet, WebFetch, Skill
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "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 code change'."
+description-tr: "Faz 4 triyaj bulgularını branch diff satırlarına eşler. Review sonrası kullanılan salt-okunur komut: hangi bulgu hangi kod değişikliğine denk geliyor sorusunu cevaplar."
 argument-hint: "[#task-id | --triage <path> | --state <path>] [--branch <name>] [--base <name>]"
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenario comment). No dev phase."
+description-tr: "Halihazırda bitmiş LOKAL işi pipeline kuyruğundan geçirir: Review → Build+Test → Commit/PR → Report (teknik analiz + Jira test-senaryosu yorumu). Dev fazı yok."
 allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, WebFetch, WebSearch, Skill
 ---
 

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

@@ -1,5 +1,6 @@
 ---
-description: "Sweep leftover /tmp scratch (picker state, review diffs, channel payloads, analysis drafts) from past runs. Dry-run first; confirms before deleting."
+description: "Sweep leftover /tmp scratch (picker state, review diffs, channel payloads, analysis drafts) and worktree residue (orphan .worktrees dirs, gitlink index entries) from past runs. Dry-run first; confirms before deleting."
+description-tr: "Geçmiş çalışmalardan kalan /tmp scratch'ini (picker durumu, review diff'leri, kanal payload'ları, analiz taslakları) ve worktree kalıntılarını (sahipsiz .worktrees klasörleri, gitlink index kayıtları) süpürür. Önce dry-run; silmeden önce onay alır."
 argument-hint: "[--older-than=<minutes>] [--yes]  -  dry-run unless confirmed"
 ---
 
@@ -48,11 +49,36 @@ deletes nothing until you confirm.
 5. **Report**  -  echo the `══ garbage-collect: removed N item(s), freed ~X ══`
    summary line.
 
+6. **Worktree residue sweep (second phase)**  -  when the current directory is
+   a git repo, also preview worktree leftovers:
+
+   ```bash
+   bash $HOME/.claude/scripts/gc-worktrees.sh ${ARGUMENTS}
+   ```
+
+   This covers: stale worktree admin entries (`git worktree prune`, applied
+   immediately  -  it only drops bookkeeping for dirs that are already gone),
+   orphan `.worktrees/*` dirs no longer registered as worktrees, gitlink
+   residue in the index (`.worktrees/{id}` recorded as a "Subproject commit"
+   entry by a pre-guard `git add -A`), and a missing `.worktrees/` line in
+   `.git/info/exclude`. Registered, healthy worktrees are NEVER touched  -
+   those belong to `/multi-agent:finish` / `/multi-agent:kill`.
+
+   - Output says `nothing to do` -> skip silently, no question.
+   - Otherwise surface a second `AskUserQuestion` (in `outputLanguage`):
+     `question`: "Apply the listed worktree cleanups?" (include the dry-run
+     lines), `header`: "Worktrees", options `{ label: "Apply cleanups" }` /
+     `{ label: "Cancel", description: "Keep everything, change nothing" }`.
+   - On confirm, re-run with `--yes` and echo its summary line. If a gitlink
+     was unstaged, remind the user the removal still needs a commit.
+
 ## Notes
 
 - An in-flight analysis keeps its drafts in `/tmp/analysis-<slug>-<timestamp>/`
   and `/multi-agent:resume` re-uses them. If a run is paused at
   `awaiting_output_decision`, pass `--older-than=<minutes>` so fresh drafts are
   spared, or finish the run first.
-- This only touches `/tmp` scratch. Persistent per-task logs live under
-  `~/.claude/logs/multi-agent/` and are cleaned by `/multi-agent:prune-logs`.
+- The /tmp phase only touches `/tmp` scratch; the worktree phase only touches
+  the current repo's `.worktrees/` residue and index. Persistent per-task logs
+  live under `~/.claude/logs/multi-agent/` and are cleaned by
+  `/multi-agent:prune-logs`.

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

@@ -1,5 +1,6 @@
 ---
 description: "Multi-agent pipeline usage guide  -  renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatibility)."
+description-tr: "Multi-agent pipeline kullanım kılavuzu - prefs.global.outputLanguage'e göre EN veya TR render edilir (geriye uyumluluk için promptLanguage'e düşer)."
 ---
 
 # multi-agent help
@@ -126,7 +127,7 @@ Setup & Maintenance:
   /multi-agent:stack <id>     Select stack by enabling the matching marketplace plugin(s) (ios / android / mobile / backend / frontend / fullstack / all)
   /multi-agent:sync           Sync ecosystem (Claude Code + Copilot CLI + pipeline + website)
   /multi-agent:update         Pull latest pipeline + reinstall + run migrations
-  /multi-agent:delete         Uninstall pipeline from every CLI (Keychain tokens left intact, double confirm)
+  /multi-agent:uninstall      Uninstall pipeline from every CLI (--all-data also clears settings + logs; Keychain tokens always intact, double confirm)
 
 ------------------------------------------------------------
 
@@ -340,7 +341,7 @@ Setup & Maintenance:
   /multi-agent:stack <id>         Stack'i eşleşen marketplace plugin'i etkinleştirerek seç (ios / android / mobile / backend / frontend / fullstack / all)
   /multi-agent:sync               Ekosistemi senkronize et (Claude Code + Copilot CLI + pipeline + website)
   /multi-agent:update             En son pipeline'ı çek + reinstall + migration çalıştır
-  /multi-agent:delete             Pipeline'ı tüm CLI'lerden kaldır (Keychain token dokunulmaz, çift onay)
+  /multi-agent:uninstall          Pipeline'ı tüm CLI'lerden kaldır (--all-data ayar + logları da siler; Keychain token her zaman dokunulmaz, çift onay)
 
 ------------------------------------------------------------
 

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

@@ -1,5 +1,6 @@
 ---
 description: "List unassigned GitHub issues, pick one, auto-assign, and launch the multi-agent pipeline."
+description-tr: "Atanmamış GitHub issue'larını listeler, birini seçtirir, otomatik atar ve multi-agent pipeline'ı başlatır."
 argument-hint: "[autopilot]  -  optional: run the pipeline without confirmations"
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "List open Jira issues, pick one, and launch the multi-agent pipeline."
+description-tr: "Açık Jira issue'larını listeler, birini seçtirir ve multi-agent pipeline'ı başlatır."
 argument-hint: "[autopilot]  -  optional: run the pipeline without confirmations"
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Stop the given task, then remove its worktree and branch. Asks for confirmation."
+description-tr: "Verilen görevi durdurur, ardından worktree'sini ve branch'ini kaldırır. Onay ister."
 argument-hint: "#id  -  task ID to delete (e.g. #2)"
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Toggle outputLanguage (assistant explanations). promptLanguage is fixed to English. External payloads stay English."
+description-tr: "outputLanguage'i değiştirir (asistan açıklamaları). promptLanguage İngilizce sabittir. Dış payload'lar İngilizce kalır."
 argument-hint: "[en|tr]  -  sets outputLanguage; omit for interactive picker; use 'output en|tr' for explicit form"
 ---
 
@@ -16,7 +17,9 @@ Two-axis language preference for the pipeline:
 
 **Why promptLanguage is fixed:** Pipeline picker UI, confirmation prompts, and error messages are authored in English to keep tooling consistent across CLIs. Mixing Turkish prompts into otherwise-English skill output looks inconsistent. Only the assistant's free-form replies follow `outputLanguage`.
 
-**Always English regardless of either field**: commit messages, PR titles/bodies, Jira comments, wiki pages, reviewer/triage system prompts, agent-log.md payloads, skill-picker / confirmation / error UI exposed by the CLI host.
+**Always English regardless of either field**: commit messages, PR titles/bodies, Jira comments, wiki pages, reviewer/triage system prompts, agent-log.md payloads, confirmation / error UI exposed by the CLI host.
+
+**Follows outputLanguage (localized at install/toggle time)**: the slash-command picker `description` shown by the CLI host autocomplete. Repo and npm files always keep the English `description:`; files shipping a `description-tr:` line get swapped in the INSTALLED `~/.claude/commands/multi-agent/` tree by `localize-commands.mjs` (reversible via a `description-en:` sidecar). `/multi-agent:sync` restores English before mirroring back to the repo.
 
 ## Invocations
 
@@ -73,6 +76,22 @@ jq --arg ol "$NEW_OUTPUT" '
 ' "$PREFS" > "$TMP" && mv "$TMP" "$PREFS"
 ```
 
+### Localize picker descriptions
+
+After a successful write, swap the installed command descriptions to match the
+new outputLanguage (repo files are never touched; the swap is reversible):
+
+```bash
+if [ "$NEW_OUTPUT" = "tr" ]; then
+  node "$HOME/.claude/scripts/localize-commands.mjs" apply
+else
+  node "$HOME/.claude/scripts/localize-commands.mjs" restore
+fi
+```
+
+Note: the CLI host caches the picker list per session; descriptions refresh on
+the next session start.
+
 ### Confirmation echo
 
 Render in the **new** outputLanguage:

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

@@ -1,5 +1,6 @@
 ---
 description: "Full pipeline in local mode  -  no worktree, runs directly on the current branch."
+description-tr: "Tam pipeline lokal modda - worktree yok, doğrudan mevcut branch üzerinde çalışır."
 allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, WebFetch, WebSearch, Skill
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Full pipeline + local + autopilot  -  no worktree, no confirmations; runs 7 phases (User Test skipped) end-to-end on the current branch."
+description-tr: "Tam pipeline + lokal + autopilot - worktree yok, onay yok; 7 fazı (Kullanıcı Testi atlanır) mevcut branch üzerinde uçtan uca koşar."
 argument-hint: '"task"  -  issue URL, Jira ID, free-text, or #id (for resume)'
 allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, WebFetch, WebSearch, Skill
 ---

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

@@ -1,5 +1,6 @@
 ---
 description: "Show the agent-log.md for the given task. With no ID, shows the most recent task."
+description-tr: "Verilen görevin agent-log.md dosyasını gösterir. ID verilmezse en son görevi gösterir."
 argument-hint: "[#id]  -  optional: task ID (e.g. #3). If omitted, the most recent task is used."
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "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:test)."
+description-tr: "Aktif görevin branch'ine geçer ve Xcode'da manuel test için hazırlar. Faz 5'in bağımsız hali (UI Bug Hunter /multi-agent:test'te)."
 ---
 
 # multi-agent manual-test  -  Phase 5 Manual Test Mode

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

@@ -1,5 +1,6 @@
 ---
 description: "Delete per-task project logs under ~/.claude/logs/multi-agent (filter by age/project/task). Audit trail + metrics are preserved. Dry-run first; confirms before deleting."
+description-tr: "~/.claude/logs/multi-agent altındaki görev bazlı proje loglarını siler (yaş/proje/görev filtresi). Denetim izi + metrikler korunur. Önce dry-run; silmeden önce onay alır."
 argument-hint: "[--older-than=<days>] [--project=<name>] [--task=<id>] [--yes]"
 ---
 

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

@@ -1,42 +1,45 @@
 ---
 description: "⚠️ Wipes every worktree, branch, log, and state file. Irreversible; asks for double confirmation."
+description-tr: "⚠️ Tüm worktree, branch, log ve state dosyalarını siler. Geri alınamaz; çift onay ister."
 ---
 
 # multi-agent purge  -  Full Reset
 
-Reset every multi-agent state. Nuclear option  -  requires double confirmation.
+Reset every multi-agent worktree, its local branch, and the project task
+counter. Nuclear option  -  requires double confirmation. Backed by
+`$HOME/.claude/scripts/purge.sh`, which is safe by default (dry-run, deletes
+nothing until `--yes`), resolves every `rm` target strictly inside
+`<repo>/.worktrees/`, and never touches the main worktree or main/master/develop.
+
+Task log dirs are NOT purge territory  -  use `/multi-agent:prune-logs`. The
+audit trail and metrics corpus at the log root are always preserved.
 
 ## Steps
 
-1. **Scan**  -  find every worktree:
+1. **Preview (dry-run)**  -  list every worktree, branch, and the counter that
+   would be removed in the current repo:
    ```bash
-   find {repo}/.worktrees/ -name "agent-state.json" -maxdepth 2
-   ```
-
-2. **Show the list**:
-   ```
-   ⚠️ WARNING  -  these will be deleted:
-   - .worktrees/{JIRA-KEY}-12345/ (branch: feature/{JIRA-KEY}-12345-...)
-   - .worktrees/{JIRA-KEY}-12345/ (branch: feature/{JIRA-KEY}-12345-...)
-   - $HOME/.claude/logs/multi-agent/{project}/.counter
-   Total: N worktrees, N branches
+   bash $HOME/.claude/scripts/purge.sh
    ```
+   Nothing to remove -> report "nothing to purge" and stop.
 
-3. **First confirmation**: "This is irreversible. Are you sure?"
+2. **First confirmation**  -  native `AskUserQuestion` picker (no typed keyword),
+   in `outputLanguage`, including the dry-run counts:
+   - `question`: "Wipe the listed worktrees, branches, and counter?"
+   - `header`: "Purge" · `options`: `{ label: "Continue", description: "Proceed to the final confirmation" }`, `{ label: "Cancel", description: "Abort, change nothing" }`
+   - **Cancel** → exit.
 
-4. **Second confirmation** (paranoia gate)  -  a native `AskUserQuestion` picker (no typed keyword):
-   - `question`: "This is irreversible. Permanently wipe every worktree, branch, log, and state file now?" (`outputLanguage`)
-   - `header`: "Purge" (English, <=12 chars) · `options`: `{ label: "Purge permanently", description: "Delete all worktrees, branches, logs, and state" }`, `{ label: "Cancel", description: "Abort, change nothing" }`
+3. **Second confirmation** (paranoia gate)  -  a second `AskUserQuestion` picker:
+   - `question`: "This is irreversible. Permanently wipe every worktree, branch, and state now?" (`outputLanguage`)
+   - `header`: "Confirm" · `options`: `{ label: "Purge permanently", description: "Delete all worktrees, branches, and the counter" }`, `{ label: "Cancel", description: "Abort, change nothing" }`
    - Anything other than **Purge permanently** → cancel.
 
-5. **Delete** (per worktree):
+4. **Remote branches**  -  ask once whether to delete the remote branches too;
+   on yes, add `--delete-remote` to the apply command.
+
+5. **Purge**  -  re-run with `--yes` (plus `--delete-remote` if chosen):
    ```bash
-   git worktree remove .worktrees/{JIRA-KEY}-{id} --force
-   git branch -D {branch-name}
+   bash $HOME/.claude/scripts/purge.sh --yes
    ```
 
-6. **Remote branches**  -  ask: "Delete the remote branches too?"
-
-7. **Reset the counter**  -  remove `$HOME/.claude/logs/multi-agent/{project}/.counter`
-
-8. **Confirm**: `🔥 Purge complete`
+6. **Report**  -  echo the script's summary line.

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

@@ -1,5 +1,6 @@
 ---
 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."
+description-tr: "Projeyi analiz eder: uyarlanmış best-practice'leri çıkarır, gerçek bug + iyileştirme alanlarını avlar, türetilmiş skill'lerin upstream drift'ini kontrol eder, tek plan taslağı çıkarır, onay alır, geliştirir, sonra sync isteyip istemediğini sorar."
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, Agent, AskUserQuestion, WebFetch
 ---
 

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

@@ -1,5 +1,6 @@
 ---
 description: "Resume a stopped or failed task from the phase where it left off."
+description-tr: "Durmuş veya hata almış bir görevi kaldığı fazdan devam ettirir."
 argument-hint: "[#id]  -  optional: task ID (e.g. #2). If omitted, the most recent paused task is used."
 ---