@mmerterden/multi-agent-pipeline 8.6.1 → 10.0.6

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

@@ -3,9 +3,9 @@ description: "Manually switch the active skill set by platform (ios/android/mobi
 allowed-tools: Bash
 ---
 
-# multi-agent stack — Manual Stack Swap
+# multi-agent stack  -  Manual Stack Swap
 
-The `pipeline/scripts/stack-swap.sh` SessionStart hook auto-detects the stack from the project. This command manually overrides that decision — it switches the active skill set in `~/.claude/skills/` and moves the non-matching skills to `~/.claude/skills-inactive/`.
+The `pipeline/scripts/stack-swap.sh` SessionStart hook auto-detects the stack from the project. This command manually overrides that decision  -  it switches the active skill set in `~/.claude/skills/` and moves the non-matching skills to `~/.claude/skills-inactive/`.
 
 ## Usage
 
@@ -24,7 +24,7 @@ The `pipeline/scripts/stack-swap.sh` SessionStart hook auto-detects the stack fr
 
 1. No arg → status mode: print the active skill count, do **not** move any files.
 2. Arg present → run `$HOME/.claude/scripts/stack-swap.sh <arg>`.
-3. The script prints JSON on stdout (`{"systemMessage": "..."}`) — show the `systemMessage` value to the user.
+3. The script prints JSON on stdout (`{"systemMessage": "..."}`)  -  show the `systemMessage` value to the user.
 4. Unknown arg → the script returns `exit 1` with an error message; do not re-prompt, show the list to the user.
 
 ## Implementation
@@ -33,7 +33,7 @@ The `pipeline/scripts/stack-swap.sh` SessionStart hook auto-detects the stack fr
 SCRIPT="$HOME/.claude/scripts/stack-swap.sh"
 
 if [ ! -x "$SCRIPT" ]; then
-  echo "stack-swap.sh not found at $SCRIPT — run install.js --all to deploy pipeline scripts."
+  echo "stack-swap.sh not found at $SCRIPT  -  run install.js --all to deploy pipeline scripts."
   exit 1
 fi
 
@@ -44,5 +44,5 @@ ARG="${1:-status}"
 ## Notes
 
 - A manual swap takes effect immediately, but to refresh Claude Code's skill discovery completely, **restart the conversation**.
-- If you want auto-detect to take over again, the next SessionStart is enough — the hook re-evaluates `cwd`. Manual overrides are not persisted.
+- If you want auto-detect to take over again, the next SessionStart is enough  -  the hook re-evaluates `cwd`. Manual overrides are not persisted.
 - Pipeline Phase 1 stack detection is independent of this command (it reads project files). `stack` only affects which skill set is active.

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

@@ -2,23 +2,23 @@
 description: "Show every multi-agent task's ID, phase, branch, and status."
 ---
 
-# multi-agent status — Task Status Dashboard
+# multi-agent status  -  Task Status Dashboard
 
 Show every active and completed task as a table.
 
 ## Steps
 
-1. **Detect the project** — find the repo root from cwd (otherwise scan every known repo):
+1. **Detect the project**  -  find the repo root from cwd (otherwise scan every known repo):
    - `~/my-ios-app/.worktrees/`
    - `~/my-figma-app/.worktrees/`
    - `~/my-ui-components/.worktrees/`
 
-2. **Scan worktrees** — read `agent-state.json` in each worktree dir:
+2. **Scan worktrees**  -  read `agent-state.json` in each worktree dir:
    ```bash
    find {repo}/.worktrees/ -name "agent-state.json" -maxdepth 2
    ```
 
-3. **Parse state** — for each task:
+3. **Parse state**  -  for each task:
    - `taskId`, `branch`, `currentPhase`, `status`, `startedAt`, `autopilot`
 
 4. **Render as a table**:
@@ -33,6 +33,6 @@ Show every active and completed task as a table.
    💡 log #1 | resume #N | kill #N
    ```
 
-5. **Quick command hints** — based on state:
+5. **Quick command hints**  -  based on state:
    - Paused task → suggest `resume #N`
    - Done task → suggest `log #N`

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

@@ -1,80 +1,84 @@
 ---
-description: "One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, Cursor/Windsurf/Cline adapters, pipeline repo, website, and remote-control."
-argument-hint: "[release] [--adapters] [--platform=<macos|linux|windows>]"
+description: "One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, Cursor/Antigravity/Copilot Chat orchestration adapters, pipeline repo, website, and remote-control."
+argument-hint: "[release] [--no-adapters] [--platform=<macos|linux|windows>]"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, WebFetch
 ---
 
 # Multi-Agent Sync
 
-**Tek komut. Full ecosystem sync. Arguman gerekmez.**
+**One command. Full ecosystem sync. No arguments needed.**
 
