@mmerterden/multi-agent-pipeline 10.8.0 → 10.12.0

package/pipeline/scripts/smoke-tracker-contract.sh

@@ -123,6 +123,68 @@ for mode_file in "${MODE_FILES[@]}"; do
   fi
 done
 
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 7. Live-tracker UX contract (now/cost actions, mirror rule, continuation)"
+if grep -q 'phase-tracker.sh now' "$CONTRACT_FILE" \
+   && grep -q 'cost <N>' "$CONTRACT_FILE"; then
+  pass "tracker-contract documents now + cost actions"
+else
+  fail "tracker-contract missing now/cost action docs"
+fi
+if grep -q '\[cached\]' "$CONTRACT_FILE" || grep -q '\[cached_count\]' "$CONTRACT_FILE"; then
+  pass "tracker-contract documents the 4th cached tokens arg"
+else
+  fail "tracker-contract missing the cached tokens arg"
+fi
+if grep -q 'Progress-line mirror' "$CONTRACT_FILE"; then
+  pass "tracker-contract declares the progress-line mirror rule"
+else
+  fail "tracker-contract missing the progress-line mirror rule"
+fi
+if grep -q 'Continuation runs' "$CONTRACT_FILE" \
+   && grep -q 'never re-initialized' "$CONTRACT_FILE"; then
+  pass "tracker-contract declares the continuation-runs rule"
+else
+  fail "tracker-contract missing the continuation-runs rule"
+fi
+if grep -q 'Completion tile suffix' "$CONTRACT_FILE"; then
+  pass "tracker-contract declares the completion tile suffix"
+else
+  fail "tracker-contract missing the completion tile suffix"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 8. Continuation wiring in finish + manual-test + phase-5"
+FINISH_FILE="$CMDS_DIR/finish.md"
+if grep -q '\[ ! -f "\$STATE" \]' "$FINISH_FILE"; then
+  pass "finish.md guards init behind a state-file existence check"
+else
+  fail "finish.md must not init the tracker unconditionally"
+fi
+if grep -q 'Continuing' "$FINISH_FILE" && grep -q 'cost total' "$FINISH_FILE"; then
+  pass "finish.md prints the inherited-history line via cost total"
+else
+  fail "finish.md missing the continuation summary line"
+fi
+MANUAL_FILE="$CMDS_DIR/manual-test.md"
+if grep -q 'now 5 "awaiting local test (user)"' "$MANUAL_FILE"; then
+  pass "manual-test.md sets the waiting state via now 5"
+else
+  fail "manual-test.md missing the now 5 waiting state"
+fi
+PHASE5_FILE="$CMDS_DIR/refs/phases/phase-5-test.md"
+if grep -q 'now 5 "awaiting local test (user)"' "$PHASE5_FILE"; then
+  pass "phase-5-test.md sets the waiting state via now 5"
+else
+  fail "phase-5-test.md missing the now 5 waiting state"
+fi
+RESUME_FILE="$CMDS_DIR/resume.md"
+if grep -q 'Rebuild the phase tiles' "$RESUME_FILE"; then
+  pass "resume.md rebuilds the phase tiles from state"
+else
+  fail "resume.md missing the tile-rebuild step"
+fi
+
 # ──────────────────────────────────────────────────────────────────────────
 echo ""
 echo "══ tracker-contract smoke: $PASS passed, $FAIL failed ══"

