@mmerterden/multi-agent-pipeline 15.16.0 → 16.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (90) hide show
  1. package/CHANGELOG.md +124 -0
  2. package/README.md +2 -2
  3. package/README.tr.md +1 -2
  4. package/docs/architecture.md +2 -2
  5. package/docs/ecosystem.md +9 -6
  6. package/docs/features.md +2 -3
  7. package/install/_plugin-skills.mjs +28 -2
  8. package/install/templates/copilot-instructions.md +8 -7
  9. package/package.json +1 -1
  10. package/pipeline/commands/multi-agent/SKILL.md +5 -6
  11. package/pipeline/commands/multi-agent/analysis/SKILL.md +77 -588
  12. package/pipeline/commands/multi-agent/analysis-resolve/SKILL.md +5 -69
  13. package/pipeline/commands/multi-agent/channels/SKILL.md +1 -1
  14. package/pipeline/commands/multi-agent/complaint-analysis/SKILL.md +5 -4
  15. package/pipeline/commands/multi-agent/dev/SKILL.md +8 -280
  16. package/pipeline/commands/multi-agent/dev-autopilot/SKILL.md +12 -124
  17. package/pipeline/commands/multi-agent/dev-local/SKILL.md +8 -111
  18. package/pipeline/commands/multi-agent/dev-local-autopilot/SKILL.md +11 -113
  19. package/pipeline/commands/multi-agent/help/SKILL.md +61 -56
  20. package/pipeline/commands/multi-agent/ios-coding-standard/SKILL.md +4 -2
  21. package/pipeline/commands/multi-agent/local-autopilot/SKILL.md +2 -4
  22. package/pipeline/commands/multi-agent/refactor/SKILL.md +1 -1
  23. package/pipeline/commands/multi-agent/resume-local/SKILL.md +3 -3
  24. package/pipeline/commands/multi-agent/setup/SKILL.md +2 -2
  25. package/pipeline/commands/multi-agent/stack/SKILL.md +10 -9
  26. package/pipeline/commands/multi-agent/store-ready/SKILL.md +1 -1
  27. package/pipeline/commands/multi-agent/sync/SKILL.md +2 -2
  28. package/pipeline/commands/multi-agent/update/SKILL.md +1 -1
  29. package/pipeline/lib/context-link-extractor.sh +38 -0
  30. package/pipeline/lib/fetch-document.sh +190 -0
  31. package/pipeline/multi-agent-refs/_dev-context.md +4 -0
  32. package/pipeline/multi-agent-refs/analysis/evidence.md +213 -0
  33. package/pipeline/multi-agent-refs/analysis/intake.md +167 -0
  34. package/pipeline/multi-agent-refs/analysis/locked.md +53 -0
  35. package/pipeline/multi-agent-refs/analysis/render.md +133 -0
  36. package/pipeline/multi-agent-refs/analysis/resolve.md +76 -0
  37. package/pipeline/multi-agent-refs/analysis/synthesis.md +98 -0
  38. package/pipeline/multi-agent-refs/analysis-template.md +58 -11
  39. package/pipeline/multi-agent-refs/complaint-analysis-template.md +1 -1
  40. package/pipeline/multi-agent-refs/component-dispatch.md +5 -5
  41. package/pipeline/multi-agent-refs/cross-cli-contract.md +9 -7
  42. package/pipeline/multi-agent-refs/features/skill-conformance.md +1 -1
  43. package/pipeline/multi-agent-refs/features/url-enrichment.md +13 -3
  44. package/pipeline/multi-agent-refs/knowledge.md +2 -2
  45. package/pipeline/multi-agent-refs/payload-contracts.md +1 -1
  46. package/pipeline/multi-agent-refs/phases/modes.md +73 -53
  47. package/pipeline/multi-agent-refs/phases/phase-0-init.md +21 -2
  48. package/pipeline/multi-agent-refs/phases/phase-1-analysis.md +26 -0
  49. package/pipeline/multi-agent-refs/phases/phase-2-planning.md +26 -12
  50. package/pipeline/multi-agent-refs/phases/phase-3-dev.md +17 -18
  51. package/pipeline/multi-agent-refs/phases/phase-4-review.md +29 -7
  52. package/pipeline/multi-agent-refs/phases/phase-5-test.md +1 -1
  53. package/pipeline/multi-agent-refs/phases/phase-6-commit.md +8 -0
  54. package/pipeline/multi-agent-refs/phases/phase-7-report.md +1 -1
  55. package/pipeline/multi-agent-refs/phases.md +9 -7
  56. package/pipeline/multi-agent-refs/progress-contract.md +1 -1
  57. package/pipeline/multi-agent-refs/readiness-review.md +2 -0
  58. package/pipeline/multi-agent-refs/rules.md +2 -2
  59. package/pipeline/multi-agent-refs/tracker-contract.md +32 -13
  60. package/pipeline/multi-agent-refs/wiki-capture.md +2 -2
  61. package/pipeline/schemas/agent-state.schema.json +3 -3
  62. package/pipeline/schemas/analysis-output.schema.json +17 -0
  63. package/pipeline/schemas/analysis-spec.schema.json +69 -1
  64. package/pipeline/schemas/complaint-analysis-spec.schema.json +1 -1
  65. package/pipeline/schemas/prefs.schema.json +47 -0
  66. package/pipeline/schemas/token-budget.json +2 -2
  67. package/pipeline/scripts/_stack-routing.mjs +17 -12
  68. package/pipeline/scripts/build-stack-plugins.mjs +16 -6
  69. package/pipeline/scripts/cost-table.json +1 -1
  70. package/pipeline/scripts/gen-mode-dispatch.mjs +20 -30
  71. package/pipeline/scripts/run-aggregator.mjs +1 -1
  72. package/pipeline/scripts/validate-analysis-doc.mjs +36 -3
  73. package/pipeline/skills/.skills-index.json +40 -7
  74. package/pipeline/skills/shared/README.md +12 -9
  75. package/pipeline/skills/shared/core/multi-agent/SKILL.md +9 -5
  76. package/pipeline/skills/shared/core/multi-agent-dev/SKILL.md +7 -61
  77. package/pipeline/skills/shared/core/multi-agent-dev-autopilot/SKILL.md +11 -51
  78. package/pipeline/skills/shared/core/multi-agent-dev-local/SKILL.md +7 -33
  79. package/pipeline/skills/shared/core/multi-agent-dev-local-autopilot/SKILL.md +10 -38
  80. package/pipeline/skills/shared/core/multi-agent-help/SKILL.md +28 -18
  81. package/pipeline/skills/shared/core/multi-agent-ios-coding-standard/SKILL.md +4 -2
  82. package/pipeline/skills/shared/core/multi-agent-local-autopilot/SKILL.md +2 -4
  83. package/pipeline/skills/shared/core/multi-agent-refactor/SKILL.md +1 -1
  84. package/pipeline/skills/shared/core/multi-agent-resume-local/SKILL.md +2 -2
  85. package/pipeline/skills/shared/core/multi-agent-stack/SKILL.md +10 -9
  86. package/pipeline/skills/shared/core/multi-agent-sync/SKILL.md +2 -2
  87. package/pipeline/skills/shared/external/evidence-github/SKILL.md +45 -0
  88. package/pipeline/skills/shared/external/evidence-registry/SKILL.md +33 -0
  89. package/pipeline/skills/shared/external/signal-community/SKILL.md +44 -0
  90. package/pipeline/skills/skills-index.md +10 -7