-Cagrildiginda 7 hedefin tamamini sirayla senkronize eder. Neyin degistigini algilar, sadece stale olanlari gunceller, sonuc raporu verir. Host platform (macOS / Linux / Windows) otomatik algilanir; tum dispatch komutlari `~/.claude/lib/credential-store.sh` araciligiyla platform-agnostic kalir.
+When invoked, it synchronizes all 7 targets in order. It detects what changed, updates only the stale ones, and returns a result report. The host platform (macOS / Linux / Windows) is auto-detected; all dispatch commands stay platform-agnostic through `~/.claude/lib/credential-store.sh`.
 
 **Input**: $ARGUMENTS (optional)
 
-| Arg | Anlam |
+| Arg | Meaning |
 |---|---|
-| (none) | Global hedefleri sync et (Claude, Copilot, pipeline repo, website, remote-control). Per-project adapter dosyalarina (Cursor / Windsurf / Cline) dokunma. |
+| (none) | Full ecosystem sync: global targets (Claude, Copilot, Codex CLI, pipeline repo, website, remote-control) AND per-project adapter files (Cursor / Antigravity / Copilot Chat) in `prefs.global.projectsTouched[]`. Step 2b runs by default. Files are refreshed and a LOCAL commit is made per project; push stays the user's call (never automatic). |
 | `release` | Full sync + version bump + tag + npm publish + website deploy |
-| `--adapters` | Per-project adapter sync'ini de etkinlestir (Step 2b). `prefs.global.projectsTouched[]` listesindeki repolardaki `.cursor*/.windsurf*/.cline*` dosyalarini refresh eder. |
-| `--platform=<macos\|linux\|windows>` | Otomatik platform algilamayi ezer. CI / cross-platform smoke icin. |
-| `"change description"` | Aciklamayi her hedefe ayni anda uygula |
+| `--no-adapters` | Skip Step 2b (per-project adapter refresh). Use when you want only the global targets and must not touch any project repo (e.g. mid-feature-branch in a project). |
+| `--platform=<macos\|linux\|windows>` | Override automatic platform detection. For CI / cross-platform smoke. |
+| `"change description"` | Apply the description to every target at once |
 
-## Hedefler
+## Targets
 
-| # | Hedef | Yol | Yon |
+| # | Target | Path | Direction |
 |---|-------|-----|-----|
 | 0 | Figma source (deprecated) | `prefs.global.figmaSource.path` | skip (see memory `feedback_figma_source_deprecated`) |
-| 1 | Claude Code (source of truth) | `~/.claude/commands/multi-agent.md` + `~/.claude/commands/multi-agent/` + `~/.claude/agents/` + `~/.claude/scripts/` + `~/.claude/lib/` | kaynak |
-| 2 | Copilot CLI | `~/.copilot/copilot-instructions.md` + `~/.copilot/skills/` | <- Claude'dan |
-| 2b | Cursor / Windsurf / Cline adapters (opt-in via `--adapters`) | her proje root'unda `.cursor/rules/multi-agent.mdc`, `.windsurfrules`, `.clinerules` | <- Claude'dan (template) |
-| 3 | multi-agent-pipeline repo | `~/multi-agent-pipeline/pipeline/` | <- Claude'dan (genericized) |
-| 4 | Website | `{owner}/{website-host}` | <- versiyon + ozellikler |
-| 5 | Remote Control | `{owner}/remote-control` | <- pipeline referanslari |
+| 1 | Claude Code (source of truth) | `~/.claude/commands/multi-agent.md` + `~/.claude/commands/multi-agent/` + `~/.claude/agents/` + `~/.claude/scripts/` + `~/.claude/lib/` | source |
+| 2 | Copilot CLI | `~/.copilot/copilot-instructions.md` + `~/.copilot/skills/` | <- from Claude |
+| 2a | OpenAI Codex CLI (global, auto when `~/.codex` present) | `~/.codex/prompts/multi-agent.md` + `~/.codex/AGENTS.md` + `~/.codex/config.toml` | <- from Claude |
+| 2b | Cursor / Antigravity / Copilot Chat adapters (default; skip with `--no-adapters`) | `.cursor/rules/multi-agent.mdc`, `.github/copilot-instructions.md` in each project root | <- from Claude (template) |
+| 3 | multi-agent-pipeline repo | `~/multi-agent-pipeline/pipeline/` | <- from Claude (genericized) |
+| 4 | Website | `{owner}/{website-host}` | <- version + features |
+| 5 | Remote Control | `{owner}/remote-control` | <- pipeline references |
 
 ## Platform Support (macOS / Linux / Windows)
 
