@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.
- package/CHANGELOG.md +124 -0
- package/README.md +2 -2
- package/README.tr.md +1 -2
- package/docs/architecture.md +2 -2
- package/docs/ecosystem.md +9 -6
- package/docs/features.md +2 -3
- package/install/_plugin-skills.mjs +28 -2
- package/install/templates/copilot-instructions.md +8 -7
- package/package.json +1 -1
- package/pipeline/commands/multi-agent/SKILL.md +5 -6
- package/pipeline/commands/multi-agent/analysis/SKILL.md +77 -588
- package/pipeline/commands/multi-agent/analysis-resolve/SKILL.md +5 -69
- package/pipeline/commands/multi-agent/channels/SKILL.md +1 -1
- package/pipeline/commands/multi-agent/complaint-analysis/SKILL.md +5 -4
- package/pipeline/commands/multi-agent/dev/SKILL.md +8 -280
- package/pipeline/commands/multi-agent/dev-autopilot/SKILL.md +12 -124
- package/pipeline/commands/multi-agent/dev-local/SKILL.md +8 -111
- package/pipeline/commands/multi-agent/dev-local-autopilot/SKILL.md +11 -113
- package/pipeline/commands/multi-agent/help/SKILL.md +61 -56
- package/pipeline/commands/multi-agent/ios-coding-standard/SKILL.md +4 -2
- package/pipeline/commands/multi-agent/local-autopilot/SKILL.md +2 -4
- package/pipeline/commands/multi-agent/refactor/SKILL.md +1 -1
- package/pipeline/commands/multi-agent/resume-local/SKILL.md +3 -3
- package/pipeline/commands/multi-agent/setup/SKILL.md +2 -2
- package/pipeline/commands/multi-agent/stack/SKILL.md +10 -9
- package/pipeline/commands/multi-agent/store-ready/SKILL.md +1 -1
- package/pipeline/commands/multi-agent/sync/SKILL.md +2 -2
- package/pipeline/commands/multi-agent/update/SKILL.md +1 -1
- package/pipeline/lib/context-link-extractor.sh +38 -0
- package/pipeline/lib/fetch-document.sh +190 -0
- package/pipeline/multi-agent-refs/_dev-context.md +4 -0
- package/pipeline/multi-agent-refs/analysis/evidence.md +213 -0
- package/pipeline/multi-agent-refs/analysis/intake.md +167 -0
- package/pipeline/multi-agent-refs/analysis/locked.md +53 -0
- package/pipeline/multi-agent-refs/analysis/render.md +133 -0
- package/pipeline/multi-agent-refs/analysis/resolve.md +76 -0
- package/pipeline/multi-agent-refs/analysis/synthesis.md +98 -0
- package/pipeline/multi-agent-refs/analysis-template.md +58 -11
- package/pipeline/multi-agent-refs/complaint-analysis-template.md +1 -1
- package/pipeline/multi-agent-refs/component-dispatch.md +5 -5
- package/pipeline/multi-agent-refs/cross-cli-contract.md +9 -7
- package/pipeline/multi-agent-refs/features/skill-conformance.md +1 -1
- package/pipeline/multi-agent-refs/features/url-enrichment.md +13 -3
- package/pipeline/multi-agent-refs/knowledge.md +2 -2
- package/pipeline/multi-agent-refs/payload-contracts.md +1 -1
- package/pipeline/multi-agent-refs/phases/modes.md +73 -53
- package/pipeline/multi-agent-refs/phases/phase-0-init.md +21 -2
- package/pipeline/multi-agent-refs/phases/phase-1-analysis.md +26 -0
- package/pipeline/multi-agent-refs/phases/phase-2-planning.md +26 -12
- package/pipeline/multi-agent-refs/phases/phase-3-dev.md +17 -18
- package/pipeline/multi-agent-refs/phases/phase-4-review.md +29 -7
- package/pipeline/multi-agent-refs/phases/phase-5-test.md +1 -1
- package/pipeline/multi-agent-refs/phases/phase-6-commit.md +8 -0
- package/pipeline/multi-agent-refs/phases/phase-7-report.md +1 -1
- package/pipeline/multi-agent-refs/phases.md +9 -7
- package/pipeline/multi-agent-refs/progress-contract.md +1 -1
- package/pipeline/multi-agent-refs/readiness-review.md +2 -0
- package/pipeline/multi-agent-refs/rules.md +2 -2
- package/pipeline/multi-agent-refs/tracker-contract.md +32 -13
- package/pipeline/multi-agent-refs/wiki-capture.md +2 -2
- package/pipeline/schemas/agent-state.schema.json +3 -3
- package/pipeline/schemas/analysis-output.schema.json +17 -0
- package/pipeline/schemas/analysis-spec.schema.json +69 -1
- package/pipeline/schemas/complaint-analysis-spec.schema.json +1 -1
- package/pipeline/schemas/prefs.schema.json +47 -0
- package/pipeline/schemas/token-budget.json +2 -2
- package/pipeline/scripts/_stack-routing.mjs +17 -12
- package/pipeline/scripts/build-stack-plugins.mjs +16 -6
- package/pipeline/scripts/cost-table.json +1 -1
- package/pipeline/scripts/gen-mode-dispatch.mjs +20 -30
- package/pipeline/scripts/run-aggregator.mjs +1 -1
- package/pipeline/scripts/validate-analysis-doc.mjs +36 -3
- package/pipeline/skills/.skills-index.json +40 -7
- package/pipeline/skills/shared/README.md +12 -9
- package/pipeline/skills/shared/core/multi-agent/SKILL.md +9 -5
- package/pipeline/skills/shared/core/multi-agent-dev/SKILL.md +7 -61
- package/pipeline/skills/shared/core/multi-agent-dev-autopilot/SKILL.md +11 -51
- package/pipeline/skills/shared/core/multi-agent-dev-local/SKILL.md +7 -33
- package/pipeline/skills/shared/core/multi-agent-dev-local-autopilot/SKILL.md +10 -38
- package/pipeline/skills/shared/core/multi-agent-help/SKILL.md +28 -18
- package/pipeline/skills/shared/core/multi-agent-ios-coding-standard/SKILL.md +4 -2
- package/pipeline/skills/shared/core/multi-agent-local-autopilot/SKILL.md +2 -4
- package/pipeline/skills/shared/core/multi-agent-refactor/SKILL.md +1 -1
- package/pipeline/skills/shared/core/multi-agent-resume-local/SKILL.md +2 -2
- package/pipeline/skills/shared/core/multi-agent-stack/SKILL.md +10 -9
- package/pipeline/skills/shared/core/multi-agent-sync/SKILL.md +2 -2
- package/pipeline/skills/shared/external/evidence-github/SKILL.md +45 -0
- package/pipeline/skills/shared/external/evidence-registry/SKILL.md +33 -0
- package/pipeline/skills/shared/external/signal-community/SKILL.md +44 -0
- package/pipeline/skills/skills-index.md +10 -7
|
@@ -1,120 +1,17 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "
|
|
3
|
-
description-tr: "
|
|
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 -
|
|
6
|
+
# multi-agent dev-local - Removed in v16.0.0
|
|
8
7
|
|
|
9
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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: "
|
|
3
|
-
description-tr: "
|
|
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 -
|
|
6
|
+
# multi-agent dev-local-autopilot - Removed in v16.0.0
|
|
8
7
|
|
|
9
|
-
|
|
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
|
-
|
|
24
|
-
|
|
25
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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 -
|
|
59
|
-
|
|
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
|
-
(
|
|
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
|
-
|
|
72
|
-
|
|
73
|
-
|
|
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
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
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
|
|
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.
|
|
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"
|
|
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"
|
|
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"
|
|
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
|
|
332
|
-
|
|
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
|
-
(
|
|
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
|
-
|
|
345
|
-
|
|
346
|
-
|
|
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
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
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 ->
|
|
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.
|
|
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"
|
|
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"
|
|
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"
|
|
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:
|
|
240
|
-
| `/multi-agent
|
|
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
|
-
|
|
25
|
-
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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`
|
|
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.
|