@@ -1,120 +1,17 @@
1
1
  ---
2
- description: "Fast mode + local - Init → Dev(Opus) → Review → Commit → Report, no worktree. Use when a change should be developed and reviewed on the current branch without creating a worktree."
3
- description-tr: "Hızlı mod + lokal - Init → Dev(Opus) → Review → Commit → Report, worktree yok."
4
- allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, WebFetch, Skill
2
+ description: "Removed in v16.0.0. Its worktree-free twin is /multi-agent:local, which asks the same depth question; answer Short there. Invoke only to see that redirect."
3
+ description-tr: "v16.0.0'da kaldırıldı. /multi-agent:local çalıştırıp derinlik sorusunda Kısa seçin."
5
4
  ---
6
5
 
7
- # multi-agent dev-local - Fast + Local
6
+ # multi-agent dev-local - Removed in v16.0.0
8
7
 
9
- > **Language (read FIRST)**: Before any status output, read `prefs.global.outputLanguage` and render every conversational line in it. `AskUserQuestion` `label`/`header` stay English, but its `question` and option `description`s render in `outputLanguage`; external payload bodies follow `outputLanguage` too (identifiers, commit messages, branch names stay English). Full contract: `$HOME/.claude/multi-agent-refs/rules.md` "Language Application".
8
+ Depth stopped being a command name in v16.0.0. `--local` is still a command, because a worktree is a real difference in where the work happens; depth is not.
10
9
 
11
- Dedicated form of the `--dev` + `--local` combination. A 4-phase fast pipeline (no worktree).
12
-
13
- ## Pipeline
14
-
15
- ```
16
- Phase 0: Init → project detection, branch check, state (NO worktree)
17
- Phase 3: Dev → direct development on Opus (Analysis + Planning skipped)
18
- Phase 4: Review → deterministic gates + parallel review + triage
19
- Phase 6: Commit → pre-commit checkout prompt, commit + push + PR
20
- Phase 7: Report → Jira / Wiki + log + knowledge/memory
21
- ```
22
-
23
- `--dev local` skips Phase 1 (Analysis), Phase 2 (Planning + Approval Gate), 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. **Review is not skipped** - Phase 4 runs its gates, resolves the criteria the dev phase was supposed to honour, reviews in parallel and triages, and accepted blocking findings return to Phase 3 (3-iteration cap).
24
-
25
-
26
- ## When to use it
27
-
28
- - Quick bug fix or small feature - analysis and planning buy nothing here
29
- - You're working on the current branch and don't want to switch worktrees
30
- - A well-understood change - you want it reviewed, not designed
31
- ## Required: Phase Tracker Contract
32
-
33
- **The phase tracker is mandatory** - the agent cannot skip it. Full spec: [`$HOME/.claude/multi-agent-refs/tracker-contract.md`]($HOME/.claude/multi-agent-refs/tracker-contract.md).
34
-
35
- > **Local mode:** no worktree is created, work happens on the current branch. Phase 0 Init still calls `init` - the `--local` flag is stored in tracker-state.json, and `:resume` restores the correct CWD.
36
-
37
- Two channels run in parallel at every phase boundary:
38
-
39
- 1. **State channel** (every CLI, identical): `phase-tracker.sh` writes to `tracker-state.json`. Drives `:resume`, `:log`, `:status`.
40
- 2. **Visual channel** (CLI-specific): native widget on Claude Code, ANSI render on every other CLI. Without it the user sees no phase progress.
41
-
42
- ```bash
43
- # Phase 0, very first shell call (every CLI):
44
- bash $HOME/.claude/scripts/phase-tracker.sh init "$TASK_ID"
45
- for p in "0:Init" "3:Dev" "4:Review" "6:Commit" "7:Report"; do
46
- bash $HOME/.claude/scripts/phase-tracker.sh add "${p%%:*}" "${p#*:}"
47
- done
48
- bash $HOME/.claude/scripts/phase-tracker.sh update 0 in_progress
49
-
50
- # Every phase boundary (every CLI):
51
- bash $HOME/.claude/scripts/phase-tracker.sh update <N> in_progress|completed|failed|skipped
52
-
53
- # After every LLM call (every CLI):
54
- bash $HOME/.claude/scripts/phase-tracker.sh tokens <N> <in> <out> [cached]
55
- ```
56
-
57
- ### Visual channel - Claude Code (native TaskList widget, required)
58
-
59
- In Claude Code the agent MUST also drive the native TaskList widget so the user sees a sticky phase tile stack - this is the only progress signal Claude Code surfaces. Skipping these calls is the #1 source of "I don't see any phases" complaints.
60
-
61
- **TaskCreate ordering (strict)**: All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied. The native widget renders by creation order, not by phase number - out-of-order calls produce visually scrambled tile stacks (e.g. `1 ✓ · 2 ✓ · 4 ✓ · 0 ▶ · 3 ☐`) even when the underlying state is correct. Pre-marking phases as completed/skipped before Phase 0 starts is FORBIDDEN - register the tile in order, then flip status via TaskUpdate when the phase actually short-circuits. Full contract in `$HOME/.claude/multi-agent-refs/tracker-contract.md` section "TaskCreate ordering (strict)".
62
-
63
- ```text
64
- # Phase 0 startup - register one tile per phase (0..N), capture the taskId, persist it:
65
- for each phase in 0:Init, 3:Dev, 4:Review, 6:Commit, 7:Report:
66
- TaskCreate({ subject: "Phase <N>: <Name>", activeForm: "<doing-form>" })
67
- -> returns taskId
68
- bash $HOME/.claude/scripts/phase-tracker.sh meta <N> tasklist_id "<taskId>"
69
-
70
- # Phase entry - flip the tile to in_progress alongside the state update:
71
- TaskUpdate({ taskId: <saved>, status: "in_progress" })
72
- bash $HOME/.claude/scripts/phase-tracker.sh update <N> in_progress
73
-
74
- # Active sub-step inside a phase - update activeForm so the spinner header reflects what's happening now:
75
- TaskUpdate({ taskId: <saved>, activeForm: "Editing TopBarView.swift" })
76
-
77
- # Phase exit - flip to completed/failed/skipped on both channels:
78
- TaskUpdate({ taskId: <saved>, status: "completed" })
79
- bash $HOME/.claude/scripts/phase-tracker.sh update <N> completed
80
10
  ```