-Sync skill her uc platformda calismali. Komutlar platform-agnostic shell katmanindan gecer; her hedef icin asagidaki uyumluluk kurallari korunur:
+The sync skill must run on all three platforms. Commands go through the platform-agnostic shell layer; the following compatibility rules are preserved for every target:
 
 | Platform | Detection | Implication |
 |---|---|---|
 | macOS | `[[ "$OSTYPE" == "darwin"* ]]` | Default. BSD `stat -f %m`, `security` for Keychain. |
 | Linux | `[[ "$OSTYPE" == "linux"* ]]` | GNU `stat -c %Y`, `secret-tool` for Keychain (libsecret). |
 | Windows (Git Bash / MSYS2) | `[[ "$OSTYPE" == "msys" \|\| "$OSTYPE" == "cygwin" ]]` | `~` resolves to `/c/Users/<name>`. Powershell `CredentialManager` for Keychain. POSIX paths inside Git Bash. |
-| Windows (WSL) | `grep -qi microsoft /proc/version` | Linux toolchain inside WSL. Hostname format `WSL2-…`. |
+| Windows (WSL) | `grep -qi microsoft /proc/version` | Linux toolchain inside WSL. Hostname format `WSL2-...`. |
 
 **Cross-platform contract for synced shell scripts:**
 
-1. Path handling: always quote (`"$f"`); use `$HOME`, never `/Users/…`.
-2. Timestamps: try BSD `stat -f` first, fall back to GNU `stat -c` — both already covered by `~/.claude/lib/repo-cache.sh` pattern.
-3. `find` traversal: include `-prune` for `node_modules`, `Pods`, `.build`, `DerivedData`, `.next` — same on every platform.
+1. Path handling: always quote (`"$f"`); use `$HOME`, never `/Users/...`.
+2. Timestamps: try BSD `stat -f` first, fall back to GNU `stat -c`  -  both already covered by `~/.claude/lib/repo-cache.sh` pattern.
+3. `find` traversal: include `-prune` for `node_modules`, `Pods`, `.build`, `DerivedData`, `.next`  -  same on every platform.
 4. Sed / awk: prefer POSIX-portable invocations. Avoid GNU-only `-i` without `''` on macOS or `-r` (use `-E` instead).
-5. Keychain I/O: always via `~/.claude/lib/credential-store.sh get|set` — never call `security` / `secret-tool` / `gcm` directly.
+5. Keychain I/O: always via `~/.claude/lib/credential-store.sh get|set`  -  never call `security` / `secret-tool` / `gcm` directly.
 6. Verification: after Step 3 (REPO), run `bash -n` on every shell script in `pipeline/lib/` and `pipeline/scripts/` to surface portability regressions early.
 
-## Varsayilan Davranis (argumansiz)
+## Default Behavior (no arguments)
 
 Run every step automatically:
 
 ```
-Adim 0: FIGMA_SYNC  SKIP (deprecated — feedback_figma_source_deprecated)
-Adim 1: PLATFORM    Detect macOS / Linux / Windows (Git Bash / WSL); export PLATFORM env
-Adim 1.5: DETECT    Timestamp karsilastir, stale hedefleri bul
-Adim 2: COPILOT     Claude Code -> Copilot CLI (instructions + 26 sub-command skills)
-Adim 2b: ADAPTERS   Cursor / Windsurf / Cline per-project rule files refresh
-                    — `--adapters` flag tüm projectsTouched[] hedeflerini çalıştırır
-                    — bayrak yoksa SADECE cwd pipeline repo ise auto-fire (maintainer flow)
-Adim 3: REPO        Claude Code -> pipeline repo (genericized, personal data scrub, bash -n on all sh)
-Adim 4: WEBSITE     Versiyon + faz/model sayilari -> {website-host} (i18n + projects.ts)
-Adim 5: REMOTE      Pipeline referanslari -> remote-control README
-Adim 6: Commit      Degisen tum repolari commit + push
-Adim 7: Report      Ozet: sync edilen hedefler, platform, degisen dosyalar, deploy durumu
+Step 0: FIGMA_SYNC  SKIP (deprecated  -  feedback_figma_source_deprecated)
+Step 1: PLATFORM    Detect macOS / Linux / Windows (Git Bash / WSL); export PLATFORM env
+Step 1.5: DETECT    Compare timestamps, find stale targets
+Step 2: COPILOT     Claude Code -> Copilot CLI (instructions + 34 sub-command skills)
+Step 2a: CODEX      Claude Code -> Codex CLI (global ~/.codex prompt + AGENTS.md + config.toml mcp)
+                     -  runs via `node pipeline/scripts/sync-adapters.mjs`, which fires the
+                        codex adapter ONCE (global) when `~/.codex` exists on this machine
+Step 2b: ADAPTERS   Cursor / Antigravity / Copilot Chat per-project rule files refresh
+                     -  RUNS BY DEFAULT: refreshes all projectsTouched[] targets + the pipeline repo
+                     -  `--no-adapters` skips this step entirely
+                     -  writes files + a LOCAL commit per project; push stays the user's call
+Step 3: REPO        Claude Code -> pipeline repo (genericized, personal data scrub, bash -n on all sh)
+Step 4: WEBSITE     Version + phase/model counts -> {website-host} (i18n + projects.ts)
+Step 5: REMOTE      Pipeline references -> remote-control README
+Step 6: Commit      Commit + push all changed repos
+Step 7: Report      Summary: synced targets, platform, changed files, deploy status
 ```
 
