@mmerterden/multi-agent-pipeline 19.1.3 → 20.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 +150 -7
- package/README.md +60 -50
- package/README.tr.md +55 -46
- package/docs/adr/0002-instruction-driven-flag.md +6 -5
- package/docs/adr/0005-lazy-phase-docs.md +2 -2
- package/docs/adr/0008-installer-modularization-and-secret-leak-defense.md +1 -0
- package/docs/adr/0009-claude-stack-skills-plugin-only.md +1 -1
- package/docs/adr/0010-own-code-graph.md +5 -4
- package/docs/adr/0012-macos-only.md +2 -2
- package/docs/adr/0013-lsp-code-intelligence.md +2 -2
- package/docs/adr/0014-six-phase-consolidation.md +9 -9
- package/docs/adr/0015-one-pipeline-no-depth-answer.md +83 -0
- package/docs/adr/0016-the-run-shape-is-asked-not-typed.md +69 -0
- package/docs/adr/README.md +18 -16
- package/docs/architecture.md +2 -2
- package/docs/ecosystem.md +8 -9
- package/docs/facts.json +5 -8
- package/docs/features.md +4 -5
- package/docs/token-budget-history.md +1 -1
- package/install/_common.mjs +14 -6
- package/install/_mcp-register.mjs +1 -1
- package/install/_plugin-skills.mjs +3 -4
- package/install/copilot.mjs +5 -5
- package/install/templates/copilot-instructions.md +7 -16
- package/manifest.json +135 -138
- package/package.json +1 -1
- package/pipeline/commands/multi-agent/SKILL.md +6 -8
- package/pipeline/commands/multi-agent/analysis/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/analysis-jira/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/analysis-resolve/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/autopilot/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/autopilot-on/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/autopilot-status/SKILL.md +1 -1
- package/pipeline/commands/multi-agent/build-optimize/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/channels/SKILL.md +1 -1
- package/pipeline/commands/multi-agent/create-jira/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/design-check/SKILL.md +1 -1
- package/pipeline/commands/multi-agent/forget/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/garbage-collect/SKILL.md +4 -2
- package/pipeline/commands/multi-agent/help/SKILL.md +21 -27
- package/pipeline/commands/multi-agent/ios-coding-standard/SKILL.md +5 -4
- package/pipeline/commands/multi-agent/issue/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/jira/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/language/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/prune-logs/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/purge/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/resume/SKILL.md +177 -48
- package/pipeline/commands/multi-agent/save/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/setup/SKILL.md +4 -4
- package/pipeline/commands/multi-agent/stack/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/sync/SKILL.md +6 -7
- package/pipeline/commands/multi-agent/test-screenshots/SKILL.md +2 -0
- package/pipeline/commands/multi-agent/uninstall/SKILL.md +2 -0
- package/pipeline/commands/sim-test.md +4 -4
- package/pipeline/lib/repo-hygiene.sh +1 -1
- package/pipeline/multi-agent-refs/analysis/locked.md +2 -2
- package/pipeline/multi-agent-refs/analysis/render.md +1 -1
- package/pipeline/multi-agent-refs/analysis/resolve.md +1 -1
- package/pipeline/multi-agent-refs/analysis/synthesis.md +1 -1
- package/pipeline/multi-agent-refs/analysis-template.md +1 -1
- package/pipeline/multi-agent-refs/channels/jira.md +8 -8
- package/pipeline/multi-agent-refs/component-dispatch.md +0 -8
- package/pipeline/multi-agent-refs/cross-cli-contract.md +10 -11
- package/pipeline/multi-agent-refs/features/base-branch-evidence.md +2 -2
- package/pipeline/multi-agent-refs/features/external-context-injection.md +2 -0
- package/pipeline/multi-agent-refs/features/review-delta.md +1 -1
- package/pipeline/multi-agent-refs/features/review-multi-repo.md +3 -3
- package/pipeline/multi-agent-refs/features/scope-check.md +1 -1
- package/pipeline/multi-agent-refs/features/skill-conformance.md +1 -1
- package/pipeline/multi-agent-refs/features/stack-skill-routing.md +1 -1
- package/pipeline/multi-agent-refs/features/visual-evidence.md +2 -1
- package/pipeline/multi-agent-refs/features/worktree-finalize.md +1 -1
- package/pipeline/multi-agent-refs/generate-issue.md +2 -0
- package/pipeline/multi-agent-refs/issue-jira-triad.md +2 -0
- package/pipeline/multi-agent-refs/keychain.md +2 -0
- package/pipeline/multi-agent-refs/knowledge.md +0 -7
- package/pipeline/multi-agent-refs/outside-the-pipeline.md +1 -1
- package/pipeline/multi-agent-refs/payload-contracts.md +1 -1
- package/pipeline/multi-agent-refs/phases/modes.md +32 -108
- package/pipeline/multi-agent-refs/phases/operations.md +3 -1
- package/pipeline/multi-agent-refs/phases/phase-0-init.md +23 -42
- package/pipeline/multi-agent-refs/phases/phase-1-plan.md +10 -21
- package/pipeline/multi-agent-refs/phases/phase-2-dev.md +13 -44
- package/pipeline/multi-agent-refs/phases/phase-3-review.md +19 -22
- package/pipeline/multi-agent-refs/phases/phase-4-commit.md +6 -6
- package/pipeline/multi-agent-refs/phases/phase-5-report.md +2 -2
- package/pipeline/multi-agent-refs/phases.md +9 -11
- 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 +9 -40
- package/pipeline/multi-agent-refs/wiki-capture.md +3 -2
- package/pipeline/preferences-template.json +2 -2
- package/pipeline/rules/figma-pipeline.md +1 -1
- package/pipeline/schemas/agent-state.schema.json +5 -10
- package/pipeline/schemas/migrations/prefs-2.7.0-to-2.8.0.mjs +33 -0
- package/pipeline/schemas/phases.json +3 -24
- package/pipeline/schemas/prefs.schema.json +5 -5
- package/pipeline/scripts/autopilot-runner.mjs +6 -7
- package/pipeline/scripts/build-references.mjs +3 -3
- package/pipeline/scripts/build-stack-plugins.mjs +1 -1
- package/pipeline/scripts/bulk-read.sh +6 -4
- package/pipeline/scripts/cost-table.json +1 -1
- package/pipeline/scripts/doctor.mjs +4 -4
- package/pipeline/scripts/gc-refs.sh +1 -1
- package/pipeline/scripts/gen-mode-dispatch.mjs +11 -41
- package/pipeline/scripts/learnings-ledger.mjs +1 -1
- package/pipeline/scripts/match-skills.mjs +4 -4
- package/pipeline/scripts/memory-load.sh +3 -3
- package/pipeline/scripts/migrate-prefs.mjs +18 -17
- package/pipeline/scripts/phase-tracker.sh +2 -2
- package/pipeline/scripts/phase0-exit-gate.mjs +1 -1
- package/pipeline/scripts/plan-coverage-gate.mjs +6 -6
- package/pipeline/scripts/run-aggregator.mjs +3 -3
- package/pipeline/scripts/runs-index.mjs +7 -7
- package/pipeline/scripts/scope-check-gate.mjs +1 -1
- package/pipeline/scripts/smoke-schema-validation.sh +9 -12
- package/pipeline/scripts/usage-report.mjs +5 -7
- package/pipeline/scripts/validate-analysis-doc.mjs +3 -3
- package/pipeline/scripts/worktree-finalize.sh +2 -2
- package/pipeline/scripts/write-state.mjs +22 -11
- package/pipeline/skills/.skill-manifest.json +9 -21
- package/pipeline/skills/.skills-index.json +6 -39
- package/pipeline/skills/shared/README.md +5 -8
- package/pipeline/skills/shared/core/multi-agent/SKILL.md +10 -13
- package/pipeline/skills/shared/core/multi-agent-autopilot-status/SKILL.md +1 -1
- package/pipeline/skills/shared/core/multi-agent-channels/SKILL.md +4 -5
- package/pipeline/skills/shared/core/multi-agent-help/SKILL.md +13 -16
- package/pipeline/skills/shared/core/multi-agent-ios-coding-standard/SKILL.md +2 -3
- package/pipeline/skills/shared/core/multi-agent-resume/SKILL.md +51 -15
- package/pipeline/skills/shared/core/multi-agent-sync/SKILL.md +6 -6
- package/pipeline/skills/skills-index.md +3 -6
- package/pipeline/commands/multi-agent/local/SKILL.md +0 -132
- package/pipeline/commands/multi-agent/local-autopilot/SKILL.md +0 -142
- package/pipeline/commands/multi-agent/resume-local/SKILL.md +0 -114
- package/pipeline/skills/shared/core/multi-agent-local/SKILL.md +0 -41
- package/pipeline/skills/shared/core/multi-agent-local-autopilot/SKILL.md +0 -55
- package/pipeline/skills/shared/core/multi-agent-resume-local/SKILL.md +0 -51
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mmerterden/multi-agent-pipeline",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "20.0.0",
|
|
4
4
|
"description": "6-phase AI development pipeline with full orchestration on Claude Code, Copilot CLI and Codex CLI. Analysis, planning, TDD, CLI-aware parallel review with consensus surfacing + Fable triage, default-FAIL evidence gates, secret + intent guards, per-phase cost ledger, persistent learnings memory, wiki generation, commit automation. Token-preserving uninstall.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "index.js",
|
|
@@ -6,6 +6,8 @@ allowed-tools: Agent, Bash, Read, Write, Edit, Glob, Grep, TaskCreate, TaskUpdat
|
|
|
6
6
|
|
|
7
7
|
# Multi-Agent Task Orchestrator
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
> **MUST: Figma MCP is BLOCKING for any task with a Figma reference.** Before any UI synthesis runs in this pipeline (analysis, planning, dev, or rework), call `mcp__claude_ai_Figma__get_design_context` for every referenced frame and use the `CodeConnectSnippet` component name verbatim. Backend-only tasks are exempt. See `$HOME/.claude/multi-agent-refs/rules.md` "User Interaction Discipline" and `$HOME/.claude/rules/figma-pipeline.md` "MUST: Figma MCP-first (BLOCKING)".
|
|
10
12
|
|
|
11
13
|
Parse the user input and route to the correct sub-command.
|
|
@@ -90,7 +92,6 @@ Lib scripts (`~/.claude/lib/`):
|
|
|
90
92
|
| `stack [ios\|android\|backend\|mobile\|all]` | Swap skills for next conversation. No arg = show current stack. |
|
|
91
93
|
| `language [en\|tr]` | Show or set the assistant `outputLanguage` (explanations and chat replies). `promptLanguage` is locked to `en` and is not toggleable. No arg = show current `outputLanguage`. With `en` or `tr` = set and persist `outputLanguage`. External payloads (commits, PR bodies, Jira) stay English. |
|
|
92
94
|
| `setup` | Keychain token + Git Identity onboarding |
|
|
93
|
-
| `--local` | No worktree - works directly on local branch |
|
|
94
95
|
| `autopilot` | Skip user confirmations, auto commit/PR |
|
|
95
96
|
| No args / `help` | Show usage guide |
|
|
96
97
|
|
|
@@ -121,8 +122,6 @@ This command uses lazy loading for token efficiency. Read the relevant sub-file
|
|
|
121
122
|
| `analysis` | `$HOME/.claude/commands/multi-agent/analysis/SKILL.md` |
|
|
122
123
|
| `complaint-analysis` | `$HOME/.claude/commands/multi-agent/complaint-analysis/SKILL.md` |
|
|
123
124
|
| `build-optimize` | `$HOME/.claude/commands/multi-agent/build-optimize/SKILL.md` |
|
|
124
|
-
| `local` | `$HOME/.claude/commands/multi-agent/local/SKILL.md` |
|
|
125
|
-
| `local-autopilot` | `$HOME/.claude/commands/multi-agent/local-autopilot/SKILL.md` |
|
|
126
125
|
| `create-jira` | `$HOME/.claude/commands/multi-agent/create-jira/SKILL.md` (loads `$HOME/.claude/multi-agent-refs/generate-issue.md`) |
|
|
127
126
|
| `stack` | `$HOME/.claude/commands/multi-agent/stack/SKILL.md` |
|
|
128
127
|
| `language` | Handled inline - set/show prompt language in preferences |
|
|
@@ -138,7 +137,7 @@ This command uses lazy loading for token efficiency. Read the relevant sub-file
|
|
|
138
137
|
| `manual-test` | `$HOME/.claude/commands/multi-agent/manual-test/SKILL.md` |
|
|
139
138
|
| `design-check` | `$HOME/.claude/commands/multi-agent/design-check/SKILL.md` |
|
|
140
139
|
|
|
141
|
-
**Modifier
|
|
140
|
+
**Modifier flag** (`autopilot`) and **ops** (`status`, `log`, `resume`, `kill`, `purge`, `review`) are parsed inline by this file - no separate spec files, they compose with the pipeline or do one-shot work.
|
|
142
141
|
|
|
143
142
|
**How**: After routing, `Read` the relevant file and follow its instructions. Only load what the current action needs.
|
|
144
143
|
|
|
@@ -228,10 +227,9 @@ Save to `prefs.projects[{project}].branches`.
|
|
|
228
227
|
|
|
229
228
|
### Step 2 - Mode Selection
|
|
230
229
|
```
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
Select [1/2]:
|
|
230
|
+
One pipeline, 6 phases, Sonnet dev, parallel review + triage (CLI-aware
|
|
231
|
+
reviewer set). The questions Phase 0 asks are the workspace and autopilot,
|
|
232
|
+
never how much of the pipeline runs.
|
|
235
233
|
```
|
|
236
234
|
|
|
237
235
|
### Step 3 - Autopilot
|
|
@@ -6,6 +6,8 @@ argument-hint: "[\"<analysis-name>\"] [--no-cache] [--preview-conventions]"
|
|
|
6
6
|
|
|
7
7
|
# multi-agent analysis - Feature Spec Analysis (v3)
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
This command is **independent** from the orchestrator's Phase 1 analysis (which is a stack/findings detector inside `/multi-agent`). It produces a stakeholder-ready, platform-agnostic feature-spec document - up to 23 sections, trimmed to whatever the evidence supports - before any implementation starts. Each per-platform file is rendered by projecting concept-layer content onto repo-extracted conventions (Pass B).
|
|
10
12
|
|
|
11
13
|
**Side-effect contract**: the command may write a local markdown file, post a Confluence page, or update a Jira description - but **never** creates branches, worktrees, commits, or PRs. It stops at the document.
|
|
@@ -8,6 +8,8 @@ not-for: create-jira, jira
|
|
|
8
8
|
|
|
9
9
|
# multi-agent analysis-jira
|
|
10
10
|
|
|
11
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
12
|
+
|
|
11
13
|
**Input**: $ARGUMENTS
|
|
12
14
|
|
|
13
15
|
Reads an analysis document as a work breakdown and creates the tree. It never
|
|
@@ -6,6 +6,8 @@ argument-hint: "[path/to/analysis/<feature>-<platform>.md] [--autonomous]"
|
|
|
6
6
|
|
|
7
7
|
# multi-agent analysis-resolve - Open Question Resolver for Analysis Docs
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
Companion command to `/multi-agent:analysis`. Takes an `analysis/<feature>-<platform>.md` (template v3) and walks the user through the open rows of Section 20 (Riskler ve Acik Sorular / Risks and Open Questions) one row at a time, proposing source-labeled answer candidates and merging the chosen answer into the proper body section. The pattern follows a spec-resolver approach (walk the open rows, propose source-labeled answer candidates, merge the chosen answer) adapted to the analysis doc contract.
|
|
10
12
|
|
|
11
13
|
**Core invariant - read this twice:** the analysis doc is authoritative and forward-looking. The resolver never invents an answer; if no source produces a credible candidate, the only options offered are Defer and Other. Each Section 20 row is its own decision; never blend candidates across rows.
|
|
@@ -6,6 +6,8 @@ argument-hint: '"task" - issue URL, Jira ID, free-text, or #id (for resume)'
|
|
|
6
6
|
|
|
7
7
|
# multi-agent autopilot - Autonomous Pipeline
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
**Input**: $ARGUMENTS
|
|
10
12
|
|
|
11
13
|
> **Language (read FIRST)**: Before any status output, read `prefs.global.outputLanguage` and render every conversational line in it. `AskUserQuestion` renders its `question`, option `label`s and option `description`s in `outputLanguage`; only `header` stays English (<=12-char chip); external payload bodies follow `outputLanguage` too (identifiers, commit messages, branch names stay English). Full contract: `$HOME/.claude/multi-agent-refs/rules.md` "Language Application".
|
|
@@ -6,6 +6,8 @@ argument-hint: "(no arguments - opens the repo picker)"
|
|
|
6
6
|
|
|
7
7
|
# multi-agent autopilot-on - continuous mode, on this machine
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
Turns on the mode that picks work up without being asked. **No repo is included
|
|
10
12
|
by default and none is ever added implicitly** - you choose, here, every time.
|
|
11
13
|
|
|
@@ -34,7 +34,7 @@ not a fault.
|
|
|
34
34
|
|
|
35
35
|
When `swiftc` was available at `autopilot-on` time, `~/.claude/autopilot/bin/menubar`
|
|
36
36
|
shows the same thing in the top right, refreshing on its own: one row per item
|
|
37
|
-
with its id,
|
|
37
|
+
with its id, the phase as a fraction, the
|
|
38
38
|
elapsed time and the stack, then the queue, then what is waiting, then the PRs of
|
|
39
39
|
the last day - each one clickable.
|
|
40
40
|
|
|
@@ -6,6 +6,8 @@ argument-hint: "(none - operates on current repo)"
|
|
|
6
6
|
|
|
7
7
|
# multi-agent build-optimize - Xcode Build Performance Wrapper
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
Wraps the vendored `xcode-build-orchestrator` skill (and its 5 specialist analyzers) so iOS users do not have to remember the orchestrator skill name. Recommend-first: no project files are modified without explicit developer approval. All output lands in `.build-benchmark/` in the current repo.
|
|
10
12
|
|
|
11
13
|
> **Language**: Per `$HOME/.claude/multi-agent-refs/rules.md` Language Application matrix - instruction prose stays English (this file is read as a system prompt). `AskUserQuestion.question`, `.options[].label` and `.options[].description` follow `outputLanguage`; only `header` stays English (<=12-char chip). The emitted benchmark plan body (the upstream skill controls it) is English by upstream convention.
|
|
@@ -355,7 +355,7 @@ Applying the Jira table to the PR body is the recurring failure of this step: it
|
|
|
355
355
|
|
|
356
356
|
Secondary artifacts ride along as one-line intents at the bottom of the preview: Wiki page list, wiki → Jira triad comment (when Wiki is selected and the triad is active per `$HOME/.claude/multi-agent-refs/issue-jira-triad.md`), Board status move (`{from} → {to}`), GitHub issue comment + Progress-flag sync (Phase 5 Step 1.5 - same gate, see `$HOME/.claude/multi-agent-refs/phases/phase-5-report.md`).
|
|
357
357
|
|
|
358
|
-
**Then a single AskUserQuestion** (`question`/`label`/`description` in `outputLanguage
|
|
358
|
+
**Then a single AskUserQuestion** (`picker-contract.md`; `question`/`label`/`description` in `outputLanguage`, `header` English):
|
|
359
359
|
|
|
360
360
|
| Option | Behavior |
|
|
361
361
|
|---|---|
|
|
@@ -6,6 +6,8 @@ argument-hint: "[\"<free-text description>\"] [figma-url] [swagger-url] - all
|
|
|
6
6
|
|
|
7
7
|
# multi-agent create-jira - Standards-Compliant Jira Issue Creator
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
**Input**: $ARGUMENTS
|
|
10
12
|
|
|
11
13
|
Creates exactly one Jira issue, and only after explicit approval. The issue type (Task / Bug / Story) is asked at the start of every run. No branches, no commits, no worktrees, no pipeline chaining. The draft learns the target project's conventions from its recent same-type issues (summary format, labels, components, priority norms, test-scenario style) and offers active-sprint placement when a sprint is running.
|
|
@@ -67,7 +67,7 @@ In Claude Code also drive the native TaskList widget: fire all `TaskCreate` call
|
|
|
67
67
|
|
|
68
68
|
## STOP-AND-CONFIRM format
|
|
69
69
|
|
|
70
|
-
Every Phase 0 / Phase 2 decision uses a native `AskUserQuestion` picker (numbered text menus are forbidden
|
|
70
|
+
Every Phase 0 / Phase 2 decision uses a native `AskUserQuestion` picker per `picker-contract.md` (numbered text menus are forbidden). Print a `Step <i>/<n>: <what it decides>` breadcrumb before each picker. Confirmation is required even with a single option; state inheritance from a previous run is FORBIDDEN.
|
|
71
71
|
|
|
72
72
|
---
|
|
73
73
|
|
|
@@ -7,6 +7,8 @@ allowed-tools: Bash, Read, AskUserQuestion
|
|
|
7
7
|
|
|
8
8
|
# multi-agent forget - Remove a Routine
|
|
9
9
|
|
|
10
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
11
|
+
|
|
10
12
|
Delete a routine the user saved via `/multi-agent:save`. Backed by `$HOME/.claude/scripts/routine-registry.mjs`.
|
|
11
13
|
|
|
12
14
|
## Steps
|
|
@@ -6,6 +6,8 @@ argument-hint: "[--older-than=<minutes>] [--abandoned [--days=N]] [--yes] - dr
|
|
|
6
6
|
|
|
7
7
|
# multi-agent garbage-collect - Sweep /tmp Scratch
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
Each run writes ephemeral scratch under `/tmp`: picker state
|
|
10
12
|
(`multi-agent-picker-*`), PR/review diffs (`multi-agent-review-*`), issue
|
|
11
13
|
progress bodies (`issue-progress-*`), channel payloads (`channels-*`),
|
|
@@ -62,7 +64,7 @@ deletes nothing until you confirm.
|
|
|
62
64
|
residue in the index (`.worktrees/{id}` recorded as a "Subproject commit"
|
|
63
65
|
entry by a pre-guard `git add -A`), and a missing `.worktrees/` line in
|
|
64
66
|
`.git/info/exclude`. Registered, healthy worktrees are NEVER touched -
|
|
65
|
-
those belong to `/multi-agent:resume
|
|
67
|
+
those belong to `/multi-agent:resume` / `/multi-agent:kill`.
|
|
66
68
|
|
|
67
69
|
- Output says `nothing to do` -> skip silently, no question.
|
|
68
70
|
- Otherwise surface a second `AskUserQuestion` (in `outputLanguage`):
|
|
@@ -81,7 +83,7 @@ deletes nothing until you confirm.
|
|
|
81
83
|
|
|
82
84
|
`offload-ref.sh` parks build logs, diffs and test output under
|
|
83
85
|
`.multi-agent/refs/<node_id>.md`. In worktree modes that directory dies with
|
|
84
|
-
the worktree;
|
|
86
|
+
the worktree; when the run chose a local workspace it lands in the real checkout, and
|
|
85
87
|
because it is gitignored it never shows up in `git status`. Only files
|
|
86
88
|
matching the node-id shape are touched - anything else in that directory is
|
|
87
89
|
left alone, and files inside the grace window are spared so a sweep cannot
|
|
@@ -46,7 +46,7 @@ How It Works (Phase 0 - Interactive Flow):
|
|
|
46
46
|
5. BRANCH NAME bugfix/{jiraId} or feature/{jiraId} -> confirm
|
|
47
47
|
6. GIT ID Select identity from preferences (multiple supported)
|
|
48
48
|
7. INSTRUCTION Auto-detect if .instructions/ exists (figma etc.)
|
|
49
|
-
8. WORKSPACE
|
|
49
|
+
8. WORKSPACE Ask where the branch lives: worktree (default) or project root
|
|
50
50
|
|
|
51
51
|
------------------------------
|
|
52
52
|
|
|
@@ -55,7 +55,7 @@ Pipeline (after Phase 0) - shown as visual cards in terminal:
|
|
|
55
55
|
Phase 0: Init -> The 8 steps above
|
|
56
56
|
Phase 1: Plan -> Stack detection + codebase scan, task breakdown, architecture
|
|
57
57
|
review, Plan Approval Gate (Opus; max 2 clarification rounds,
|
|
58
|
-
|
|
58
|
+
interactive only - autopilot has nobody to ask)
|
|
59
59
|
Phase 2: Dev -> TDD: test -> code -> build (Sonnet) + build queue, then the
|
|
60
60
|
Verify exit gate: build, lint, tests, secrets. The build runs
|
|
61
61
|
ONCE per run and its log carries into Review
|
|
@@ -68,11 +68,10 @@ Pipeline (after Phase 0) - shown as visual cards in terminal:
|
|
|
68
68
|
|
|
69
69
|
Autopilot always pauses at the Phase 5 channels menu (30-min timeout → session ends cleanly).
|
|
70
70
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
bugfix/chore -> Short, feature/refactor/component -> Full. Autopilot always runs Full.
|
|
71
|
+
One pipeline. Every mode runs its whole phase set:
|
|
72
|
+
Plan -> Dev(Sonnet) -> Review -> Commit -> Report
|
|
73
|
+
What a run costs follows the evidence the task carries, not an answer taken
|
|
74
|
+
before the evidence exists.
|
|
76
75
|
|
|
77
76
|
Every step is logged. Error in any phase -> pause -> resume to continue.
|
|
78
77
|
|
|
@@ -82,17 +81,15 @@ Modes:
|
|
|
82
81
|
|
|
83
82
|
Four pipeline entries:
|
|
84
83
|
|
|
85
|
-
/multi-agent "task" Worktree
|
|
86
|
-
/multi-agent:local "task" No worktree, asks Full or Short
|
|
84
|
+
/multi-agent "task" Worktree
|
|
87
85
|
/multi-agent:autopilot "task" Worktree, no questions, always Full
|
|
88
|
-
/multi-agent:local-autopilot "task" No worktree, no questions, always Full
|
|
89
86
|
|
|
90
|
-
|
|
91
|
-
autopilot skips every confirmation INCLUDING the plan gate and the
|
|
87
|
+
Phase 0 Step 5b asks where the branch lives; there is no flag for it.
|
|
88
|
+
autopilot skips every confirmation INCLUDING the plan gate and the workspace
|
|
92
89
|
question, and auto commit/PR - EXCEPT the Phase 5 channels menu, which
|
|
93
90
|
always pauses.
|
|
94
91
|
|
|
95
|
-
/multi-agent:resume
|
|
92
|
+
/multi-agent:resume [#id|jira-id] [autopilot] Pick up unfinished work: a stopped run, or a branch with no run behind it (Review → Commit/PR → Report)
|
|
96
93
|
|
|
97
94
|
------------------------------
|
|
98
95
|
|
|
@@ -135,7 +132,7 @@ Post-Hoc & Side-Channel:
|
|
|
135
132
|
/multi-agent:store-ready [repo] [flags] Pre-submission store readiness, iOS + Android, local-only: three symmetric gates per platform plus the running-app sweep. A skipped gate is never a pass. Validates only, never uploads.
|
|
136
133
|
/multi-agent:testflight-validation [repo] [--ipa=|--archive=] iOS-pinned alias of :store-ready. Same three gates, one implementation.
|
|
137
134
|
/multi-agent:ios-coding-standard [module] Audit an iOS module against the 99-rule coding-standard registry -> remediation
|
|
138
|
-
plan + one-page onboarding summary -> hand off to /multi-agent
|
|
135
|
+
plan + one-page onboarding summary -> hand off to /multi-agent. Read-only, never edits source.
|
|
139
136
|
|
|
140
137
|
Setup & Maintenance:
|
|
141
138
|
|
|
@@ -182,9 +179,8 @@ Interactive Launchers:
|
|
|
182
179
|
|
|
183
180
|
Both follow the same flow after selection:
|
|
184
181
|
1. Branch selection (develop/release/main)
|
|
185
|
-
2.
|
|
186
|
-
3.
|
|
187
|
-
4. Pipeline starts with the selected issue
|
|
182
|
+
2. Autopilot: yes/no
|
|
183
|
+
3. Pipeline starts with the selected issue
|
|
188
184
|
|
|
189
185
|
------------------------------
|
|
190
186
|
|
|
@@ -274,7 +270,6 @@ Examples:
|
|
|
274
270
|
/multi-agent "MOBILE-12345"
|
|
275
271
|
|
|
276
272
|
# GitHub issue, fast mode, local
|
|
277
|
-
/multi-agent:local "#42" # then choose Short
|
|
278
273
|
|
|
279
274
|
# Interactive launchers - browse and pick
|
|
280
275
|
/multi-agent:jira # Pick from my Jira issues
|
|
@@ -284,7 +279,7 @@ Examples:
|
|
|
284
279
|
/multi-agent:autopilot "LoginView dark mode fix" # iOS
|
|
285
280
|
/multi-agent "Add pagination to /api/users endpoint" # Backend
|
|
286
281
|
/multi-agent "Fix bottom nav recomposition in HomeScreen" # Android
|
|
287
|
-
/multi-agent "Responsive layout broken on tablet" # Web
|
|
282
|
+
/multi-agent "Responsive layout broken on tablet" # Web
|
|
288
283
|
|
|
289
284
|
# Review current diff only
|
|
290
285
|
/multi-agent:review
|
|
@@ -326,7 +321,7 @@ Nasıl Çalışır (Phase 0 - İnteraktif Akış):
|
|
|
326
321
|
5. BRANCH NAME bugfix/{jiraId} veya feature/{jiraId} -> onayla
|
|
327
322
|
6. GIT ID Kimlik seç (prefs'ten; birden fazla desteklenir)
|
|
328
323
|
7. INSTRUCTION .instructions/ varsa otomatik algıla (figma vs.)
|
|
329
|
-
8. WORKSPACE
|
|
324
|
+
8. WORKSPACE Branch nerede yaşayacak: worktree (default) ya da proje kökü
|
|
330
325
|
|
|
331
326
|
------------------------------
|
|
332
327
|
|
|
@@ -362,16 +357,14 @@ Modlar:
|
|
|
362
357
|
|
|
363
358
|
Dört pipeline girişi:
|
|
364
359
|
|
|
365
|
-
/multi-agent "task" Worktree var
|
|
366
|
-
/multi-agent:local "task" Worktree yok, Tam mı Kısa mı diye sorar
|
|
360
|
+
/multi-agent "task" Worktree var
|
|
367
361
|
/multi-agent:autopilot "task" Worktree var, soru yok, her zaman Tam
|
|
368
|
-
/multi-agent:local-autopilot "task" Worktree yok, soru yok, her zaman Tam
|
|
369
362
|
|
|
370
|
-
|
|
363
|
+
Faz 0 Adım 5b branch'in nerede yaşayacağını sorar; bayrağı yok.
|
|
371
364
|
autopilot plan kapısı ve derinlik sorusu dahil her onayı atlar, otomatik
|
|
372
365
|
commit/PR açar - İSTİSNA: Faz 5 channels menüsü, o her zaman durur.
|
|
373
366
|
|
|
374
|
-
/multi-agent:resume
|
|
367
|
+
/multi-agent:resume [#id|jira-id] [autopilot] Yarım kalan işi sürdür: duran koşu ya da arkasında koşu olmayan branch (Review → Commit/PR → Report)
|
|
375
368
|
|
|
376
369
|
------------------------------
|
|
377
370
|
|
|
@@ -400,6 +393,7 @@ Post-Hoc & Side-Channel:
|
|
|
400
393
|
/multi-agent:analysis ["analysis-name"] Feature-spec analizi (Figma + Swagger + Confluence + repolar). Önce standardı sorar: global (23 bölümlük geliştirme dokümanı) veya kurumsal (IG→UC→FG gereksinim dokümanı). Stack opsiyonel; Referanslar kanıt kaydından üretilir
|
|
401
394
|
/multi-agent:analysis-resolve [doc] Analiz dokümanının Bölüm 20 açık sorularını kaynak etiketli adaylarla teker teker çözer
|
|
402
395
|
/multi-agent:review-analysis [doc] Yazılmış analizi review eder; bulgular ihlal edilen kuralı gösterir
|
|
396
|
+
/multi-agent:analysis-jira [doc] Nihai analiz -> Jira story ağacı; kapsam iki yönlü kontrol edilir, var olan düğümler atlanır
|
|
403
397
|
/multi-agent:complaint-analysis ["run-adı"] Müşteri şikayeti triyajı: trx/conv id ile Graylog kanıtı + salt-okunur repo eşleştirme → client/bff kök neden + fix planı + dev prompt'u, veya core'a yönlendirme önerisi
|
|
404
398
|
/multi-agent:build-optimize iOS-only Xcode build performance wrapper → benchmark + analiz + recommend-first .build-benchmark/optimization-plan.md
|
|
405
399
|
/multi-agent:create-jira ["açıklama"] [figma-url] [swagger-url] Takım standartlarına uygun Jira Task/Bug/Story oluştur (tip sorar + convention mining + aktif sprint + auto-sizing bölümler + önizleme & onay)
|
|
@@ -407,12 +401,13 @@ Post-Hoc & Side-Channel:
|
|
|
407
401
|
/multi-agent:graph Repo kod grafiğini kur ve sorgula (semboller, import'lar, referanslar), LLM'siz
|
|
408
402
|
/multi-agent:search Task log'larında akıllı arama; --semantic triage corpus'unu sorgular
|
|
409
403
|
/multi-agent:scan Skill güvenlik taraması (tiered pattern catalog)
|
|
404
|
+
/multi-agent:doctor Burada bir koşu çalışır mı? Yerleşim, prefs, kimlik bilgileri, hook'lar; çıkış kodu kararı verir
|
|
410
405
|
/multi-agent:refactor Uyarlanmış best-practice + bug avı + upstream-drift + multi-agent-toolkit MCP araştırması -> tek plan, onay, dev + sync
|
|
411
406
|
/multi-agent:refactor backlog Pipeline'ın kendisi hakkında kaydedilmiş sürtünmeyi karara bağlar, sıfırdan türetmez
|
|
412
407
|
/multi-agent:store-ready [repo] [flags] Yükleme öncesi store hazırlığı, iOS + Android, yalnızca lokal: platform başına 3 simetrik kapı artı çalışan-app sweep'i. Atlanan kapı asla pass sayılmaz. Sadece doğrular, asla yüklemez.
|
|
413
408
|
/multi-agent:testflight-validation [repo] [--ipa=|--archive=] :store-ready'nin iOS alias'ı. Aynı 3 kapı, tek implementasyon.
|
|
414
409
|
/multi-agent:ios-coding-standard [modül] Bir iOS modülünü 99 kurallık kodlama-standardı registry'sine göre denetler -> düzeltme
|
|
415
|
-
planı + tek sayfalık onboarding özeti -> /multi-agent
|
|
410
|
+
planı + tek sayfalık onboarding özeti -> /multi-agent'a devreder. Read-only, kaynağı hiç düzenlemez.
|
|
416
411
|
|
|
417
412
|
Setup & Maintenance:
|
|
418
413
|
|
|
@@ -550,7 +545,6 @@ Quality & Telemetry (advisory, default açık - prefs.global.* ile kapatılabi
|
|
|
550
545
|
/multi-agent "MOBILE-12345"
|
|
551
546
|
|
|
552
547
|
# GitHub issue, hızlı mode, local
|
|
553
|
-
/multi-agent:local "#42" # sonra Kısa seç
|
|
554
548
|
|
|
555
549
|
# İnteraktif launcher'lar - göz at ve seç
|
|
556
550
|
/multi-agent:jira # Jira issue'larımdan seç
|
|
@@ -1,12 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "Audit an iOS module against the shared coding-standard registry (99 stable-ID rules), produce a remediation plan, then hand off to /multi-agent
|
|
3
|
-
description-tr: "Bir iOS modulunu paylasilan kodlama-standardi registry'sine (99 sabit-ID kural) gore denetler, duzeltme plani cikarir, sonra /multi-agent
|
|
2
|
+
description: "Audit an iOS module against the shared coding-standard registry (99 stable-ID rules), produce a remediation plan, then hand off to /multi-agent. Use for a standards pass on a module, or when a review needs rule IDs rather than opinions."
|
|
3
|
+
description-tr: "Bir iOS modulunu paylasilan kodlama-standardi registry'sine (99 sabit-ID kural) gore denetler, duzeltme plani cikarir, sonra /multi-agent'e devreder. Bir modulde standart gecisi icin, ya da bir review'un gorus yerine kural ID'si istedigi durumda kullan."
|
|
4
4
|
argument-hint: "[module name or path]"
|
|
5
5
|
allowed-tools: Skill, Bash, Read, Edit, Write, AskUserQuestion
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# multi-agent ios-coding-standard - Module audit → plan → dev handoff
|
|
9
9
|
|
|
10
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
11
|
+
|
|
10
12
|
**Input**: $ARGUMENTS - optionally a module name or path. When absent, Phase 1 discovers and asks.
|
|
11
13
|
|
|
12
14
|
This routine is the **procedure**. The rules live in the `ai-ios-toolkit:ios-coding-standard` skill, whose registry is
|
|
@@ -236,10 +238,9 @@ Show a concise version of the plan to the user too.
|
|
|
236
238
|
|
|
237
239
|
| Option | What it does |
|
|
238
240
|
|---|---|
|
|
239
|
-
| `/multi-agent:local` | No worktree; branches from the main development branch, fixes on the current checkout |
|
|
240
241
|
| `/multi-agent` | Opens a worktree; fixes on a fresh branch + PR |
|
|
241
242
|
|
|
242
|
-
Both
|
|
243
|
+
Both run the whole pipeline; a standards sweep is usually already scoped, so Phase 1 has little to say and its document is short.
|
|
243
244
|
|
|
244
245
|
Invoke the chosen command with the plan file as the task input, branching off the repo's main
|
|
245
246
|
development branch (e.g. `chore/<module>-coding-standard`). The dev pipeline applies the fixes,
|
|
@@ -7,6 +7,8 @@ not-for: jira
|
|
|
7
7
|
|
|
8
8
|
# multi-agent issue - 4-Step Picker (Account → Repos → Issue → Dev Context)
|
|
9
9
|
|
|
10
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
11
|
+
|
|
10
12
|
**Input**: $ARGUMENTS
|
|
11
13
|
|
|
12
14
|
Fully interactive. Only one optional flag: `autopilot`.
|
|
@@ -6,6 +6,8 @@ argument-hint: "[autopilot] - optional: run the pipeline without confirmations
|
|
|
6
6
|
|
|
7
7
|
# multi-agent jira - 4-Step Picker (Account → Project → Issue → Dev Context)
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
**Input**: $ARGUMENTS
|
|
10
12
|
|
|
11
13
|
Fully interactive. Only one optional flag: `autopilot`.
|
|
@@ -6,6 +6,8 @@ argument-hint: "[en|tr] - sets outputLanguage; omit for interactive picker; us
|
|
|
6
6
|
|
|
7
7
|
# multi-agent language - Language Preference Toggle
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
**Input**: $ARGUMENTS
|
|
10
12
|
|
|
11
13
|
Two-axis language preference for the pipeline:
|
|
@@ -6,6 +6,8 @@ argument-hint: "[--older-than=<days>] [--project=<name>] [--task=<id>] [--yes]"
|
|
|
6
6
|
|
|
7
7
|
# multi-agent prune-logs - Clear Per-Task Project Logs
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
Every run persists a task log dir at
|
|
10
12
|
`~/.claude/logs/multi-agent/<project>/<task>/` (agent-state.json, agent-log.md,
|
|
11
13
|
tracker-state.json, otel-spans.jsonl). These accumulate forever. This prunes
|
|
@@ -6,6 +6,8 @@ description-tr: "⚠️ Tüm worktree, branch, log ve state dosyalarını siler.
|
|
|
6
6
|
|
|
7
7
|
# multi-agent purge - Full Reset
|
|
8
8
|
|
|
9
|
+
> **Pickers follow** `$HOME/.claude/multi-agent-refs/picker-contract.md`: never a one-option call, and branch on the option selected, not on its text.
|
|
10
|
+
|
|
9
11
|
Reset every multi-agent worktree, its local branch, and the project task
|
|
10
12
|
counter. Nuclear option - requires double confirmation. Backed by
|
|
11
13
|
`$HOME/.claude/scripts/purge.sh`, which is safe by default (dry-run, deletes
|