package/pipeline/scripts/smoke-update-check.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+# smoke-update-check.sh
+#
+# Verifies the Phase 0 Step 0.6 advisory update-check contract:
+#   1. update-check.sh exists, parses (bash -n), and honors the advisory contract
+#      offline: exit 0 + empty stdout when the registry is unreachable
+#   2. Cached path: fresh cache short-circuits without a network call
+#   3. Newer latest -> "<local>|<latest>"; same or older latest -> silent
+#   4. prefs.schema.json exposes updateCheck.{enabled,ttlHours,autoUpdate}
+#      with the documented defaults (enabled=true, autoUpdate=false)
+#   5. phase-0-init.md documents Step 0.6 with the autopilot log-only rule
+#
+# Exit 0 = all pass, 1 = any failure.
+
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+SCRIPT="$ROOT/pipeline/scripts/update-check.sh"
+PREFS_SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
+PHASE0_DOC="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
+
+pass=0
+fail=0
+failures=()
+record_pass() { pass=$((pass + 1)); printf '  \033[0;32mPASS\033[0m %s\n' "$1"; }
+record_fail() { fail=$((fail + 1)); failures+=("$1"); printf '  \033[0;31mFAIL\033[0m %s\n' "$1"; }
+
+printf '→ smoke-update-check: Phase 0 Step 0.6 advisory contract\n'
+
+tmpdir=$(mktemp -d)
+trap 'rm -rf "$tmpdir"' EXIT
+CACHE="$tmpdir/update-check-cache"
+
+# 1. Script parses
+if bash -n "$SCRIPT" 2>/dev/null; then
+  record_pass "update-check.sh parses (bash -n)"
+else
+  record_fail "update-check.sh has syntax errors"
+fi
+
+now=$(date +%s)
+
+# 2. Fresh cache with newer latest -> reports, no network needed
+printf '%s|99.0.0\n' "$now" > "$CACHE"
+out=$(UPDATE_CHECK_CACHE="$CACHE" bash "$SCRIPT" --local 10.0.0 2>/dev/null); rc=$?
+if [ "$rc" -eq 0 ] && [ "$out" = "10.0.0|99.0.0" ]; then
+  record_pass "newer cached latest -> '<local>|<latest>' (exit 0)"
+else
+  record_fail "newer cached latest should print '10.0.0|99.0.0' (got '$out', rc=$rc)"
+fi
+
+# 3. Same version -> silent
+printf '%s|10.0.0\n' "$now" > "$CACHE"
+out=$(UPDATE_CHECK_CACHE="$CACHE" bash "$SCRIPT" --local 10.0.0 2>/dev/null); rc=$?
+if [ "$rc" -eq 0 ] && [ -z "$out" ]; then
+  record_pass "same version -> silent"
+else
+  record_fail "same version should be silent (got '$out', rc=$rc)"
+fi
+
+# 3b. Local ahead of registry (dev machine) -> silent
+printf '%s|10.0.0\n' "$now" > "$CACHE"
+out=$(UPDATE_CHECK_CACHE="$CACHE" bash "$SCRIPT" --local 10.1.0 2>/dev/null); rc=$?
+if [ "$rc" -eq 0 ] && [ -z "$out" ]; then
+  record_pass "local ahead of registry -> silent (no downgrade prompt)"
+else
+  record_fail "local-ahead should be silent (got '$out', rc=$rc)"
+fi
+
+# 3c. Offline + stale cache -> silent exit 0 (advisory: never blocks)
+printf '0|10.0.0\n' > "$CACHE"
+out=$(UPDATE_CHECK_CACHE="$CACHE" http_proxy="http://127.0.0.1:1" https_proxy="http://127.0.0.1:1" \
+      bash "$SCRIPT" --local 10.0.0 2>/dev/null); rc=$?
+if [ "$rc" -eq 0 ] && [ -z "$out" ]; then
+  record_pass "offline + stale cache -> silent exit 0"
+else
+  record_fail "offline should be a silent no-op (got '$out', rc=$rc)"
+fi
+
+# 4. Prefs schema knobs + defaults
+for prop in enabled ttlHours autoUpdate; do
+  if jq -e ".properties.global.properties.updateCheck.properties.${prop}" "$PREFS_SCHEMA" >/dev/null 2>&1; then
+    record_pass "prefs schema exposes updateCheck.${prop}"
+  else
+    record_fail "prefs schema missing updateCheck.${prop}"
+  fi
+done
+if jq -e '.properties.global.properties.updateCheck.properties.enabled.default == true' "$PREFS_SCHEMA" >/dev/null 2>&1; then
+  record_pass "updateCheck.enabled defaults to true (notify-only, bounded cost)"
+else
+  record_fail "updateCheck.enabled must default to true"
+fi
+if jq -e '.properties.global.properties.updateCheck.properties.autoUpdate | has("default") and .default == false' "$PREFS_SCHEMA" >/dev/null 2>&1; then
+  record_pass "updateCheck.autoUpdate defaults to false (no silent self-modify)"
+else
+  record_fail "updateCheck.autoUpdate must default to false"
+fi
+
+# 5. Phase 0 doc wiring
+if grep -qF "Step 0.6 - Update check" "$PHASE0_DOC"; then
+  record_pass "phase-0-init.md documents Step 0.6"
+else
+  record_fail "phase-0-init.md missing Step 0.6"
+fi
+if grep -qF "update-check.sh" "$PHASE0_DOC"; then
+  record_pass "phase-0-init.md invokes update-check.sh"
+else
+  record_fail "phase-0-init.md must invoke update-check.sh"
+fi
+if grep -qF "log-only" "$PHASE0_DOC" && grep -qF "never ask (zero-interaction contract)" "$PHASE0_DOC"; then
+  record_pass "phase-0-init.md states the autopilot log-only rule"
+else
+  record_fail "phase-0-init.md must state autopilot never asks (log-only)"
+fi
+
+printf '\n══ update-check smoke: %d passed, %d failed ══\n' "$pass" "$fail"
+if [ "$fail" -gt 0 ]; then
+  printf '\nFailures:\n'
+  for msg in "${failures[@]}"; do printf '  - %s\n' "$msg"; done
+  exit 1
+fi
+exit 0