-### Adim 0 — Figma source sync (opt-in)
+### Step 0  -  Figma source sync (opt-in)
 
-If `prefs.global.figmaSource.path` is set, run a plan-driven figma sync BEFORE any other step
-sync calistir:
+If `prefs.global.figmaSource.path` is set, run a plan-driven figma sync BEFORE any other step:
 
 ```bash
 # 1. Once plan:
@@ -87,11 +91,11 @@ bash "$REPO_ROOT/pipeline/scripts/sync-figma-source.sh" --plan
 bash "$REPO_ROOT/pipeline/scripts/sync-figma-source.sh"
 ```
 
-- **Plan-driven flow**: `--plan` once rebuilds the "what would change" view —
+- **Plan-driven flow**: `--plan` once rebuilds the "what would change" view  - 
   upstream skill → local name (post-rename) → target tree (figma-ios vs
   figma-common) → overlay-skip status. Writes `.last-figma-sync-plan.json`.
   Apply mode (no flag) executes the plan.
-- Script is idempotent — incremental, uses the `lastCommit` watermark.
+- Script is idempotent  -  incremental, uses the `lastCommit` watermark.
 - Updates the figma-ios / figma-common skills (transform + placeholder).
 - Files marked `local-overlay: true` are preserved (they appear as `overlaySkip: true` in the plan).
 - figma-android/ trees are NOT touched (no upstream source today).
@@ -113,8 +117,8 @@ If nothing is stale → report "All targets up to date" and stop.
 
 ## Sync rules
 
-1. **Read first** — understand every target's current state before making any change
-2. **Preserve file structure** — each target has its own format:
+1. **Read first**  -  understand every target's current state before making any change
+2. **Preserve file structure**  -  each target has its own format:
    - `multi-agent.md` + phases/: detailed pipeline spec (frontmatter, phases, routing)
    - `copilot-instructions.md`: general development instructions + pipeline summary section
    - `multi-agent-pipeline/pipeline/`: generic open-source version (NO personal data)
@@ -125,106 +129,112 @@ If nothing is stale → report "All targets up to date" and stop.
    - Git conventions (author, branch, commit format)
    - --dev mode model info (Opus)
    - Keychain management (registry, naming convention, multi-agent pattern)
-4. **Duplike etme** — Copilot'ta ozet, Claude'da full spec. Bu ayrimi koru.
-5. **Rapor ver** — Sync sonrasi kisa diff ozeti goster
+4. **Do not duplicate**  -  summary in Copilot, full spec in Claude. Keep this distinction.
+5. **Report**  -  show a short diff summary after sync
 
-## Step 2b — Per-Project Adapter Sync (opt-in via `--adapters`)
+## Step 2b  -  Per-Project Adapter Sync (default; skip with `--no-adapters`)
 