81
-
82
- `--dev local` mode does NOT TaskCreate phases 1/2/5 - those are not part of the `--dev local` phase set (`0:Init 3:Dev 4:Review 6:Commit 7:Report`). Only register tiles for the active set.
83
-
84
- #### TaskCreate ordering (strict)
85
-
86
- **All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied.** For `--dev local` that means: Phase 0 → Phase 3 → Phase 4 → Phase 6 → Phase 7. The native widget renders by creation order, not by phase number - out-of-order calls produce visually scrambled tile stacks. Full ordering contract in `$HOME/.claude/multi-agent-refs/tracker-contract.md` section "TaskCreate ordering (strict)".
87
-
88
- ### Visual channel - Copilot CLI / plain shell
89
-
90
- These CLIs have no TaskList widget. After every state change the agent calls render, which prints a bordered ANSI card as the last tool result so the user sees an updated phase table:
91
-
92
- ```bash
93
- bash $HOME/.claude/scripts/phase-tracker.sh render
11
+ /multi-agent:dev-local has been removed. Run /multi-agent:local and choose
12
+ Short at the depth question - same pipeline, one picker step earlier.
94
13
  ```
95
14
 
96
- Do NOT call TaskCreate on these CLIs - the tool does not exist and the call fails.
97
- ## Delegation
98
-
99
- Routes to the orchestrator with `--dev --local` flags. Apply the `$HOME/.claude/commands/multi-agent/dev/SKILL.md` pipeline in local mode:
100
- - Phase 0: skip worktree creation, continue on the current branch
101
- - Phase 1 (Analysis), Phase 2 (Planning + Approval Gate), and Phase 5 (User Test) are skipped (`--dev` + local/autopilot drop the interactive test gate)
102
- - Phase 3: develop on Opus (instead of the Sonnet TDD cycle)
103
- - Phase 4: review as in the full pipeline, on the local branch diff; accepted blocking findings loop back to Phase 3, capped at 3 iterations
104
- - Phase 6: commit + push + PR (the local checkout prompt is natural in local mode - you're already there; no worktree removal needed, code is already in `$PROJECT_ROOT`)
105
- - Phase 7: report + channels (same as `--dev`)
106
-
107
- ## Intake warnings (`--dev` family)
108
-
109
- Two checks belong at the top of every `--dev` run and are specified once in `$HOME/.claude/multi-agent-refs/phases/modes.md` "Intake warnings shared by the whole `--dev` family": an analysis document supplied to a mode that skips Analysis and Planning, and a branch that already carries the work (which wants `/multi-agent:resume-local`, not a second Dev pass). Read that section rather than reasoning about it from scratch.
15
+ Print the line above, then continue at the named entry with the same `$ARGUMENTS`. Do not run any phase from this file: it carries no tracker contract and no phase set.
110
16
 
111
- ## Required: outward-facing payload contracts
112
-
113
- Skipping Analysis and Planning does not shorten the payload contracts. Before writing anything outward-facing, load `$HOME/.claude/multi-agent-refs/payload-contracts.md` - the canonical list of what to read for the PR body, the Jira comment, and the closing report, plus the markup dialect per surface. Improvising a payload shape from memory is the single most common failure of the fast modes.
114
-
115
- ## Examples
116
-
117
- ```bash
118
- /multi-agent:dev-local "PROJ-12345" # Jira
119
- /multi-agent:dev-local "Bug: LoginView dark mode" # Free-text
120
- ```
17
+ This stub exists so the old name fails loudly and usefully for one minor release instead of silently doing nothing. It is deleted in the next one.
@@ -1,123 +1,21 @@
1
1
  ---
2
- description: "Fastest + local - Dev(Opus) + Review + autopilot, no worktree, zero interaction. Review runs and auto-fixes blocking findings. Use when a change should be developed on the current branch with no worktree and no prompts."
3
- description-tr: "En hızlı + lokal - Dev(Opus) + Review + autopilot, worktree yok, sıfır etkileşim. Review koşar, blocking bulguları otomatik düzeltir."
4
- allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdate, TaskList, TaskGet, WebFetch, Skill
2
+ description: "Retired alongside its worktree twin in v16.0.0, with nothing standing in for it. Invoke only to be pointed at /multi-agent:local-autopilot or the interactive picker."
3
+ description-tr: "v16.0.0'da kaldırıldı, birebir karşılığı yok: gözetimsiz koşular artık her zaman tam pipeline. /multi-agent:local-autopilot veya /multi-agent:local'e yönlendirir."
5
4
  ---
6
5
 
7
- # multi-agent dev-local-autopilot - Fastest + Local
6
+ # multi-agent dev-local-autopilot - Removed in v16.0.0
8
7
 
9
- > **Language (read FIRST)**: Before any status output, read `prefs.global.outputLanguage` and render every conversational line in it. `AskUserQuestion` `label`/`header` stay English, but its `question` and option `description`s render in `outputLanguage`; external payload bodies follow `outputLanguage` too (identifiers, commit messages, branch names stay English). Full contract: `$HOME/.claude/multi-agent-refs/rules.md` "Language Application".
8
+ Same removal as `dev-autopilot`, on the no-worktree path. Depth is a question, autopilot may not ask one, and Full is the safer answer when nobody is watching.
10
9
 
11
- The triple `--dev` + `--local` + `autopilot` - the fastest form available. Zero confirmations, NO worktree.
12
-
13
- ## Pipeline
14
-
15
- ```
16
- Phase 0: Init → project detection, branch check, state (NO worktree, NO confirmation)
17
- Phase 3: Dev → direct development on Opus (automatic)
18
- Phase 4: Review → gates + parallel review + triage, auto-fix
19
- Phase 6: Commit → auto commit + push + PR (no local checkout prompt)
20
- Phase 7: Report → Jira / Wiki + log + knowledge/memory
21
10
  ```
22
-
23
- Phase 1 (Analysis), Phase 2 (Planning + Approval Gate) and Phase 5 (User Test) are skipped. Review is not: accepted blocking findings are fixed automatically without a prompt, and the run halts rather than committing if they survive 3 rework cycles.
24
-
25
- ## When to use it
26
-
27
- - Routine change you trust - you want it reviewed, not discussed
28
- - A CI / batch environment running the pipeline automatically - no user interaction
29
- - Prototype / spike - you care about speed, and the review that runs costs you no prompts
30
-
31
- ## When NOT to use it
32
-
33
- - Production-bound change - at minimum use `--dev` (without autopilot), so you see the findings before the commit
34
- - Security-sensitive code - autopilot decides for you which accepted findings to fix, and commits when they are gone
35
- - A first big refactor - human review is required, and machine review does not substitute for it
36
-
37
- ## Delegation
38
-
39
- Routes to the orchestrator with `--dev --local autopilot` flags. The pipeline contract matches [`dev-autopilot/SKILL.md`](../dev-autopilot/SKILL.md) exactly, with Phase 0 Step 8 (worktree creation) skipped.
40
-
41
-
42
- ## Examples
43
-
44
- ```bash
45
- /multi-agent:dev-local-autopilot "PROJ-12345" # Jira
46
- /multi-agent:dev-local-autopilot "Add retry to HomeNetworking" # Free-text
11
+ /multi-agent:dev-local-autopilot has been removed. "Fast plus unattended" no
12
+ longer exists as a combination.
13
+ 1. /multi-agent:local-autopilot - unattended, full pipeline, no worktree
14
+ 2. /multi-agent:local - short pipeline, but asks the depth question
47
15
  ```
48
- ## Intake warnings (`--dev` family)
49
-
50
- Two checks belong at the top of every `--dev` run and are specified once in `$HOME/.claude/multi-agent-refs/phases/modes.md` "Intake warnings shared by the whole `--dev` family": an analysis document supplied to a mode that skips Analysis and Planning, and a branch that already carries the work (which wants `/multi-agent:resume-local`, not a second Dev pass). Read that section rather than reasoning about it from scratch.
51
-
52
- ## Required: outward-facing payload contracts
53
-
54
- Before writing anything outward-facing - PR body, Jira comment, Confluence page, closing report - load `$HOME/.claude/multi-agent-refs/payload-contracts.md`. It names the canonical section set for each payload, the markup dialect per surface (PR body is Markdown, Jira is wiki markup - mixing them is a defect), and the token/duration numbers the closing report must carry. Improvising a payload shape from memory is the most common failure of the short modes.
55
-
56
- ## Required: Phase Tracker Contract
57
-
58
- **The phase tracker is mandatory** - the agent cannot skip it. Full spec: [`$HOME/.claude/multi-agent-refs/tracker-contract.md`]($HOME/.claude/multi-agent-refs/tracker-contract.md).
59
-
60
- > **Autopilot mode:** user confirmations are skipped. The tracker is still mandatory - autopilot agent calls cannot skip it; skipping breaks `smoke-tracker-contract.sh`.
61
-
62
- > **Local mode:** no worktree is created, work happens on the current branch. Phase 0 Init still calls `init` - the `--local` flag is stored in tracker-state.json, and `:resume` restores the correct CWD.
63
16
 
64
- Two channels run in parallel at every phase boundary:
17
+ If a cron job or script calls this name it needs editing, and the two options trade differently: option 1 stays unattended and will take longer and cost more per run, option 2 stays fast and needs a person.
65
18
 
66
- 1. **State channel** (every CLI, identical): `phase-tracker.sh` writes to `tracker-state.json`. Drives `:resume`, `:log`, `:status`.
67
- 2. **Visual channel** (CLI-specific): native widget on Claude Code, ANSI render on every other CLI. Without it the user sees no phase progress.
68
-
69
- ```bash
70
- # Phase 0, very first shell call (every CLI):
71
- bash $HOME/.claude/scripts/phase-tracker.sh init "$TASK_ID"
72
- for p in "0:Init" "3:Dev" "4:Review" "6:Commit" "7:Report"; do
73
- bash $HOME/.claude/scripts/phase-tracker.sh add "${p%%:*}" "${p#*:}"
74
- done
75
- bash $HOME/.claude/scripts/phase-tracker.sh update 0 in_progress
76
-
77
- # Every phase boundary (every CLI):
78
- bash $HOME/.claude/scripts/phase-tracker.sh update <N> in_progress|completed|failed|skipped
79
-
80
- # After every LLM call (every CLI):
81
- bash $HOME/.claude/scripts/phase-tracker.sh tokens <N> <in> <out> [cached]
82
- ```
83
-
84
- ### Visual channel - Claude Code (native TaskList widget, required)
85
-
86
- In Claude Code the agent MUST also drive the native TaskList widget so the user sees a sticky phase tile stack - this is the only progress signal Claude Code surfaces. Skipping these calls is the #1 source of "I don't see any phases" complaints.
87
-
88
- **TaskCreate ordering (strict)**: All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied. The native widget renders by creation order, not by phase number - out-of-order calls produce visually scrambled tile stacks (e.g. `1 ✓ · 2 ✓ · 4 ✓ · 0 ▶ · 3 ☐`) even when the underlying state is correct. Pre-marking phases as completed/skipped before Phase 0 starts is FORBIDDEN - register the tile in order, then flip status via TaskUpdate when the phase actually short-circuits. Full contract in `$HOME/.claude/multi-agent-refs/tracker-contract.md` section "TaskCreate ordering (strict)".
89
-
90
- ```text
91
- # Phase 0 startup - register one tile per phase (0..N), capture the taskId, persist it:
92
- for each phase in 0:Init, 3:Dev, 4:Review, 6:Commit, 7:Report:
93
- TaskCreate({ subject: "Phase <N>: <Name>", activeForm: "<doing-form>" })
94
- -> returns taskId
95
- bash $HOME/.claude/scripts/phase-tracker.sh meta <N> tasklist_id "<taskId>"
96
-
97
- # Phase entry - flip the tile to in_progress alongside the state update:
98
- TaskUpdate({ taskId: <saved>, status: "in_progress" })
99
- bash $HOME/.claude/scripts/phase-tracker.sh update <N> in_progress
100
-
101
- # Active sub-step inside a phase - update activeForm so the spinner header reflects what's happening now:
102
- TaskUpdate({ taskId: <saved>, activeForm: "Editing TopBarView.swift" })
103
-
104
- # Phase exit - flip to completed/failed/skipped on both channels:
105
- TaskUpdate({ taskId: <saved>, status: "completed" })
106
- bash $HOME/.claude/scripts/phase-tracker.sh update <N> completed
107
- ```
108
-
109
- `--dev local autopilot` mode does NOT TaskCreate phases 1/2/5 - those are not part of the `--dev local autopilot` phase set (`0:Init 3:Dev 4:Review 6:Commit 7:Report`). Only register tiles for the active set.
110
-
111
- #### TaskCreate ordering (strict)
112
-
113
- **All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied.** For `--dev local autopilot` that means: Phase 0 → Phase 3 → Phase 4 → Phase 6 → Phase 7. The native widget renders by creation order, not by phase number - out-of-order calls produce visually scrambled tile stacks. Full ordering contract in `$HOME/.claude/multi-agent-refs/tracker-contract.md` section "TaskCreate ordering (strict)".
114
-
115
- ### Visual channel - Copilot CLI / plain shell
116
-
117
- These CLIs have no TaskList widget. After every state change the agent calls render, which prints a bordered ANSI card as the last tool result so the user sees an updated phase table:
118
-
119
- ```bash
120
- bash $HOME/.claude/scripts/phase-tracker.sh render
121
- ```
19
+ Print the block above and stop. Do not pick an entry on the user's behalf: the two options differ in what gets skipped and who is watching, and that is their call. Autopilot passed to this stub still stops here - a zero-interaction contract does not authorise choosing a different pipeline than the one that was asked for.
122
20
 
123
- Do NOT call TaskCreate on these CLIs - the tool does not exist and the call fails.
21
+ This stub exists so the old name fails loudly and usefully for one minor release instead of silently doing nothing. It is deleted in the next one.
@@ -55,22 +55,25 @@ Pipeline (after Phase 0) - shown as visual cards in terminal:
55
55
  Phase 0: Init -> The 8 steps above
56
56
  Phase 1: Analysis -> Stack detection + codebase scan (Fable)
57
57
  Phase 2: Planning -> Task breakdown + architecture review + Plan Approval Gate
58
- (clarification max 2 rounds + approval loop - normal mode only;
59
- skipped for --dev, autopilot, --dev autopilot)
58
+ (clarification max 2 rounds + approval loop - Full + interactive
59
+ only; a Short run has no plan, autopilot may not ask)
60
60
  Phase 3: Dev -> TDD: test -> code -> build (Sonnet) + build queue
61
61
  Phase 4: Review -> Deterministic gates + parallel AI review + Fable triage
62
62
  (Claude Code: Fable + Sonnet · Copilot CLI: GPT-5.4 + Opus + Sonnet)
63
63
  Phase 5: Test -> Optional: switch to branch, test in Xcode
64
- (runs in dev + full; skipped in every autopilot and local variant)
64
+ (only /multi-agent has it; every autopilot and local entry drops it)
65
65
  Phase 6: Commit -> Commit -> push -> PR + issue body update (never auto-closes)
66
66
  Phase 7: Report -> Channels dispatcher (PR · Jira · Confluence · Wiki, multi-select)
67
67
  + internal capture (agent-log · knowledge · memory)
68
68
 
69
69
  Autopilot always pauses at the Phase 7 channels menu (30-min timeout → session ends cleanly).
70
70
 
71
- --dev pipeline (Phases 1-2 skipped; Review is NEVER skipped):
72
- Init (same 8 steps), Dev with Opus, Review (same gates + triage),
73
- Test (skipped in autopilot / --local), Commit + Report (menu still pauses).
71
+ Pipeline depth is asked at Phase 0 Step 7.5, not passed as a flag:
72
+ Full Analysis -> Plan -> Dev(Sonnet) -> Review -> Test -> Commit -> Report
73
+ Short Dev(Opus, self-contained) -> Review -> Test -> Commit -> Report
74
+ Short skips Phases 1-2 only. Review is NEVER skipped.
75
+ Recommended from taskType: bugfix/chore -> Short, feature/refactor/component -> Full.
76
+ Autopilot never asks and always runs Full.
74
77
 
75
78
  Every step is logged. Error in any phase -> pause -> resume to continue.
76
79
 
@@ -78,25 +81,25 @@ Pipeline (after Phase 0) - shown as visual cards in terminal:
78
81
 
79
82
  Modes:
80
83
 
81
- (normal) Full 8 phases, Sonnet dev, Plan Approval Gate active, parallel review + Fable triage
82
- --dev Fast: Init -> Dev(Opus) -> Review -> Test -> Commit -> Report
83
- --local No worktree - works directly on local branch
84
- autopilot Skip all confirmations INCLUDING plan gate, auto commit/PR
85
- (EXCEPT Phase 7 channels menu - always pauses)
86
- --dev autopilot Fastest path
87
- --local --dev Local + fast (no worktree, no analysis/plan gate - review still runs)
88
-
89
- Dedicated commands (same as flags above):
90
-
91
- /multi-agent:dev "task" = multi-agent "task" --dev
92
- /multi-agent:autopilot "task" = multi-agent "task" autopilot
93
- /multi-agent:dev-autopilot "task" = multi-agent "task" --dev autopilot
94
- /multi-agent:local "task" = multi-agent "task" --local
95
- /multi-agent:local-autopilot "task" = multi-agent "task" --local autopilot
96
- /multi-agent:dev-local "task" = multi-agent "task" --dev --local
97
- /multi-agent:dev-local-autopilot "task" = multi-agent "task" --dev --local autopilot
84
+ Four pipeline entries:
85
+
86
+ /multi-agent "task" Worktree, asks Full or Short
87
+ /multi-agent:local "task" No worktree, asks Full or Short
88
+ /multi-agent:autopilot "task" Worktree, no questions, always Full
89
+ /multi-agent:local-autopilot "task" No worktree, no questions, always Full
90
+
91
+ --local on the base command is the same as the :local entry.
92
+ autopilot skips every confirmation INCLUDING the plan gate and the depth
93
+ question, and auto commit/PR - EXCEPT the Phase 7 channels menu, which
94
+ always pauses.
95
+
98
96
  /multi-agent:resume-local [jira-id] [autopilot] Continue already-done LOCAL work: Review → Build+Test → PR → Jira analysis + test scenarios (no dev)
99
97
 
98
+ Removed in v16.0.0:
99
+ :dev -> /multi-agent + Short · :dev-local -> :local + Short
100
+ :dev-autopilot and :dev-local-autopilot have no equivalent - fast plus
101
+ unattended is gone; pick unattended-and-Full or fast-and-attended.
102
+
100
103
  ------------------------------------------------------------
101
104
 
102
105
  Status & Resume:
@@ -132,7 +135,7 @@ Post-Hoc & Side-Channel:
132
135
  /multi-agent:testflight-validation [repo] [--ipa=|--archive=] iOS-pinned alias of :store-ready, kept because it is
133
136
  the name you reach for when the target is TestFlight. Same three gates, one implementation.
134
137
  /multi-agent:ios-coding-standard [module] Audit an iOS module against the 99-rule coding-standard registry -> remediation
135
- plan + one-page onboarding summary -> hand off to dev / dev-local. Read-only, never edits source.
138
+ plan + one-page onboarding summary -> hand off to /multi-agent or :local. Read-only, never edits source.
136
139
 
137
140
  Setup & Maintenance:
138
141
 
@@ -166,7 +169,7 @@ Interactive Launchers:
166
169
 
167
170
  Both follow the same flow after selection:
168
171
  1. Branch selection (develop/release/main)
169
- 2. Mode: full pipeline or --dev
172
+ 2. Depth: Full or Short
170
173
  3. Autopilot: yes/no
171
174
  4. Pipeline starts with the selected issue
172
175
 
@@ -267,17 +270,17 @@ Examples:
267
270
  /multi-agent "MOBILE-12345"
268
271
 
269
272
  # GitHub issue, fast mode, local
270
- /multi-agent "#42" --dev --local
273
+ /multi-agent:local "#42" # then choose Short
271
274
 
272
275
  # Interactive launchers - browse and pick
273
276
  /multi-agent:jira # Pick from my Jira issues
274
277
  /multi-agent:issue # Pick from unassigned GitHub issues
275
278
 
276
279
  # Free-text - any platform
277
- /multi-agent "LoginView dark mode fix" --dev autopilot # iOS
280
+ /multi-agent:autopilot "LoginView dark mode fix" # iOS
278
281
  /multi-agent "Add pagination to /api/users endpoint" # Backend
279
282
  /multi-agent "Fix bottom nav recomposition in HomeScreen" # Android
280
- /multi-agent "Responsive layout broken on tablet" --dev # Frontend
283
+ /multi-agent "Responsive layout broken on tablet" # Frontend, choose Short
281
284
 
282
285
  # Review current diff only
283
286
  /multi-agent:review
@@ -328,22 +331,25 @@ Pipeline (Phase 0'dan sonra) - terminalde görsel kart olarak görünür:
328
331
  Phase 0: Init -> Yukarıdaki 8 adım
329
332
  Phase 1: Analysis -> Stack tespiti + codebase taraması (Fable)
330
333
  Phase 2: Planning -> Task kırılımı + mimari inceleme + Plan Onay Kapısı
331
- (clarification max 2 tur + onay döngüsü - sadece normal mode;
332
- --dev, autopilot, --dev autopilot'ta skip)
334
+ (clarification max 2 tur + onay döngüsü - sadece Tam +
335
+ etkileşimli; Kısa'da plan yok, autopilot soru soramaz)
333
336
  Phase 3: Dev -> TDD: test -> kod -> build (Sonnet) + build queue
334
337
  Phase 4: Review -> Deterministik kapılar + paralel AI review + Fable triage
335
338
  (Claude Code: Fable + Sonnet · Copilot CLI: GPT-5.4 + Opus + Sonnet)
336
339
  Phase 5: Test -> Opsiyonel: branch'e geç, Xcode'da test
337
- (dev + full'de koşar; her autopilot ve local varyantında skip)
340
+ (yalnız /multi-agent'ta var; her autopilot ve local girişi düşürür)
338
341
  Phase 6: Commit -> Commit -> push -> PR + issue body güncelleme (hiç auto-close yok)
339
342
  Phase 7: Report -> Channels dispatcher (PR · Jira · Confluence · Wiki, multi-select)
340
343
  + internal capture (agent-log · knowledge · memory)
341
344
 
342
345
  Autopilot Phase 7'deki channels menüsünde HER ZAMAN durur (30 dk timeout → session temiz biter).
343
346
 
344
- --dev pipeline'ı (Faz 1-2 atlanır; Review ASLA atlanmaz):
345
- Init (aynı 8 adım), Dev Opus ile, Review (aynı kapılar + triage),
346
- Test (autopilot / --local'de atlanır), Commit + Report (menü yine durur).
347
+ Pipeline derinliği Faz 0 Adım 7.5'te sorulur, bayrakla geçilmez:
348
+ Tam Analiz -> Plan -> Dev(Sonnet) -> Review -> Test -> Commit -> Report
349
+ Kısa Dev(Opus, kendi kendine yeten) -> Review -> Test -> Commit -> Report
350
+ Kısa yalnız Faz 1-2'yi atlar. Review ASLA atlanmaz.
351
+ taskType'a göre önerilir: bugfix/chore -> Kısa, feature/refactor/component -> Tam.
352
+ Autopilot hiç sormaz, her zaman Tam koşar.
347
353
 
348
354
  Her adım loglanır. Herhangi bir fazdaki hata -> pause -> resume ile devam et.
349
355
 
@@ -351,25 +357,24 @@ Pipeline (Phase 0'dan sonra) - terminalde görsel kart olarak görünür:
351
357
 
352
358
  Modlar:
353
359
 
354
- (normal) Tam 8 faz, Sonnet dev, Plan Onay Kapısı aktif, paralel review + Fable triage
355
- --dev Hızlı: Init -> Dev(Opus) -> Review -> Test -> Commit -> Report
356
- --local Worktree yok - doğrudan local branch'te çalışır
357
- autopilot Plan gate dahil tüm onayları atla, otomatik commit/PR
358
- (İSTİSNA: Phase 7 channels menüsü - her zaman durur)
359
- --dev autopilot En hızlı yol
360
- --local --dev Local + hızlı (worktree yok, analiz/plan gate yok - review yine koşar)
361
-
362
- Dedicated komutlar (yukarıdaki flag'lerin eşdeğeri):
363
-
364
- /multi-agent:dev "task" = multi-agent "task" --dev
365
- /multi-agent:autopilot "task" = multi-agent "task" autopilot
366
- /multi-agent:dev-autopilot "task" = multi-agent "task" --dev autopilot
367
- /multi-agent:local "task" = multi-agent "task" --local
368
- /multi-agent:local-autopilot "task" = multi-agent "task" --local autopilot
369
- /multi-agent:dev-local "task" = multi-agent "task" --dev --local
370
- /multi-agent:dev-local-autopilot "task" = multi-agent "task" --dev --local autopilot
360
+ Dört pipeline girişi:
361
+
362
+ /multi-agent "task" Worktree var, Tam mı Kısa mı diye sorar
363
+ /multi-agent:local "task" Worktree yok, Tam mı Kısa mı diye sorar
364
+ /multi-agent:autopilot "task" Worktree var, soru yok, her zaman Tam
365
+ /multi-agent:local-autopilot "task" Worktree yok, soru yok, her zaman Tam
366
+
367
+ Ana komuta --local eklemek :local girişiyle aynıdır.
368
+ autopilot plan kapısı ve derinlik sorusu dahil her onayı atlar, otomatik
369
+ commit/PR açar - İSTİSNA: Faz 7 channels menüsü, o her zaman durur.
370
+
371
371
  /multi-agent:resume-local [jira-id] [autopilot] Lokalde biten işi sürdür: Review → Build+Test → PR → Jira teknik analiz + test senaryoları (dev yok)
372
372
 
373
+ v16.0.0'da kaldırılanlar:
374
+ :dev -> /multi-agent + Kısa · :dev-local -> :local + Kısa
375
+ :dev-autopilot ve :dev-local-autopilot'un karşılığı yok - hızlı+gözetimsiz
376
+ bitti; ya gözetimsiz-ve-Tam ya hızlı-ve-insan-başında seçilir.
377
+
373
378
  ------------------------------------------------------------
374
379
 
375
380
  Status & Resume:
@@ -405,7 +410,7 @@ Post-Hoc & Side-Channel:
405
410
  /multi-agent:testflight-validation [repo] [--ipa=|--archive=] :store-ready'nin iOS'a sabitlenmiş alias'ı; hedef
406
411
  TestFlight olduğunda akla gelen isim olduğu için korunuyor. Aynı 3 kapı, tek implementasyon.
407
412
  /multi-agent:ios-coding-standard [modül] Bir iOS modülünü 99 kurallık kodlama-standardı registry'sine göre denetler -> düzeltme
408
- planı + tek sayfalık onboarding özeti -> dev / dev-local'e devreder. Read-only, kaynağı hiç düzenlemez.
413
+ planı + tek sayfalık onboarding özeti -> /multi-agent veya :local'e devreder. Read-only, kaynağı hiç düzenlemez.
409
414
 
410
415
  Setup & Maintenance:
411
416
 
@@ -440,7 +445,7 @@ Rutinler (kendi tekrar eden işlerin):
440
445
 
441
446
  İkisi de seçim sonrası aynı akışı takip eder:
442
447
  1. Branch seçimi (develop/release/main)
443
- 2. Mode: tam pipeline ya da --dev
448
+ 2. Derinlik: Tam ya da Kısa
444
449
  3. Autopilot: evet/hayır
445
450
  4. Pipeline seçilen issue ile başlar
446
451
 
@@ -541,17 +546,17 @@ Quality & Telemetry (advisory, default açık - prefs.global.* ile kapatılabi
541
546
  /multi-agent "MOBILE-12345"
542
547
 
543
548
  # GitHub issue, hızlı mode, local
544
- /multi-agent "#42" --dev --local
549
+ /multi-agent:local "#42" # sonra Kısa seç
545
550
 
546
551
  # İnteraktif launcher'lar - göz at ve seç
547
552
  /multi-agent:jira # Jira issue'larımdan seç
548
553
  /multi-agent:issue # Atanmamış GitHub issue'lardan seç
549
554
 
550
555
  # Serbest metin - herhangi bir platform
551
- /multi-agent "LoginView dark mode fix" --dev autopilot # iOS
556
+ /multi-agent:autopilot "LoginView dark mode fix" # iOS
552
557
  /multi-agent "Add pagination to /api/users endpoint" # Backend
553
558
  /multi-agent "Fix bottom nav recomposition in HomeScreen" # Android
554
- /multi-agent "Responsive layout broken on tablet" --dev # Frontend
559
+ /multi-agent "Responsive layout broken on tablet" # Frontend, Kısa seç
555
560
 
556
561
  # Sadece mevcut diff'i review et
557
562
  /multi-agent:review
@@ -236,8 +236,10 @@ Show a concise version of the plan to the user too.
236
236
 
237
237
  | Option | What it does |
238
238
  |---|---|
239
- | `/multi-agent:dev-local` | No worktree; branches from the main development branch, fixes on the current checkout |
240
- | `/multi-agent:dev` | Opens a worktree; Opus fixes on a fresh branch + PR |
239
+ | `/multi-agent:local` | No worktree; branches from the main development branch, fixes on the current checkout |
240
+ | `/multi-agent` | Opens a worktree; fixes on a fresh branch + PR |
241
+
242
+ Both ask Full or Short at Phase 0 Step 7.5; a standards sweep is usually already scoped, so Short is the common answer.
241
243
 
242
244
  Invoke the chosen command with the plan file as the task input, branching off the repo's main
243
245
  development branch (e.g. `chore/<module>-coding-standard`). The dev pipeline applies the fixes,
@@ -21,10 +21,8 @@ Run the full pipeline **without a worktree** and **with every confirmation skipp
21
21
  | `/multi-agent:autopilot "task"` | 7 phases (no User Test) | ✅ | ❌ (autopilot) |
22
22
  | `/multi-agent:local "task"` | 7 phases (no User Test) | ❌ | ✅ (interactive) |
23
23
  | **`/multi-agent:local-autopilot "task"`** | **7 phases (no User Test)** | **❌** | **❌ (autopilot)** |
24
- | `/multi-agent:dev "task"` | Init → Dev → Review → Test → Commit → Report | ✅ | ✅ |
25
- | `/multi-agent:dev-autopilot "task"` | Init → Dev → Review → Commit → Report | ✅ | ❌ |
26
- | `/multi-agent:dev-local "task"` | Init → Dev → Review → Commit → Report | ❌ | ✅ |
27
- | `/multi-agent:dev-local-autopilot "task"` | Init → Dev → Review → Commit → Report | ❌ | ❌ (fastest) |
24
+
25
+ Depth is a separate axis, asked at Phase 0 Step 7.5 rather than encoded in the command name: Full runs every phase above, Short runs Dev → Review → Test → Commit → Report. The two autopilot rows never ask and always run Full.
28
26
 
29
27
  ## What changes
30
28
 
@@ -42,7 +42,7 @@ Plan bands (all five feed the single Step 4 table):
42
42
  Do not copy features blindly. The goal is the best *approaches*, reshaped so they are applicable to THIS project's stack, size, and constraints.
43
43
 
44
44
  1. **Identify the domain** of the current project (read README + package/build manifests): what kind of project is it (CLI, SDK, app, pipeline, library), what stack, who uses it.
45
- 2. **Research the best-in-class** for that exact domain:
45
+ 2. **Research the best-in-class** for that exact domain. When `ai-analyst-toolkit` is enabled, run the first three bullets through its skills (`evidence-github`, `evidence-registry`, `signal-community`) rather than ad-hoc searching: they carry the query forms and the citation format, and they keep the evidence / signal line straight - a GitHub PR is a fact, a forum thread is one person's experience. Not enabled is a recorded no-op and the manual searches below still apply.
46
46
  - **GitHub**: search the domain terms + `stars:>50`; read the top repos' READMEs, architecture docs, CI configs, test layout.
47
47
  - **X / Twitter**: search the domain terms + "best practices" / "we switched to" / "lesson learned"; capture what practitioners and tool authors actually recommend right now (WebFetch/WebSearch on `x.com` / `twitter.com` threads).
48
48
  - **Reddit**: relevant subreddits for real-world pain points and adopted patterns.
@@ -8,7 +8,7 @@ allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdat
8
8
 
9
9
  > **Language (read FIRST)**: Before any status output, read `prefs.global.outputLanguage` and render every conversational line in it. `AskUserQuestion` `label`/`header` stay English, but its `question` and option `description`s render in `outputLanguage`; external payload bodies follow `outputLanguage` too (identifiers, commit messages, branch names stay English). Full contract: `$HOME/.claude/multi-agent-refs/rules.md` "Language Application".
10
10
 
11
- You already did the work locally - wrote code on the current branch and maybe tested it by hand, or committed it outside the pipeline entirely. (As of v14.0.0 the `--dev` family reviews its own output, so this command is for work that had no pipeline run behind it, not a patch for a mode that skipped review.) `/multi-agent:resume-local` picks up from there and runs the **pipeline tail** over that existing local work in one command: parallel review, a build + test success gate, commit/push + PR, then the technical analysis and a **Jira comment with test scenarios**. It does NOT re-develop - Analysis / Planning / Dev (phases 1-3) are intentionally skipped; the diff already on the branch IS the input.
11
+ You already did the work locally - wrote code on the current branch and maybe tested it by hand, or committed it outside the pipeline entirely. (As of v14.0.0 a Short run reviews its own output, so this command is for work that had no pipeline run behind it, not a patch for a mode that skipped review.) `/multi-agent:resume-local` picks up from there and runs the **pipeline tail** over that existing local work in one command: parallel review, a build + test success gate, commit/push + PR, then the technical analysis and a **Jira comment with test scenarios**. It does NOT re-develop - Analysis / Planning / Dev (phases 1-3) are intentionally skipped; the diff already on the branch IS the input.
12
12
 
13
13
  ## When to use it
14
14
 
@@ -18,7 +18,7 @@ You already did the work locally - wrote code on the current branch and maybe
18
18
 
19
19
  ## When NOT to use it
20
20
 
21
- - You haven't written the change yet - use `/multi-agent`, `/multi-agent:local`, or `/multi-agent:dev-local`.
21
+ - You haven't written the change yet - use `/multi-agent` or `/multi-agent:local`.
22
22
  - You only want the review, nothing else - use `/multi-agent:review`. Only the report/channels - `/multi-agent:channels`. Only device UI testing - `/multi-agent:test` / `/multi-agent:manual-test`.
23
23
 
24
24
  ## Input
@@ -106,7 +106,7 @@ No TaskList widget. After every state change call `bash $HOME/.claude/scripts/ph
106
106
  ## Examples
107
107
 
108
108
  ```bash
109
- /multi-agent:dev-local "PROJ-12345" # develop locally (Init→Dev→Commit→Report, no review/test)
109
+ /multi-agent:local "PROJ-12345" # develop locally, then answer Short at the depth question
110
110
  # ... you inspect / hand-test the change ...
111
111
  /multi-agent:resume-local # now: review + build/test + PR + Jira analysis & test scenarios
112
112
  ```
@@ -828,13 +828,13 @@ Stack skills ship as versioned plugins in the `{owner}/multi-agent-plugins` mark
828
828
  ```bash
829
829
  claude marketplace add {owner}/multi-agent-plugins 2>/dev/null || true
830
830
  ```
831
- 2. Detect the project stack from markers and enable the matching plugin(s) plus the always-on common plugin in the project's `.claude/settings.json` `enabledPlugins`:
831
+ 2. Detect the project stack from markers and enable the matching plugin(s) plus the two always-on plugins in the project's `.claude/settings.json` `enabledPlugins`:
832
832
  - `.xcodeproj` / `Package.swift` / `*.xcworkspace` → `ai-ios-toolkit`
833
833
  - `build.gradle` / `settings.gradle` → `ai-android-toolkit`
834
834
  - `package.json` with `react`/`next` → `ai-frontend-toolkit`
835
835
  - `requirements.txt` / `pyproject.toml` / server `package.json` → `ai-backend-toolkit`
836
836
  - **no clear marker → default `ai-ios-toolkit`**
837
- `ai-common-toolkit@multi-agent-plugins` is always set `true` alongside the stack plugin.
837
+ `ai-common-toolkit@multi-agent-plugins` and `ai-analyst-toolkit@multi-agent-plugins` are always set `true` alongside the stack plugin: neither is stack-specific.
838
838
  3. Report the enabled set. To change later, run `/multi-agent:stack <ios|android|frontend|backend|...>` in the repo. Pipeline Phase 1 auto-detects the stack for its own routing regardless of enablement.
839
839
 
840
840
  The marketplace repo name (`multi-agent-plugins`) is generic; a different org points `{owner}` at its own fork - nothing in the pipeline is coupled to a specific account.