package/pipeline/scripts/update-check.sh

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+# update-check.sh  -  cached advisory version check (Phase 0 Step 0.6)
+#
+# Compares the locally installed pipeline version against the npm registry's
+# dist-tags.latest. Cached with a TTL so at most one network call per TTL
+# window; the call is bounded by a short timeout and every failure path is
+# silent  -  this script NEVER blocks or fails the pipeline.
+#
+# stdout: "<local>|<latest>" when a newer version exists, nothing otherwise.
+# Exit code: always 0 (advisory contract).
+#
+# Usage:
+#   bash pipeline/scripts/update-check.sh                 # auto-detect local version
+#   bash pipeline/scripts/update-check.sh --local 10.8.0  # explicit local version
+#   bash pipeline/scripts/update-check.sh --ttl-hours 24  # cache window (default 24)
+#   bash pipeline/scripts/update-check.sh --force         # ignore cache
+#
+# Cache file: ~/.claude/logs/multi-agent/.update-check ("epoch|latest").
+# Registry read is a plain curl  -  never `npm view` (a user-level .npmrc scope
+# mapping can silently reroute npm to a different registry; curl cannot lie).
+
+set -euo pipefail
+
+PKG="@mmerterden/multi-agent-pipeline"
+REGISTRY_URL="https://registry.npmjs.org/${PKG/\//%2F}"
+CACHE_FILE="${UPDATE_CHECK_CACHE:-$HOME/.claude/logs/multi-agent/.update-check}"
+TTL_HOURS=24
+LOCAL_VERSION=""
+FORCE=0
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --local) LOCAL_VERSION="${2:-}"; shift 2 ;;
+    --ttl-hours) TTL_HOURS="${2:-24}"; shift 2 ;;
+    --force) FORCE=1; shift ;;
+    *) shift ;;
+  esac
+done
+
+# Local version: explicit arg, else read from the pipeline repo clone.
+if [ -z "$LOCAL_VERSION" ]; then
+  for candidate in "$HOME/multi-agent-pipeline" "$HOME/dev/multi-agent-pipeline" "$HOME/projects/multi-agent-pipeline"; do
+    if [ -f "$candidate/package.json" ]; then
+      LOCAL_VERSION=$(node -p "require('$candidate/package.json').version" 2>/dev/null || true)
+      [ -n "$LOCAL_VERSION" ] && break
+    fi
+  done
+fi
+[ -z "$LOCAL_VERSION" ] && exit 0  # cannot determine local version -> silent no-op
+
+now=$(date +%s)
+latest=""
+
+# Fresh cache?
+if [ "$FORCE" -eq 0 ] && [ -f "$CACHE_FILE" ]; then
+  cached_epoch=$(cut -d'|' -f1 "$CACHE_FILE" 2>/dev/null || echo 0)
+  cached_latest=$(cut -d'|' -f2 "$CACHE_FILE" 2>/dev/null || echo "")
+  case "$cached_epoch" in (*[!0-9]*|"") cached_epoch=0 ;; esac
+  if [ $((now - cached_epoch)) -lt $((TTL_HOURS * 3600)) ] && [ -n "$cached_latest" ]; then
+    latest="$cached_latest"
+  fi
+fi
+
+# Stale or missing cache -> one bounded registry call (silent on any failure).
+if [ -z "$latest" ]; then
+  latest=$(curl -sm 3 "$REGISTRY_URL" 2>/dev/null \
+    | { command -v jq >/dev/null 2>&1 && jq -r '."dist-tags".latest // empty' \
+        || sed -n 's/.*"latest":"\([^"]*\)".*/\1/p'; } | head -1) || true
+  [ -z "$latest" ] && exit 0
+  mkdir -p "$(dirname "$CACHE_FILE")" 2>/dev/null || exit 0
+  printf '%s|%s\n' "$now" "$latest" > "$CACHE_FILE" 2>/dev/null || true
+fi
+
+[ "$latest" = "$LOCAL_VERSION" ] && exit 0
+
+# Update available only when latest sorts strictly ABOVE local (a dev machine
+# running ahead of the registry must not see an "update" prompt).
+highest=$(printf '%s\n%s\n' "$LOCAL_VERSION" "$latest" | sort -t. -k1,1n -k2,2n -k3,3n | tail -1)
+if [ "$highest" = "$latest" ]; then
+  printf '%s|%s\n' "$LOCAL_VERSION" "$latest"
+fi
+exit 0