-Cursor, Windsurf, ve Cline'in Claude Code (`~/.claude/`) veya Copilot CLI (`~/.copilot/`) gibi global skill dizinleri yok. Pipeline'i her proje icin ayri bir rule dosyasi araciligiyla tuketirler. Bu yuzden onlar icin sync **per-project** calisir ve sadece `--adapters` flag verilirse tetiklenir (default sync proje repolarina dokunmaz — yanlislikla baska bir feature branch'inde commit yaratmamak icin).
+Cursor and GitHub Copilot Chat do not have global skill directories like Claude Code (`~/.claude/`) or Copilot CLI (`~/.copilot/`). They consume the pipeline through a separate rule file per project. So for them, sync runs **per-project**, over every repo in `prefs.global.projectsTouched[]`.
 
-| Adapter | Per-project dosya | Setup tarafindan olusturulur |
+This step RUNS BY DEFAULT. The only side effect on a project repo is a refresh of the marker-wrapped adapter files plus a LOCAL commit; **push is never automatic** (see below), so sync cannot publish anything to a project's remote on its own. If you still need to keep a project repo completely untouched this run (e.g. you are mid-feature-branch and do not want even a local commit), pass `--no-adapters` to skip the step.
+
+| Adapter | Per-project files | Created by setup |
 |---|---|---|
-| Cursor | `<project>/.cursor/rules/multi-agent.mdc` (Cursor 0.42+) veya root `<project>/.cursorrules` (legacy) | `multi-agent:setup` `--cursor` flag |
-| Windsurf | `<project>/.windsurfrules` veya `<project>/.windsurf/rules.md` | `multi-agent:setup` `--windsurf` flag |
-| Cline | `<project>/.clinerules` veya `<project>/.cline/rules.md` | `multi-agent:setup` `--cline` flag |
+| Cursor | `.cursor/rules/multi-agent-*.mdc` + `.cursor/agents/ma-*.md` + `.cursor/commands/multi-agent.md` + `.cursor/mcp.json` | `multi-agent:setup` `--cursor` flag |
+| Antigravity | `.agent/rules/multi-agent-*.md` + `.agent/workflows/multi-agent.md` + `AGENTS.md` + `.agent/mcp_config.json` | `multi-agent:setup` `--antigravity` flag |
+| Copilot Chat (VS Code) | `.github/copilot-instructions.md` + `.github/agents/ma-*.agent.md` + `.github/prompts/multi-agent.prompt.md` + `.vscode/mcp.json` | `multi-agent:setup` `--copilot-chat` flag |
+
+These three are FULL-orchestration adapters (subagents/workflow + a `/multi-agent` command + the dev-toolkit MCP server), not just knowledge layers. Claude Code and Copilot CLI run the pipeline natively and are synced via the global flow above, not here.
+
+**OpenAI Codex CLI is NOT in this per-project table.** Codex is a global-config tool: its custom prompts and MCP servers live under `~/.codex/` and there is no per-project prompt directory. So Codex is synced in the GLOBAL flow (Step 2a), not per-project - `sync-adapters.mjs` fires the codex adapter once when `~/.codex` exists, writing `~/.codex/prompts/multi-agent.md`, `~/.codex/AGENTS.md`, and the `[mcp_servers.dev-toolkit]` block in `~/.codex/config.toml`. Installed via `multi-agent:setup` `--codex` flag (or `node install.js --codex`). Codex has no subagent fan-out, so the Phase 4 parallel review degrades to a sequential adversarial two-pass.
 
-### Akis
+### Flow
 
-Adapter sync orchestration `pipeline/scripts/sync-adapters.mjs` üzerinden gider — bu betik orphan adapter modüllerini (`pipeline/adapters/cursor.mjs`, `copilot-chat.mjs`) discovery + dispatch ile bağlar.
+Adapter sync orchestration goes through `pipeline/scripts/sync-adapters.mjs`  -  this script discovers per-project marker files (`.cursor*`, `.github/copilot-instructions.md`, `.agent`/`AGENTS.md`) and dispatches the matching adapter module (`pipeline/adapters/{cursor,copilot-chat,antigravity}.mjs`, each of which also emits its orchestration layer).
 
-1. `prefs.global.projectsTouched[]` listesini oku (LRU, max 20 entry). Her entry `{ path, adapters: [...] }` formatinda: hangi adapter'lar bu projede kurulu olduguna dair iz.
+1. Read the `prefs.global.projectsTouched[]` list (LRU, max 20 entries). Each entry is in the form `{ path, adapters: [...] }`: a record of which adapters are installed in that project.
 
-2. Tek komut, tüm projeler:
+2. One command, all projects:
    ```bash
    node pipeline/scripts/sync-adapters.mjs --all
    ```
 
-   Script her hedef için:
-   - `.cursor/` veya `.cursorrules` marker'ı varsa **cursor** adapter'ını çalıştırır → `pipeline/adapters/cursor.mjs install()` 174+ `.cursor/rules/multi-agent-*.mdc` dosyası + bir legacy `.cursorrules` digest emit eder.
-   - `.copilot/` veya `.github/copilot-instructions.md` marker'ı varsa **copilot-chat** adapter'ını çalıştırır.
-   - Pipeline repo'nun kendisi (`pipeline/` + `.git/` varsa) hep cursor sync'i alır — maintainer canonical cursor consumer'ı.
-   - Marker yoksa atlar (`[skip]`).
+   For each target the script:
+   - If a `.cursor/` or `.cursorrules` marker is present, runs the **cursor** adapter → `pipeline/adapters/cursor.mjs install()` emits 174+ `.cursor/rules/multi-agent-*.mdc` files + one legacy `.cursorrules` digest.
+   - If a `.copilot/` or `.github/copilot-instructions.md` marker is present, runs the **copilot-chat** adapter.
+   - The pipeline repo itself (when `pipeline/` + `.git/` are present) always gets the cursor sync  -  the maintainer's canonical cursor consumer.
+   - If no marker is present, skips (`[skip]`).
 
-3. Dry-run görünümü:
+3. Dry-run view:
    ```bash
    node pipeline/scripts/sync-adapters.mjs --doctor
    ```
 
-4. Tek proje refresh (bu repo veya başka bir target):
+4. Single-project refresh (this repo or another target):
    ```bash
    node pipeline/scripts/sync-adapters.mjs --target=/path/to/repo --platform=ios
    ```
 
-5. Her proje icin commit ayri olarak yapilir (cross-project commit yok):
+5. Commits are made separately per project (no cross-project commit):
    ```bash
    cd "$PROJ"
    if ! git diff --cached --quiet; then
      git commit -m "chore(adapter): sync multi-agent rules"
-     # NOT: push otomatik degil — kullanici karari. Sync sadece local commit yapar.
+     # NOTE: push is not automatic  -  it's the user's call. Sync only makes a local commit.
    fi
    ```
 
-4. Push **otomatik degil**. Adapter sync default'da commit'i local birakir; her proje branch'i icin push karari kullanicidadir (proje branch'inin shared olup olmadigi dis bilgi gerektirir).
+4. Push is **not automatic**. Adapter sync leaves the commit local by default; the push decision for each project branch is the user's (whether the project branch is shared requires external knowledge).
 
