@mmerterden/multi-agent-pipeline 20.12.0 → 20.13.0

package/pipeline/skills/shared/core/multi-agent-doctor/SKILL.md

@@ -20,6 +20,12 @@ same way - late, mid-run, after the pickers had been answered. A missing script
 fails at the call. Malformed preferences fail after Phase 0 has asked five
 questions. A token in a remote URL does not fail at all; it leaks.
 
+## Gotchas
+
+- Exit 4 means the layout did not resolve and nothing was checked. It is not a pass.
+- Without `--probe` no credential is sent anywhere, so a revoked token still reads as mapped.
+- `usage-report` SKIP means nothing has been sent from this machine yet, not that reporting works.
+
 ## Run it
 
 ```bash

package/pipeline/skills/shared/core/multi-agent-review/SKILL.md

@@ -13,6 +13,11 @@ metadata:
 
 Skip Phase 0-3 and review a diff only. Input shapes: a PR (`#N`, `repo#N`, GitHub/Bitbucket-Server PR URL), a branch name, or empty.
 
+## Gotchas
+
+- The counterpart-repo comparison needs exactly one resolved candidate. With several, an unattended run skips it silently, so an autopilot review can have no cross-platform section.
+- The counterpart's stack comes from marker files, never from the repo name.
+
 ## Steps
 
 1. **Resolve the input** (`{kind, provider}`):

package/pipeline/skills/shared/core/multi-agent-review-analysis/SKILL.md

@@ -13,6 +13,11 @@ metadata:
 
 `multi-agent-review` judges a diff. This judges the document that diff was supposed to come from, before the code exists. No worktree, no branch, no commit, and the reviewed document is never edited in place.
 
+## Gotchas
+
+- Validator ERRORs are Blockers and WARNs are Important, unless the document states why the warned-about item is acceptable.
+- Every rubric class is printed, with `none` when empty. A class missing from the verdict did not run; it is not a clean result.
+
 ## Flow
 
 Read `$HOME/.copilot/multi-agent-refs/analysis/review.md` and execute it:

package/pipeline/skills/shared/core/multi-agent-setup/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: multi-agent-setup
 description: "First-run setup wizard: keychain token discovery, Git Identity onboarding, and pipeline preparation. Use when the pipeline is being set up for the first time, or tokens and git identity need onboarding."
+argument-hint: "[jira-keys | hosts | accounts]  -  optional; no argument runs the whole onboarding"
 user-invocable: true
 metadata:
   language: en