package/pipeline/skills/.skills-index.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-02T18:42:58.207Z",
-  "skillCount": 222,
+  "generatedAt": "2026-07-06T11:38:47.307Z",
+  "skillCount": 224,
   "entries": [
     {
       "name": "accessibility-compliance-accessibility-audit",
@@ -1031,7 +1031,7 @@
     },
     {
       "name": "multi-agent",
-      "description": "Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Opus + Sonnet on Claude Code, GPT + Opus + Sonnet on Copilot CLI) → commit → log. Every step is written to agent-log.md.",
+      "description": "Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Fable + Sonnet on Claude Code, GPT + Opus + Sonnet on Copilot CLI) → commit → log. Every step is written to agent-log.md.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1155,6 +1155,24 @@
       "triggerPaths": [],
       "relativePath": "shared/core/multi-agent-garbage-collect/SKILL.md"
     },
+    {
+      "name": "multi-agent-generate-bug",
+      "description": "Create a standards-compliant Jira Bug: mines project conventions, drafts in outputLanguage, full preview + explicit approval before create.",
+      "platform": null,
+      "group": "core",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/core/multi-agent-generate-bug/SKILL.md"
+    },
+    {
+      "name": "multi-agent-generate-task",
+      "description": "Create a standards-compliant Jira Task: mines project conventions, drafts in outputLanguage, full preview + explicit approval before create.",
+      "platform": null,
+      "group": "core",
+      "triggerKeywords": [],
+      "triggerPaths": [],
+      "relativePath": "shared/core/multi-agent-generate-task/SKILL.md"
+    },
     {
       "name": "multi-agent-help",
       "description": "Multi-agent pipeline usage guide  -  renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatibility).",
@@ -1274,7 +1292,7 @@
     },
     {
       "name": "multi-agent-review",
-      "description": "Run parallel review on the current branch's diff: 2 models on Claude Code (Opus + Sonnet), 3 models on Copilot CLI (GPT + Opus + Sonnet). Review-only slice of the pipeline.",
+      "description": "Run parallel review on the current branch's diff: 2 models on Claude Code (Fable + Sonnet), 3 models on Copilot CLI (GPT + Opus + Sonnet). Review-only slice of the pipeline.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],

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

@@ -309,7 +309,8 @@ Every user-facing phase title  -  TaskCreate cards, `phase-banner.sh` headers, a
 All TaskCreate calls fire in strict phase-number order BEFORE any TaskUpdate is applied (Claude Code path; Copilot CLI does not have a TaskList widget so this rule is Claude-only). The native widget renders by creation order, not by phase-number metadata  -  out-of-order calls produce visually scrambled tile stacks (e.g. `1 ✓ · 2 ✓ · 4 ✓ · 0 ▶ · 3 ☐`) even when the underlying state file is correct. Pre-marking phases as completed/skipped before Phase 0 starts is FORBIDDEN: register the tile in order with default `pending` status, then flip via TaskUpdate when the phase actually short-circuits. Mode-specific phase sets:
 
 - Full pipeline (`multi-agent`, `multi-agent-autopilot`, `multi-agent-local`, `multi-agent-local-autopilot`): 0 → 1 → 2 → 3 → 4 → 5 → 6 → 7
-- `--dev` modes (`multi-agent-dev`, `multi-agent-dev-autopilot`, `multi-agent-dev-local`, `multi-agent-dev-local-autopilot`): 0 → 3 → 5 → 6 → 7 (phases 1/2/4 are NOT TaskCreate'd at all)
+- `multi-agent-dev`: 0 → 3 → 5 → 6 → 7 (phases 1/2/4 are NOT TaskCreate'd at all)
+- `multi-agent-dev-autopilot`, `multi-agent-dev-local`, `multi-agent-dev-local-autopilot`: 0 → 3 → 6 → 7 (phases 1/2/4/5 are NOT TaskCreate'd at all  -  the autopilot/local variants drop the interactive Phase 5 test gate)
 
 Full contract: `refs/tracker-contract.md` section "TaskCreate ordering (strict)".
 

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

@@ -41,8 +41,9 @@ multi-agent-channels PROJ-12345 --dry-run                  # preview, no POST
 3. **Menu (multi-select)**  -  channel + content, previous selections pre-ticked from `prefs.global.reportChannels` + `prefs.global.reportContent`. Greyed-out rules per context availability.
 4. **Mode short-circuit**  -  `--channels X,Y` + `--content A,B` flags skip menu. Autopilot ALWAYS pauses at the menu (v5.7+ Phase 7 exception).
 5. **Generator**  -  for each selected content source, produce a section body. Humanizer pass per channel separately.
-6. **Channel dispatch**  -  parallel adapter calls: PR description (reviewer-preserving PUT on Bitbucket), Jira comment (wiki markup), Confluence page (storage format + parent page), Wiki (component adapter  -  Case A scope multi-select or Case B precondition menu).
-7. **Summary**  -  per-adapter status line, persist selections to prefs.
+6. **Body preview + approval gate**  -  interactive runs render every selected channel's final body and ask Approve & post / Edit (loop) / Skip channels / Cancel BEFORE any external write. Skipped only by autopilot and `--dry-run`. What is posted is byte-identical to the approved preview.
+7. **Channel dispatch**  -  parallel adapter calls, never before the gate resolves: PR description (reviewer-preserving PUT on Bitbucket), Jira comment (wiki markup), Confluence page (storage format + parent page), Wiki (component adapter  -  Case A scope multi-select or Case B precondition menu).
+8. **Summary**  -  per-adapter status line, persist selections to prefs.
 
 ## Multi-select menu
 
@@ -222,6 +223,7 @@ Target length: < 80 lines (fits one screen). Auto-diff capped at 5 lines per sec
 - No markers  -  full replace each run, no `<!-- channels:start -->` bookmarks.
 - Every body item references a file/symbol/line from diff or pipeline log. No generic sentences.
 - Adapter failures are non-blocking  -  one channel failing does NOT abort others.
+- Approval before post  -  interactive runs never write to an external channel without the step 6 preview + approval. Autopilot and `--dry-run` are the only bypasses.
 
 ## Error handling
 

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

@@ -0,0 +1,39 @@
+---
+name: multi-agent-generate-bug
+language: en
+description: "Create a standards-compliant Jira Bug: mines project conventions, drafts in outputLanguage, full preview + explicit approval before create."
+user-invocable: true
+argument-hint: "[\"<free-text description>\"] [figma-url]  -  both optional; pasted logs/screens in the text land in Steps to Reproduce / Environment"
+---
+
+# multi-agent generate-bug  -  Standards-Compliant Jira Bug Creator
+
+**Input**: $ARGUMENTS
+
+Creates exactly one Jira **Bug**, and only after explicit approval. No branches, no commits, no worktrees. Profile: `ISSUE_TYPE=Bug`; default description sections: Steps to Reproduce, Expected Result, Actual Result, Environment, Design Reference (only when a Figma URL is given), Notes.
+
+> **Language**: issue content (summary + description) and user-facing questions follow `prefs.global.outputLanguage`  -  intentional exception to the "external payloads stay English" default (the issue is authored for the user's team). Code identifiers and URLs stay verbatim.
+
+## Steps
+
+1. **Account + token**  -  pick the Jira account (auto-select when single), then:
+   ```bash
+   TOKEN=$(~/.copilot/lib/credential-store.sh get "$ACCOUNT_JIRA_TOKEN_KEY")
+   ```
+   Missing/expired (401) → Token Save Flow; user skips → abort, nothing created.
+2. **Project key**  -  `figmaConfig.jira.projectKey` → `prefs.global.defaultJiraKey` → fetch `GET /rest/api/2/project`, ask, cache the choice.
+3. **Parse input**  -  `figma.com` URL in `$ARGUMENTS` → `FIGMA_URL` (node-id `-` → `:`); the rest is `FREE_TEXT`. Logs, stack traces, and device/OS mentions map into Steps to Reproduce / Environment. Both empty → ask for a description. Figma URL is always optional.
+4. **Convention mining + field discovery + sprint** (read-only GETs):
+   - Sample: `GET /rest/api/2/search?jql=project={KEY} AND issuetype=Bug ORDER BY created DESC&fields=summary,description,labels,components,priority,fixVersions&maxResults=30`. Extract summary prefix pattern (>= 40% threshold), dominant description heading set (>= 50% overrides the profile sections), top-5 labels/components, modal priority, epic usage rate.
+   - `GET /rest/api/2/issue/createmeta?projectKeys={KEY}&issuetypeNames=Bug&expand=projects.issuetypes.fields` (404/empty → paged DC endpoint fallback). Required custom fields → step 6 questions with allowedValues options. Detect Sprint/Epic/Team fields generically via `schema.custom` ids.
+   - `GET /rest/agile/1.0/board?projectKeyOrId={KEY}` → (ask when multiple) → `GET /rest/agile/1.0/board/{id}/sprint?state=active`. No board/Agile 404 → sprint option silently omitted.
+5. **Figma context** (only when `FIGMA_URL` set)  -  3-tier chain (MCP → REST figma_pat → user screenshot); standalone command, MCP allowed here. Figma failures never block issue creation.
+6. **Draft + clarifying questions**  -  compose summary (`{minedPrefix} {title}`, 255 trunc) + description (mined heading set or profile sections, Jira wiki markup `h3.`, humanizer pass) in `outputLanguage`; body to a file for `jq -n --rawfile` (UTF-8 verbatim, `--data-binary @file`, no re-encode). Ask ONLY genuinely unknown fields: component, epic (when usage rate is high), priority (when norm ambiguous), labels, assignee, sprint vs backlog, required customs, missing Steps to Reproduce / Environment. Never invent repro steps or environments the user did not supply.
+7. **Full preview + approval gate (never skipped)**  -  render the complete issue (all fields + full description + attachment plan, screenshot default off). Ask: `Approve` / `Edit` (apply → re-render → re-ask, loop) / `Cancel` (nothing created). No flag or mode bypasses this gate.
+8. **Create**  -  `POST /rest/api/2/issue` with `jq -n --rawfile` payload + `curl --data-binary @file`. 400 field errors → show verbatim, re-ask those fields, re-preview.
+9. **Post-create** (each failure-isolated: warn + continue): sprint chosen → `POST /rest/agile/1.0/sprint/{id}/issue` `{"issues":["KEY"]}`; Figma → `POST /rest/api/2/issue/{KEY}/remotelink`; screenshot opt-in → `POST /rest/api/2/issue/{KEY}/attachments` with `X-Atlassian-Token: no-check`.
+10. **Report**  -  `Created {KEY}: https://{host}/browse/{KEY}` + which post-steps ran.
+
+## Error paths
+
+401 token → Save Flow or abort (nothing created); mining/createmeta 403 → profile defaults + reactive 400 handling; zero sampled issues → skip mining, note in preview; no board/active sprint → backlog implied, say so; create 5xx → one retry then abort keeping the draft file; post-create failure → warn + continue.

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

@@ -0,0 +1,39 @@
+---
+name: multi-agent-generate-task
+language: en
+description: "Create a standards-compliant Jira Task: mines project conventions, drafts in outputLanguage, full preview + explicit approval before create."
+user-invocable: true
+argument-hint: "[\"<free-text description>\"] [figma-url]  -  both optional, asked interactively when missing"
+---
+
+# multi-agent generate-task  -  Standards-Compliant Jira Task Creator
+
+**Input**: $ARGUMENTS
+
+Creates exactly one Jira **Task**, and only after explicit approval. No branches, no commits, no worktrees. Profile: `ISSUE_TYPE=Task`; default description sections: Goal, Scope, Acceptance Criteria, Design Reference (only when a Figma URL is given), Notes.
+
+> **Language**: issue content (summary + description) and user-facing questions follow `prefs.global.outputLanguage`  -  intentional exception to the "external payloads stay English" default (the issue is authored for the user's team). Code identifiers and URLs stay verbatim.
+
+## Steps
+
+1. **Account + token**  -  pick the Jira account (auto-select when single), then:
+   ```bash
+   TOKEN=$(~/.copilot/lib/credential-store.sh get "$ACCOUNT_JIRA_TOKEN_KEY")
+   ```
+   Missing/expired (401) → Token Save Flow; user skips → abort, nothing created.
+2. **Project key**  -  `figmaConfig.jira.projectKey` → `prefs.global.defaultJiraKey` → fetch `GET /rest/api/2/project`, ask, cache the choice.
+3. **Parse input**  -  `figma.com` URL in `$ARGUMENTS` → `FIGMA_URL` (node-id `-` → `:`); the rest is `FREE_TEXT`. Both empty → ask for a description. Figma URL is always optional.
+4. **Convention mining + field discovery + sprint** (read-only GETs):
+   - Sample: `GET /rest/api/2/search?jql=project={KEY} AND issuetype=Task ORDER BY created DESC&fields=summary,description,labels,components,priority,fixVersions&maxResults=30`. Extract summary prefix pattern (>= 40% threshold), dominant description heading set (>= 50% overrides the profile sections), top-5 labels/components, modal priority, epic usage rate.
+   - `GET /rest/api/2/issue/createmeta?projectKeys={KEY}&issuetypeNames=Task&expand=projects.issuetypes.fields` (404/empty → paged DC endpoint fallback). Required custom fields → step 6 questions with allowedValues options. Detect Sprint/Epic/Team fields generically via `schema.custom` ids.
+   - `GET /rest/agile/1.0/board?projectKeyOrId={KEY}` → (ask when multiple) → `GET /rest/agile/1.0/board/{id}/sprint?state=active`. No board/Agile 404 → sprint option silently omitted.
+5. **Figma context** (only when `FIGMA_URL` set)  -  3-tier chain (MCP → REST figma_pat → user screenshot); standalone command, MCP allowed here. Figma failures never block issue creation.
+6. **Draft + clarifying questions**  -  compose summary (`{minedPrefix} {title}`, 255 trunc) + description (mined heading set or profile sections, Jira wiki markup `h3.`, humanizer pass) in `outputLanguage`; body to a file for `jq -n --rawfile` (UTF-8 verbatim, `--data-binary @file`, no re-encode). Ask ONLY genuinely unknown fields: component, epic (when usage rate is high), priority (when norm ambiguous), labels, assignee, sprint vs backlog, required customs. Never invent content the user did not supply.
+7. **Full preview + approval gate (never skipped)**  -  render the complete issue (all fields + full description + attachment plan, screenshot default off). Ask: `Approve` / `Edit` (apply → re-render → re-ask, loop) / `Cancel` (nothing created). No flag or mode bypasses this gate.
+8. **Create**  -  `POST /rest/api/2/issue` with `jq -n --rawfile` payload + `curl --data-binary @file`. 400 field errors → show verbatim, re-ask those fields, re-preview.
+9. **Post-create** (each failure-isolated: warn + continue): sprint chosen → `POST /rest/agile/1.0/sprint/{id}/issue` `{"issues":["KEY"]}`; Figma → `POST /rest/api/2/issue/{KEY}/remotelink`; screenshot opt-in → `POST /rest/api/2/issue/{KEY}/attachments` with `X-Atlassian-Token: no-check`.
+10. **Report**  -  `Created {KEY}: https://{host}/browse/{KEY}` + which post-steps ran.
+
+## Error paths
+
+401 token → Save Flow or abort (nothing created); mining/createmeta 403 → profile defaults + reactive 400 handling; zero sampled issues → skip mining, note in preview; no board/active sprint → backlog implied, say so; create 5xx → one retry then abort keeping the draft file; post-create failure → warn + continue.

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

@@ -98,6 +98,8 @@ Utility Commands (dash form on Copilot, colon form on Claude Code):
   /multi-agent:purge          Worktree + logs  -  full reset (double confirm)
   /multi-agent:channels       Post multi-channel report (Jira/Confluence/Wiki/PR)
   /multi-agent:review         Review current diff only
+  /multi-agent:generate-task ["desc"] [figma-url]  Create a Jira Task matching team conventions (preview + approval)
+  /multi-agent:generate-bug ["desc"] [figma-url]   Create a Jira Bug matching team conventions (preview + approval)
   /multi-agent:sync           Sync ecosystem (Claude + Copilot + website + remote-control)
   /multi-agent:setup          Keychain tokens + Git identity + language onboarding
   /multi-agent:language [en|tr]  Show or set prompt language
@@ -233,6 +235,8 @@ Utility Komutları:
   /multi-agent:purge          Worktree + log'lar  -  tam reset (çift onay)
   /multi-agent:channels       Multi-channel rapor gönder (Jira/Confluence/Wiki/PR)
   /multi-agent:review         Sadece mevcut diff'i review et
+  /multi-agent:generate-task ["açıklama"] [figma-url]  Takım standartlarına uygun Jira Task oluştur (önizleme + onay)
+  /multi-agent:generate-bug ["açıklama"] [figma-url]   Takım standartlarına uygun Jira Bug oluştur (önizleme + onay)
   /multi-agent:sync           Ekosistemi senkronize et
   /multi-agent:setup          Keychain token + Git kimliği + dil onboarding
   /multi-agent:language [en|tr]  Prompt dilini göster veya ayarla

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

@@ -33,7 +33,7 @@ Run all steps automatically:
 Step 0: FIGMA_SYNC  (opt-in) pipeline/scripts/sync-figma-source.sh
                     -- incremental pull from upstream if figmaSource.path is set
 Step 1: DETECT      Compare timestamps, find stale targets
-Step 2: COPILOT     Claude Code -> Copilot CLI (instructions + 35 sub-command skills)
+Step 2: COPILOT     Claude Code -> Copilot CLI (instructions + 37 sub-command skills)
 Step 3: REPO        Claude Code -> pipeline repo (genericized, personal data scrub)
 Step 4: WEBSITE     Version + phase/model counts -> {website-host} (i18n + projects.ts)
 Step 5: REMOTE      Pipeline references -> remote-control README
@@ -158,14 +158,14 @@ When invoked with the `release` argument:
 |-------------|-------------|
 | `~/.claude/commands/multi-agent/{cmd}.md` | `~/.copilot/skills/multi-agent-{cmd}/SKILL.md` |
 
-**35 commands are synced** (canonical inventory  -  must match `cross-cli-contract.md` section 1; drift = contract violation):
+**37 commands are synced** (canonical inventory  -  must match `cross-cli-contract.md` section 1; drift = contract violation):
 
 ```
 analysis, analysis-resolve, autopilot, build-optimize, channels, delete, dev,
 dev-autopilot, dev-local, dev-local-autopilot, diff-explain, finish, garbage-collect,
-help, issue, jira, kill, language, local, local-autopilot, log, manual-test,
-prune-logs, purge, refactor, resume, review, scan, search, setup, stack, status,
-sync, test, update
+generate-bug, generate-task, help, issue, jira, kill, language, local,
+local-autopilot, log, manual-test, prune-logs, purge, refactor, resume, review,
+scan, search, setup, stack, status, sync, test, update
 ```
 
 **NOT synced**: `refs/*`  -  Lazy-load references, Claude Code specific

package/pipeline/skills/skills-index.md

@@ -3,7 +3,7 @@
 > Auto-generated by `pipeline/scripts/build-skills-index.mjs`  -  do not hand-edit.
 > Regenerate with `node pipeline/scripts/build-skills-index.mjs`.
 
-**222 skills** across 5 groups.
+**224 skills** across 5 groups.
 
 | Group | Name | Platform | Description |
 |-------|------|----------|-------------|
@@ -121,7 +121,7 @@
 | external | `mapkit-location` |  -  | Implement, review, or improve maps and location features in iOS/macOS apps using MapKit and CoreLocation. Use when working with Map views, a |
 | external | `metrickit-diagnostics` |  -  | Collect and analyze on-device performance metrics and crash diagnostics using MetricKit. Use when setting up MXMetricManager, handling MXMet |
 | external | `monorepo-architect` |  -  | Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient mu |
-| core | `multi-agent` |  -  | Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Opus + |
+| core | `multi-agent` |  -  | Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Fable  |
 | core | `multi-agent-analysis` |  -  | Standalone feature-spec analysis (v3 template). Platform-agnostic concept layer with repo-driven convention extraction and per-platform Pass |
 | core | `multi-agent-analysis-resolve` |  -  | Resolve the Section 20 Risks and Open Questions of an analysis v3 document one row at a time. Proposes up to 3 source-labeled answer candida |
 | core | `multi-agent-autopilot` |  -  | Launch any task in autopilot mode: skips every confirmation, runs end-to-end autonomously. |
@@ -135,6 +135,8 @@
 | core | `multi-agent-diff-explain` |  -  | Map Phase 4 triage findings to branch diff lines. Read-only post-hoc command, used after review to answer 'which finding lines up with which |
 | core | `multi-agent-finish` |  -  | Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenari |
 | core | `multi-agent-garbage-collect` |  -  | Sweep leftover /tmp scratch (picker state, review diffs, channel payloads, analysis drafts) from past runs. Dry-run first; confirms before d |
+| core | `multi-agent-generate-bug` |  -  | Create a standards-compliant Jira Bug: mines project conventions, drafts in outputLanguage, full preview + explicit approval before create. |
+| core | `multi-agent-generate-task` |  -  | Create a standards-compliant Jira Task: mines project conventions, drafts in outputLanguage, full preview + explicit approval before create. |
 | core | `multi-agent-help` |  -  | Multi-agent pipeline usage guide  -  renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatib |
 | core | `multi-agent-issue` |  -  | List unassigned GitHub issues, pick one, auto-assign, and launch the multi-agent pipeline. |
 | core | `multi-agent-jira` |  -  | List open Jira issues, pick one, and launch the multi-agent pipeline. |
@@ -148,7 +150,7 @@
 | core | `multi-agent-purge` |  -  | ⚠️ Wipes every worktree, branch, log, and state file. Irreversible; asks for double confirmation. |
 | core | `multi-agent-refactor` |  -  | Analyse the project, score it, draft an improvement plan, take approval, develop, then ask whether to sync. |
 | core | `multi-agent-resume` |  -  | Resume a stopped or failed task from the phase where it left off. |
-| core | `multi-agent-review` |  -  | Run parallel review on the current branch's diff: 2 models on Claude Code (Opus + Sonnet), 3 models on Copilot CLI (GPT + Opus + Sonnet). Re |
+| core | `multi-agent-review` |  -  | Run parallel review on the current branch's diff: 2 models on Claude Code (Fable + Sonnet), 3 models on Copilot CLI (GPT + Opus + Sonnet). R |
 | core | `multi-agent-scan` |  -  | Skill security scan: walks local skill directories against a tiered pattern catalog. |
 | core | `multi-agent-search` |  -  | Log search across every agent-log.md with smart ranking and filters. Optional --semantic flag queries the per-repo triage corpus. |
 | core | `multi-agent-setup` |  -  | First-run setup wizard: keychain token discovery, Git Identity onboarding, and pipeline preparation. |