-### Skip kosullari
+### Skip conditions
 
-- `--adapters` verilmediyse Step 2b tamamen atlanir (rapora "skipped (use --adapters to refresh per-project rules)" yazilir).
-- `prefs.global.projectsTouched[]` bos -> "no project adapter installs recorded — run `multi-agent:setup` in a project first".
-- Proje dizini silinmis -> entry LRU prune'una konu (sync orada hata vermez).
+- If `--no-adapters` is given, Step 2b is skipped entirely (the report says "skipped (--no-adapters)").
+- `prefs.global.projectsTouched[]` empty -> "no project adapter installs recorded  -  run `multi-agent:setup` in a project first". Step 2b is a no-op (nothing to refresh), not an error.
+- Project directory deleted -> the entry is subject to LRU pruning (sync does not error there).
 
 ---
 
-## Pipeline Repo Sync Kurallari (KRITIK)
-
-1. **Kaynak**: `~/.claude/commands/multi-agent.md` + `~/.claude/commands/multi-agent/` + `~/.claude/agents/`
-2. **Hedef**: `~/multi-agent-pipeline/pipeline/`
-3. **Genericization** (hedefe yazmadan ONCE uygulanmali):
-   - Jira proje key'i (`prefs.global.defaultJiraKey`) -> `{JIRA_KEY}`, orneklerde `PROJ`
-   - Kisisel isimler/emailler -> generic placeholder
-   - Branch isimleri -> `develop`
-   - Proje isimleri -> `my-app`
-   - `{JIRA_HOST}`, `{BITBUCKET_HOST}`, `{CONFLUENCE_HOST}`, `{CORP_DOMAIN}` oldugu gibi kalir
-   - **Dogrula**: `grep` ile pipeline/ icinde kisisel/kurumsal veri taramasi -> 0 sonuc
-4. **Dosya esleme**:
+## Pipeline Repo Sync Rules (CRITICAL)
+
+1. **Source**: `~/.claude/commands/multi-agent.md` + `~/.claude/commands/multi-agent/` + `~/.claude/agents/`
+2. **Target**: `~/multi-agent-pipeline/pipeline/`
+3. **Genericization** (must be applied BEFORE writing to the target):
+   - Jira project key (`prefs.global.defaultJiraKey`) -> `{JIRA_KEY}`, `PROJ` in examples
+   - Personal names/emails -> generic placeholder
+   - Branch names -> `develop`
+   - Project names -> `my-app`
+   - `{JIRA_HOST}`, `{BITBUCKET_HOST}`, `{CONFLUENCE_HOST}`, `{CORP_DOMAIN}` stay as-is
+   - **Verify**: `grep` scan for personal/corporate data inside pipeline/ -> 0 results
+4. **File mapping**:
    ```
    ~/.claude/commands/multi-agent.md      -> pipeline/commands/multi-agent.md
    ~/.claude/commands/multi-agent/        -> pipeline/commands/multi-agent/
    ~/.claude/commands/sim-test.md         -> pipeline/commands/sim-test.md
    ~/.claude/agents/*.md                  -> pipeline/agents/
    ```
-5. **Sync EDILMEYEN dosyalar** (local-only, kisisel veri icerebilir):
+5. **Files NOT synced** (local-only, may contain personal data):
    - `~/.claude/multi-agent-preferences.json`
    - `~/.claude/CLAUDE.md`, `~/.claude/rules/`, `~/.claude/knowledge/`
-   - `~/.claude/scripts/` — `pre-commit-check.sh` ve `stack-swap.sh` HARIC (generic, sync edilir)
+   - `~/.claude/scripts/`  -  EXCEPT `pre-commit-check.sh` and `stack-swap.sh` (generic, synced)
    - `~/.claude/settings.json`
 
-6. **Cross-platform smoke gate** (REPO sync'in son adimi, push'tan once):
+6. **Cross-platform smoke gate** (final step of the REPO sync, before push):
    ```bash
    # bash -n: parse-level syntax check on every shell script
    find ~/multi-agent-pipeline/pipeline/lib ~/multi-agent-pipeline/pipeline/scripts \
         -name "*.sh" -type f -exec bash -n {} \;
-   # Should print nothing — any output is a portability regression.
+   # Should print nothing  -  any output is a portability regression.
 
    # Portability grep: flag known non-portable constructs introduced post-sync.
    grep -rnE "stat -f[^[:space:]]+[^|]|sed -i[^[:space:]'\"]" \
         ~/multi-agent-pipeline/pipeline/lib ~/multi-agent-pipeline/pipeline/scripts || true
    # Each hit needs an explicit GNU/BSD fallback per the Platform Support contract.
    ```
-   Gate failure -> abort push, surface the file + line, fix in `~/.claude/` source first, re-sync.
+   Gate failure -> abort push, surface the file + line, fix in the `~/.claude/` source first, re-sync.
 
 ---
 
-## Website Sync (Adim 4)
+## Website Sync (Step 4)
 
 Propagate pipeline version, phase count, model count, and feature descriptions to the website.
 
@@ -235,7 +245,7 @@ WEBSITE_DIR="$HOME/{website-host}"
 cd "$WEBSITE_DIR" && git pull origin main
 ```
 
-| Dosya | Sync edilecek |
+| File | What to sync |
 |-------|--------------|
 | `src/lib/i18n.tsx` | Phase count, model count, feature descriptions (EN + TR) |
 | `src/data/projects.ts` | Version number, tagline, description, feature list |
@@ -248,7 +258,7 @@ git push origin main  # Vercel auto-deploy
 
 ---
 
-## Remote Control Sync (Adim 5)
+## Remote Control Sync (Step 5)
 
 ```bash
 REMOTE_DIR="$HOME/remote-control"
@@ -256,65 +266,67 @@ REMOTE_DIR="$HOME/remote-control"
 cd "$REMOTE_DIR" && git pull origin main
 ```
 
-| Dosya | Sync edilecek |
+| File | What to sync |
 |-------|--------------|
 | `README.md` | Pipeline feature description |
-| `src/index.ts` | Help text / chip label'lari (varsa) |
+| `src/index.ts` | Help text / chip labels (if any) |
 
-Sadece pipeline'in public-facing ozellikleri degistiyse guncelle.
+Update only if the pipeline's public-facing features changed.
 
 ---
 
-## Release Akisi
+## Release Flow
 
-`release` argumaniyla cagrildiginda:
+When invoked with the `release` argument:
 
 ```
 1. REPO          Claude Code -> pipeline repo (genericized)
-2. VERIFY        Kisisel veri taramasi -> 0 sonuc
+2. VERIFY        Personal data scan -> 0 results
 3. LINT + TEST   ESLint + smoke tests
 4. VERSION       package.json version bump (patch/minor/major)
 5. Commit + TAG  git commit + git tag v{VERSION}
 6. PUSH          git push --tags -> release.yml auto-publish
-7. WEBSITE       Versiyon + ozellikler -> {website-host}
-8. REMOTE        remote-control referanslari guncelle
+7. WEBSITE       Version + features -> {website-host}
+8. REMOTE        Update remote-control references
 9. COPILOT       Copilot CLI instructions + skills sync
-10. Report        Ozet: versiyon, dokunulan repolar, deploy durumu
+10. Report        Summary: version, touched repos, deploy status
 ```
 
 ---
 
 ## Sub-Command Sync (Claude Code <-> Copilot CLI Skills)
 
-Bu adim sadece Claude <-> Copilot ekseninde calisir. Cursor / Windsurf / Cline global komut dizinine sahip degildir; pipeline'i Step 2b'deki per-project rule dosyalari uzerinden tuketirler, sub-command bazinda sync edilecek bir hedefleri yoktur.
+This step runs only on the Claude <-> Copilot axis. Cursor / Copilot Chat do not have a global command directory; they consume the pipeline through the per-project rule files in Step 2b, so they have no sub-command-level sync target.
 
 | Claude Code | Copilot CLI |
 |-------------|-------------|
 | `~/.claude/commands/multi-agent/{cmd}.md` | `~/.copilot/skills/multi-agent-{cmd}/SKILL.md` |
 
-**29 commands are synced** (canonical inventory — must match `cross-cli-contract.md` §1; drift = contract violation):
+**34 commands are synced** (canonical inventory  -  must match `cross-cli-contract.md` section 1; drift = contract violation):
 
 ```
-autopilot, channels, dev, dev-autopilot, dev-local, dev-local-autopilot,
-help, issue, jira, kill, local, local-autopilot, log, manual-test, purge,
-refactor, resume, review, scan, search, setup, stack, status, sync, test, update
+analysis, analysis-resolve, autopilot, build-optimize, channels, delete, dev,
+dev-autopilot, dev-local, dev-local-autopilot, diff-explain, garbage-collect,
+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
 ```
 
-**Sync EDILMEZ**: `refs/*` — Lazy-load referanslari, Claude Code'a ozel
+**NOT synced**: `refs/*`  -  lazy-load references, Claude Code specific
 
-**Claude -> Copilot**: SKILL.md frontmatter ekle (`name`, `description`, `user-invocable: true`, `argument-hint`)
-**Copilot -> Claude**: Frontmatter'i basitlestir (`description` + `allowed-tools`), `$ARGUMENTS` ekle
+**Claude -> Copilot**: add SKILL.md frontmatter (`name`, `description`, `user-invocable: true`, `argument-hint`)
+**Copilot -> Claude**: simplify the frontmatter (`description` + `allowed-tools`), add `$ARGUMENTS`
 
 ---
 
-## Keychain Token Erisimi
+## Keychain Token Access
 
-| Islem | Token Kaynagi |
+| Operation | Token Source |
 |-------|---------------|
 | `gh` CLI (personal) | `{owner}` gh auth (Keychain) |
-| `gh` CLI (work) | `M-ERDEN3_tkgithub` gh auth (Keychain) |
-| npm publish | `NODE_AUTH_TOKEN` — CI'da `GITHUB_TOKEN`, local'de Keychain PAT |
+| `gh` CLI (work) | `{user}_<work-label>` gh auth (Keychain)  -  see `prefs.global.accounts[]` |
+| npm publish | `NODE_AUTH_TOKEN`  -  `GITHUB_TOKEN` in CI, Keychain PAT locally |
 
 ```bash
-gh auth switch --user {owner}  # personal repolar icin
+gh auth switch --user {owner}  # for personal repos
 ```

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

@@ -1,13 +1,13 @@
 ---
-description: "UI Bug Hunter — iOS Simulator (simctl) + Android Emulator (adb). Auto-detects platform. Screenshot + tap + analyze on the booted device. The Phase 5 Manual Test flow lives at /multi-agent:manual-test."
-argument-hint: '[scenario] — e.g. "dark mode" | "accessibility" | "dynamic type" | "screenshot tr" | "store-ready" | (empty = full sweep)'
+description: "UI Bug Hunter  -  iOS Simulator (simctl) + Android Emulator (adb). Auto-detects platform. Screenshot + tap + analyze on the booted device. The Phase 5 Manual Test flow lives at /multi-agent:manual-test."
+argument-hint: '[scenario]  -  e.g. "dark mode" | "accessibility" | "dynamic type" | "screenshot tr" | "store-ready" | (empty = full sweep)'
 ---
 
-# /multi-agent:test — UI Bug Hunter
+# /multi-agent:test  -  UI Bug Hunter
 
 Mobile UI test runner. Boots a simulator / emulator, drives it via MCP tools, and audits the running app for visual / accessibility / platform issues. Auto-detects iOS vs Android from cwd.
 
-**Input**: $ARGUMENTS (optional — a test scenario tag, e.g. `"dark mode"`, `"accessibility"`, `"dynamic type"`, `"screenshot tr"`)
+**Input**: $ARGUMENTS (optional  -  a test scenario tag, e.g. `"dark mode"`, `"accessibility"`, `"dynamic type"`, `"screenshot tr"`)
 
 ## Dispatcher
 
@@ -17,7 +17,7 @@ This command delegates to the file holding the full UI Bug Hunter flow. Read thi
 $HOME/.claude/commands/sim-test.md
 ```
 
-Pass `$ARGUMENTS` through verbatim — sim-test.md decides which test matrix to run based on the value (e.g. `dark mode` / `accessibility`).
+Pass `$ARGUMENTS` through verbatim  -  sim-test.md decides which test matrix to run based on the value (e.g. `dark mode` / `accessibility`).
 
 ## Quick reference
 
@@ -26,7 +26,7 @@ Pass `$ARGUMENTS` through verbatim — sim-test.md decides which test matrix to
 | `/multi-agent:test` | Walk every screen, collect screenshots + UI tree, produce a general report |
 | `/multi-agent:test "dark mode"` | Light vs dark comparison, contrast + colour bugs |
 | `/multi-agent:test "accessibility"` | VoiceOver label + tap-target + contrast audit |
-| `/multi-agent:test "dynamic type"` | Layout check at XL–XXXL text sizes |
+| `/multi-agent:test "dynamic type"` | Layout check at XL-XXXL text sizes |
 | `/multi-agent:test "screenshot tr"` | App Store screenshot set (Turkish locale) |
 | `/multi-agent:test "store-ready"` | App Store guideline pre-flight check |
 

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

@@ -73,7 +73,7 @@ Update the pipeline in one command. Existing preferences are preserved; only ski
 Current: v3.6.0
   -> git pull origin main
   -> node install.js --all (44 commands, 50 scripts, 291 skills)
-  -> migrate-prefs.mjs (0 changes — already v2.1.0)
+  -> migrate-prefs.mjs (0 changes  -  already v2.1.0)
 
 ✓ Updated: v3.6.0 → v3.7.0