guild-cli 0.8.5__tar.gz → 0.9.1__tar.gz

guild_cli-0.9.1/.claude/skills/outsource/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: outsource
+type: command
+description: >
+  Hand a scoped repo task to convertible — a *different* engine/model than you
+  (e.g. a local vLLM Qwen) — and fold its answer back. The point isn't a stronger
+  model; it's a different mind, and diversity helps: `outsource review` gets an
+  independent second opinion on a diff, `outsource explore` gets a fresh read of
+  an area, `outsource write` delegates a small implementation. Use when the user
+  says "outsource this", "get a second opinion", "have convertible review/explore/
+  write", "ask the other model", or when you want a diverse perspective rather
+  than just doing it yourself. Read-only verbs (explore/review) run isolated in a
+  throwaway git worktree and cannot touch the working tree.
+---
+
+# outsource — use convertible as a different mind
+
+`outsource` drives the **`convertible`** CLI so a Claude agent can hand a scoped
+task to a *different* engine (default: a local vLLM `Qwen3.6-27B` on
+`:8001`). Convertible's model is **not** assumed to be stronger than you — its
+value is **diversity**. A second, independent mind catches things the author's
+mind glides past, which is why **review** is the headline verb.
+
+This skill is the operator: a portable wrapper that resolves the CLI and turns
+each verb into a `convertible drive`, then prints the drive's result summary.
+
+## How to run
+
+The entry point is `scripts/outsource.sh`. Invoke it from the repo you want
+convertible to work on:
+
+```bash
+bash .claude/skills/outsource/scripts/outsource.sh <verb> "<text>" [options]
+```
+
+It resolves the CLI portably — an installed `convertible` on `PATH` (the normal
+case), falling back to `uv run convertible` when inside the convertible checkout,
+else an install hint.
+
+### Verbs
+
+| Verb | What it does | Side effects |
+|------|--------------|--------------|
+| `explore "<question or area>"` | Read-only investigation of the repo; the model reads and reports findings. | **None** — runs in a throwaway worktree at HEAD. |
+| `review "<what to focus on>" [--base main]` | A diverse second opinion on the **committed** diff (`<base>...HEAD`). | **None** — throwaway worktree; reviews committed changes only. |
+| `write "<task>" [--pr]` | Implement a change. Commits to a drive branch by default; `--pr` pushes + opens a PR. | In-place: a `convertible/<id>` drive branch (or a PR). |
+
+### Options
+
+| Option | Meaning |
+|--------|---------|
+| `--repo PATH` | Target repo (default: `.`). |
+| `--base BRANCH` | Base for the `review` diff (default: `main`). |
+| `--engine NAME` | Engine wheel (default: `$CONVERTIBLE_ENGINE` or `vllm-openai`). |
+| `--model NAME` | Model (default: `$CONVERTIBLE_MODEL` or `mmangkad/Qwen3.6-27B-NVFP4`). |
+| `--base-url URL` | OpenAI base URL (default: `$CONVERTIBLE_BASE_URL` or `http://localhost:8001/v1`). |
+| `--max-steps N` | Loop step budget (default: 20). |
+| `--allow-dirty` | (`write`) allow running on a dirty tree. |
+| `--pr` | (`write`) push + open a PR instead of a local drive branch. |
+
+The result printed to stdout is the drive's `TaskResult.summary` (plus
+`changed_files` / drive branch for `write`), parsed from `convertible drive
+--json`. Per-step progress streams to stderr while it runs.
+
+## When to reach for which verb
+
+- **review** — the standing use. You wrote (or an agent wrote) a change and you
+  want a candid, independent pass over the *committed* diff before you trust it.
+  Treat the output as a second opinion to weigh, not a verdict.
+- **explore** — you want a fresh, unbiased read of an unfamiliar area ("how does
+  X work here?") without anchoring on your own assumptions.
+- **write** — a small, well-scoped implementation you're happy to delegate. The
+  result lands on a drive branch you can inspect, merge, or discard.
+
+## Hard rules (do not violate)
+
+- **explore and review are read-only.** They run in a throwaway `git worktree`
+  at HEAD, so a stray write can't reach your working tree or branch; the prompts
+  also tell the model not to modify anything. Don't route a change-making task
+  through them — use `write`.
+- **`write` refuses a dirty tree** unless you pass `--allow-dirty`. This guards
+  the dirty-tree hazard: `convertible drive --no-pr` commits *uncommitted* edits
+  onto the drive branch and leaves you there. Commit or stash first.
+- **Outsourced output is a second opinion, not authority.** The engine may be a
+  smaller/different model; weigh its findings, verify its claims, and own the
+  decision yourself.
+
+## Honest limits
+
+- Read-only is enforced by **worktree isolation + prompt constraint**, not a
+  sandbox — the loop always exposes `write_file`/`run_command`, so the model can
+  still run arbitrary *read-only* commands.
+- `review` covers **committed** changes only (`<base>...HEAD`). To review
+  uncommitted work, commit it first.
+- The default engine is whatever single model is running locally; a multi-model
+  fleet (different model per verb) is separate infrastructure.
+
+## Provenance
+
+This is a **first-party convertible** skill — `agentculture/convertible` is its
+origin. guildmaster **re-broadcasts** it to the mesh (the same inbound pattern as
+the devague-origin workflow skills), tracking it in `docs/skill-sources.md`. The
+`cite, don't import` policy holds: downstream repos copy it, they don't symlink
+or depend on it.

guild_cli-0.9.1/.claude/skills/outsource/prompts/explore.md

@@ -0,0 +1,20 @@
+You are a second, independent mind brought in for a fresh read of this repository.
+You are NOT the original author — your value is a different perspective, not authority.
+
+Investigate the following and report what you find:
+
+$ARGUMENTS
+
+Rules:
+- This is READ-ONLY. Use read_file, list_dir, and read-only run_command only
+  (e.g. `git log`, `git grep`, `ls`, `rg`). Do NOT create, modify, or delete any
+  file, and do NOT run any command that changes state.
+- Be concrete: cite file paths and line numbers; quote the key code you rely on.
+- Surface what's surprising, risky, or unclear — not just a tidy summary.
+- You have a limited step budget. Read efficiently and call finish with your
+  report well before you run out — a focused finding beats endless reading.
+
+When you are done, call finish with a structured findings report:
+1. What it is / how it works (with file:line references).
+2. Notable details, edge cases, or surprises.
+3. Open questions or risks worth a closer look.

guild_cli-0.9.1/.claude/skills/outsource/prompts/review.md

@@ -0,0 +1,27 @@
+You are an independent reviewer — a different mind from whoever wrote this change.
+Your job is a candid second opinion, not a rubber stamp.
+
+Focus the review on:
+
+$ARGUMENTS
+
+The change under review is the committed diff on this branch versus its base
+(`$BASE`). Start by running, read-only:
+
+    git diff $BASE...HEAD --stat
+    git diff $BASE...HEAD
+
+then read the touched files for the context you need.
+
+Rules:
+- READ-ONLY. Do NOT modify, create, or delete any file. Only read and run
+  read-only commands.
+- Be terse and prioritized — lead with what actually matters. Don't pad.
+- Call out real problems; if it's genuinely fine, say so and say why.
+- You have a limited step budget. Read the diff efficiently and call finish with
+  your review well before you run out of steps.
+
+When you are done, call finish with a structured review:
+1. Correctness risks / likely bugs (with file:line).
+2. Design, clarity, or maintainability concerns.
+3. Concrete, actionable suggestions (ranked; most important first).

guild_cli-0.9.1/.claude/skills/outsource/prompts/write.md

@@ -0,0 +1,13 @@
+Implement the following task in this repository:
+
+$ARGUMENTS
+
+Rules:
+- Make the SMALLEST change that correctly satisfies the task.
+- Follow the repository's existing patterns, style, and conventions — read the
+  neighbouring files first so your change reads like the surrounding code.
+- You may read, create, modify files, and run commands as needed.
+- Don't widen the scope: do exactly what was asked, nothing more.
+
+When you are done, call finish with a short summary of exactly what you changed
+and why.

guild_cli-0.9.1/.claude/skills/outsource/scripts/outsource.sh

@@ -0,0 +1,259 @@
+#!/usr/bin/env bash
+#
+# outsource — hand a scoped repo task to convertible (a different engine/mind).
+#
+# Convertible's engine is not necessarily stronger than the calling agent; it is
+# a *different* mind, and diversity helps — which is why `review` is the headline
+# verb. Three verbs drive `convertible drive` and print the result:
+#
+#   outsource explore "<question or area>"   read-only investigation -> findings
+#   outsource review  "<what to focus on>"   diverse second-opinion on the diff
+#   outsource write   "<task>" [--pr]        implement a change
+#
+# explore/review run in a throwaway `git worktree` at HEAD, so they can never
+# touch your working tree or branch (any stray write is discarded). write runs
+# in-place and lands a drive branch (or a PR with --pr).
+#
+set -euo pipefail
+
+SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PROMPTS_DIR="$SKILL_DIR/prompts"
+
+# ── resolve the convertible CLI (installed, then local-dev fallback) ─────────
+CONVERTIBLE=()
+resolve_convertible() {
+    if command -v convertible >/dev/null 2>&1; then
+        CONVERTIBLE=(convertible)        # installed tool — the normal case
+        return 0
+    fi
+    # Local-dev fallback: inside the convertible checkout, run via uv.
+    local dir="$PWD"
+    while [[ -n "$dir" ]] && [[ "$dir" != "/" ]]; do
+        if [[ -f "$dir/pyproject.toml" ]] \
+            && grep -q '^name = "convertible-cli"' "$dir/pyproject.toml" 2>/dev/null; then
+            if command -v uv >/dev/null 2>&1; then
+                CONVERTIBLE=(uv run convertible)
+                return 0
+            fi
+            break
+        fi
+        dir=$(dirname "$dir")
+    done
+    cat >&2 <<'EOF'
+error: convertible CLI not found.
+hint: install it with `uv tool install convertible-cli` (or `pipx install convertible-cli`),
+      or run from inside the convertible checkout with `uv` available.
+      https://github.com/agentculture/convertible
+EOF
+    return 1
+}
+
+usage() {
+    cat <<'EOF'
+outsource — hand a scoped repo task to convertible (a different engine/mind).
+
+Usage:
+  outsource explore "<question or area>"     Read-only investigation -> findings (no side effects)
+  outsource review  "<what to focus on>"     Diverse second-opinion on the committed diff (no side effects)
+  outsource write   "<task>" [--pr]          Implement a change (drive branch, or PR with --pr)
+
+Options:
+  --repo PATH        Target repo (default: .)
+  --base BRANCH      Base for `review` diff (default: main)
+  --engine NAME      Engine wheel (default: $CONVERTIBLE_ENGINE or vllm-openai)
+  --model NAME       Model (default: $CONVERTIBLE_MODEL or mmangkad/Qwen3.6-27B-NVFP4)
+  --base-url URL     OpenAI base URL (default: $CONVERTIBLE_BASE_URL or http://localhost:8001/v1)
+  --max-steps N      Loop step budget (default: 20)
+  --timeout N        Per-request timeout, seconds (default: $CONVERTIBLE_TIMEOUT or 300)
+  --allow-dirty      (write) allow running on a dirty tree
+  --pr               (write) push + open a PR instead of a local drive branch
+
+explore/review run in a throwaway git worktree at HEAD — they cannot touch your
+working tree or branch. review compares <base>...HEAD (committed changes only).
+EOF
+}
+
+# ── parse the verb ──────────────────────────────────────────────────────────
+VERB="${1:-}"
+case "$VERB" in
+    explore | review | write) shift ;;
+    -h | --help) usage; exit 0 ;;
+    "") usage >&2; exit 2 ;;
+    *)
+        echo "error: unknown verb '$VERB' (expected explore|review|write)" >&2
+        echo "hint: run 'outsource --help'" >&2
+        exit 2
+        ;;
+esac
+
+# Required external tools — fail fast with a clear message, not an opaque
+# mid-run error, if the environment is missing one.
+require_tools() {
+    local missing=() t
+    for t in python3 git grep mktemp; do
+        command -v "$t" >/dev/null 2>&1 || missing+=("$t")
+    done
+    if [[ ${#missing[@]} -gt 0 ]]; then
+        echo "error: missing required tool(s): ${missing[*]}" >&2
+        echo "hint: outsource needs python3, git, grep, and mktemp on PATH." >&2
+        exit 2
+    fi
+}
+
+# Guard a value-taking flag: a trailing flag with no value would otherwise
+# dereference an unset $2 and abort under `set -u`.
+need_value() {  # $1 = remaining arg count ($#), $2 = flag name
+    [[ "$1" -ge 2 ]] || {
+        echo "error: $2 requires a value" >&2
+        echo "hint: run 'outsource --help'" >&2
+        exit 2
+    }
+}
+
+require_tools
+
+# ── defaults + flag parsing ─────────────────────────────────────────────────
+REPO="."
+BASE="main"
+ENGINE="${CONVERTIBLE_ENGINE:-vllm-openai}"
+MODEL="${CONVERTIBLE_MODEL:-mmangkad/Qwen3.6-27B-NVFP4}"
+BASE_URL="${CONVERTIBLE_BASE_URL:-http://localhost:8001/v1}"
+MAX_STEPS=20
+TIMEOUT="${CONVERTIBLE_TIMEOUT:-300}"
+ALLOW_DIRTY=0
+OPEN_PR=0
+ARG=""
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --repo) need_value "$#" "$1"; REPO="$2"; shift 2 ;;
+        --base) need_value "$#" "$1"; BASE="$2"; shift 2 ;;
+        --engine) need_value "$#" "$1"; ENGINE="$2"; shift 2 ;;
+        --model) need_value "$#" "$1"; MODEL="$2"; shift 2 ;;
+        --base-url) need_value "$#" "$1"; BASE_URL="$2"; shift 2 ;;
+        --max-steps) need_value "$#" "$1"; MAX_STEPS="$2"; shift 2 ;;
+        --timeout) need_value "$#" "$1"; TIMEOUT="$2"; shift 2 ;;
+        --allow-dirty) ALLOW_DIRTY=1; shift ;;
+        --pr) OPEN_PR=1; shift ;;
+        -h | --help) usage; exit 0 ;;
+        --) shift; while [[ $# -gt 0 ]]; do ARG="${ARG:+$ARG }$1"; shift; done ;;
+        -*) echo "error: unknown option '$1'" >&2; echo "hint: run 'outsource --help'" >&2; exit 2 ;;
+        *) ARG="${ARG:+$ARG }$1"; shift ;;
+    esac
+done
+
+[[ -n "$ARG" ]] || { echo "error: $VERB needs a description argument" >&2; usage >&2; exit 2; }
+[[ -d "$REPO" ]] || { echo "error: --repo is not a directory: $REPO" >&2; exit 2; }
+REPO="$(cd "$REPO" && pwd)"
+
+resolve_convertible || exit 2
+
+# Per-request timeout is config (no drive flag); EngineConfig reads it from env.
+# A local model can be slow on a growing context, so default generously.
+export CONVERTIBLE_TIMEOUT="$TIMEOUT"
+COMMON_FLAGS=(--engine "$ENGINE" --model "$MODEL" --base-url "$BASE_URL" --max-steps "$MAX_STEPS" --json)
+
+# ── render an instruction from a prompt template ────────────────────────────
+render_prompt() {
+    local file="$PROMPTS_DIR/$1.md"
+    [[ -f "$file" ]] || { echo "error: missing prompt template: $file" >&2; exit 2; }
+    ARG="$ARG" BASE="$BASE" python3 - "$file" <<'PY'
+import os, sys
+tpl = open(sys.argv[1], encoding="utf-8").read()
+sys.stdout.write(tpl.replace("$ARGUMENTS", os.environ["ARG"]).replace("$BASE", os.environ["BASE"]))
+PY
+}
+
+# ── print the TaskResult that convertible emitted as JSON on stdout ─────────
+# Reads JSON on stdin; prints a human/agent-readable digest; exits non-zero if
+# the drive failed.
+print_result() {
+    # NOTE: must be `python3 -c`, not `python3 - <<HEREDOC`: a heredoc becomes
+    # python's stdin (the script source), which would shadow the piped JSON and
+    # leave sys.stdin.read() empty. The script body uses no single quotes.
+    python3 -c '
+import sys, json
+raw = sys.stdin.read().strip()
+if not raw:
+    sys.stderr.write("error: convertible produced no result on stdout (see diagnostics above)\n")
+    sys.exit(2)
+try:
+    d = json.loads(raw)
+except Exception:
+    sys.stderr.write("error: could not parse convertible --json output:\n")
+    sys.stderr.write(raw[:2000] + "\n")
+    sys.exit(2)
+print("status:", d.get("status"))
+print()
+print((d.get("summary") or "").rstrip())
+cf = d.get("changed_files") or []
+if cf:
+    print("\nchanged files:", ", ".join(cf))
+if d.get("branch"):
+    print("drive branch:", d["branch"])
+if d.get("artifacts_path"):
+    print("artifact:", d["artifacts_path"])
+sys.exit(0 if d.get("status") == "ok" else 1)
+'
+}
+
+# ── read-only verbs: isolate the drive in a throwaway worktree at HEAD ──────
+# Worktree state is module-global, not a function local: the EXIT trap fires
+# *after* run_readonly returns, so under `set -u` a local would be unbound.
+_WT=""
+_DRIVE_BRANCH=""
+
+_cleanup_worktree() {
+    [[ -n "$_WT" ]] || return 0
+    git -C "$REPO" worktree remove --force "$_WT" >/dev/null 2>&1 || true
+    rm -rf "$_WT" >/dev/null 2>&1 || true
+    # Only ever delete the ephemeral drive branch convertible names
+    # (convertible/<task_id>) — never an unrelated local branch, even if the
+    # JSON `branch` value were unexpected.
+    if [[ "$_DRIVE_BRANCH" == convertible/* ]]; then
+        git -C "$REPO" branch -D "$_DRIVE_BRANCH" >/dev/null 2>&1 || true
+    fi
+}
+
+run_readonly() {
+    local instruction="$1"
+    git -C "$REPO" rev-parse --is-inside-work-tree >/dev/null 2>&1 \
+        || { echo "error: --repo is not a git repository: $REPO" >&2; exit 2; }
+
+    _WT="$(mktemp -d)"
+    trap _cleanup_worktree EXIT
+    git -C "$REPO" worktree add -q --detach "$_WT" HEAD
+
+    local out
+    out="$("${CONVERTIBLE[@]}" drive "$instruction" --repo "$_WT" --no-pr "${COMMON_FLAGS[@]}")" || true
+    _DRIVE_BRANCH="$(printf '%s' "$out" | python3 -c 'import sys, json
+try:
+    print(json.load(sys.stdin).get("branch") or "")
+except Exception:
+    print("")' 2>/dev/null || true)"
+    printf '%s' "$out" | print_result
+}
+
+# ── write verb: in-place drive (drive branch, or PR with --pr) ──────────────
+run_write() {
+    local instruction="$1"
+    if [[ "$ALLOW_DIRTY" -eq 0 ]] \
+        && [[ -n "$(git -C "$REPO" status --porcelain 2>/dev/null)" ]]; then
+        echo "error: working tree is dirty — commit/stash first, or pass --allow-dirty" >&2
+        echo "hint: 'convertible drive --no-pr' commits uncommitted edits onto the drive branch" >&2
+        exit 2
+    fi
+    local out
+    if [[ "$OPEN_PR" -eq 1 ]]; then
+        out="$("${CONVERTIBLE[@]}" drive "$instruction" --repo "$REPO" "${COMMON_FLAGS[@]}")"
+    else
+        out="$("${CONVERTIBLE[@]}" drive "$instruction" --repo "$REPO" --no-pr "${COMMON_FLAGS[@]}")"
+    fi
+    printf '%s' "$out" | print_result
+}
+
+case "$VERB" in
+    explore) run_readonly "$(render_prompt explore)" ;;
+    review) run_readonly "$(render_prompt review)" ;;
+    write) run_write "$(render_prompt write)" ;;
+esac

{guild_cli-0.8.5 → guild_cli-0.9.1}/.markdownlint-cli2.yaml

@@ -24,3 +24,9 @@ ignores:
   # devague working state (frames/plans are committed as JSON; reviews are
   # git-ignored) — not hand-authored prose.
   - ".devague/**"
+  # Vendored skill prompt templates (e.g. outsource's explore/review/write) are
+  # raw LLM instruction text fed verbatim to a model, not hand-authored docs —
+  # they intentionally open with prose, not an H1 (MD041), and carry $PLACEHOLDER
+  # tokens. Linting them as markdown is a category error, and editing them to
+  # satisfy a linter would fork the cited-verbatim copy (cite-don't-import).
+  - ".claude/skills/**/prompts/**"

{guild_cli-0.8.5 → guild_cli-0.9.1}/CHANGELOG.md

@@ -5,6 +5,54 @@ All notable changes to this project will be documented in this file.
 Format follows [Keep a Changelog](https://keepachangelog.com/). This project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.1] - 2026-06-02
+
+### Added
+
+- **Register `rtx-spark-cli` as a downstream consumer** in
+  `docs/skill-sources.md`. Provisioned via `guild create --apply`
+  (`agentculture/rtx-spark-cli` — agent/CLI for operating an NVIDIA RTX
+  workstation; sibling of `dgx-spark-cli`, command/pkg/dist all the repo-token
+  default `rtx-spark-cli`). Adds it to the downstream column of every canonical
+  skill (`agent-config`, `cicd`, `communicate`, `doc-test-alignment`,
+  `pypi-maintainer`, `run-tests`, `sonarclaude`, `version-bump`), the vendored
+  devague trio (`think`, `spec-to-plan`, `assign-to-workforce`), and
+  `outsource`. Build brief filed as
+  [`rtx-spark-cli#1`](https://github.com/agentculture/rtx-spark-cli/issues/1).
+
+### Changed
+
+### Fixed
+
+## [0.9.0] - 2026-05-31
+
+### Added
+
+- **Vendor the `outsource` skill** (`.claude/skills/outsource/`) — guildmaster
+  now runs the skill it will broadcast. `outsource` hands a scoped repo task to
+  [`convertible`](https://github.com/agentculture/convertible) — a *different*
+  engine/mind, not a stronger one — via three verbs: `explore` (read-only
+  investigation), `review` (a diverse second opinion on the committed diff, the
+  headline verb), and `write` (delegate a small implementation to a drive branch
+  or PR). `explore`/`review` run isolated in a throwaway `git worktree` at HEAD;
+  `write` refuses a dirty tree unless `--allow-dirty`.
+- **Register `outsource`'s origin** in `guild.skills.INBOUND_ORIGINS`
+  (`agentculture/convertible`) so `guild teach` / `onboard` / `overview` attribute
+  it to convertible and frame it as *re-broadcast*, the same inbound pattern as
+  the devague workflow trio.
+- **Ledger:** new "Inbound first-party skill (origin = `convertible`,
+  re-broadcast by `guildmaster`)" section in `docs/skill-sources.md` recording
+  `outsource`, its sole divergence (a reframed Provenance paragraph; upstream
+  already carries `type: command`), and its runtime dependency on the
+  `convertible` CLI. Downstream is empty by design — guildmaster is the first
+  holder outside convertible. Cross-links
+  [`culture-agent-template#8`](https://github.com/agentculture/culture-agent-template/issues/8),
+  which proposes adding `outsource` to the clone template.
+
+### Changed
+
+### Fixed
+
 ## [0.8.5] - 2026-05-31
 
 ### Added

{guild_cli-0.8.5 → guild_cli-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: guild-cli
-Version: 0.8.5
+Version: 0.9.1
 Summary: guildmaster — an agent and CLI that manages skills for the AgentCulture mesh.
 Project-URL: Homepage, https://github.com/agentculture/guildmaster
 Project-URL: Issues, https://github.com/agentculture/guildmaster/issues

{guild_cli-0.8.5 → guild_cli-0.9.1}/docs/skill-sources.md

@@ -32,14 +32,14 @@ current by `guild overview --scope mesh`.
 
 | Skill | Upstream | Downstream copies (known) | Notes |
 |-------|----------|---------------------------|-------|
-| `agent-config` | `guildmaster` (`.claude/skills/agent-config/`) | `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Inventory variant backing `guild show` ([#12](https://github.com/agentculture/guildmaster/issues/12)); `show.sh` + `data/backend-fingerprints.yaml` vendored verbatim from steward, SKILL.md reframed from alignment-judgment to inventory + `type: command` added. **Forked from steward:** steward retains its own alignment-focused `agent-config` variant; the inventory variant is guildmaster's to supply. |
-| `cicd` | `guildmaster` (`.claude/skills/cicd/`) — layered on `devex pr` (in `agentculture/devex`) | `afi-cli`, `devex` (adapted-thin delegate — owns `devex pr`; see [devex#53](https://github.com/agentculture/devex/pull/53)), `agtag`, `antoine`, `appsec`, `auntiepypi`, `cfafi` (still named `pr-review`), `code-lens-cli`, `culture` (still named `pr-review`), `devague`, `katvan`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `grant` (still named `pr-review`), `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Thin delegate to `devex pr` for lint / open / read / reply / delta, plus guildmaster's `status` (SonarCloud quality gate + hotspots + unresolved-thread tally) and `await` (composes `devex pr read --wait` with `status`, non-zero exit on Sonar ERROR / unresolved threads) extensions. **Inverted case:** devex, as the `devex pr` upstream, vendors the skill adapted-thin — a `workflow.sh`-only pure delegate ([devex#53](https://github.com/agentculture/devex/pull/53)). Renamed from `pr-review` in steward 0.7.0; downstream copies may keep the old name on their own cadence. |
-| `communicate` | `guildmaster` (`.claude/skills/communicate/`) | `afi-cli`, `devex` (identifier-only — vendored steward 0.11.0; scripts current as of 0.18.0), `agtag`, `antoine`, `appsec`, `auntiepypi`, `code-lens-cli`, `culture` (still named `coordinate`), `devague`, `katvan`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Cross-repo + mesh communication: file issues / hand off briefs to sibling-repo agents (auto-signed), comment on existing issues, fetch issues to inline state into briefs, and send live messages to Culture mesh channels (unsigned — nick is the speaker). Renamed from `coordinate` in steward 0.8.0; absorbed `gh-issues` (as `fetch-issues.sh`) in 0.9.1. Issue I/O backed by `agtag` (>=0.1) since steward 0.11.0 — signature resolves from local `culture.yaml` (override via `--as`). |
-| `doc-test-alignment` | `guildmaster` (`.claude/skills/doc-test-alignment/`) | `devague`, `lecodeur`, `lepenseur`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Stub; real implementation TBD. `scripts/check.sh` exits not-yet-implemented today. |
-| `pypi-maintainer` | `guildmaster` (`.claude/skills/pypi-maintainer/`) | `agtag`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Switches a PyPI package install between pypi / test-pypi / local. Generalised from the original culture-specific `change-package`. |
-| `run-tests` | `guildmaster` (`.claude/skills/run-tests/`) | `agtag`, `antoine`, `appsec`, `code-lens-cli`, `culture`, `culture-sonar-cli`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `grant`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Coverage source resolves from `[tool.coverage.run]` in `pyproject.toml`, so the script is portable across siblings without modification. |
-| `sonarclaude` | `guildmaster` (`.claude/skills/sonarclaude/`) | `antoine`, `appsec`, `code-lens-cli`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | SonarCloud API client. Project key resolves from `$SONAR_PROJECT` or `--project KEY`. |
-| `version-bump` | `guildmaster` (`.claude/skills/version-bump/`) | `afi-cli`, `agtag`, `antoine`, `appsec`, `auntiepypi`, `cfafi`, `code-lens-cli`, `culture`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `grant`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Pure Python, prepends a Keep-a-Changelog entry; no per-repo customization needed. |
+| `agent-config` | `guildmaster` (`.claude/skills/agent-config/`) | `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Inventory variant backing `guild show` ([#12](https://github.com/agentculture/guildmaster/issues/12)); `show.sh` + `data/backend-fingerprints.yaml` vendored verbatim from steward, SKILL.md reframed from alignment-judgment to inventory + `type: command` added. **Forked from steward:** steward retains its own alignment-focused `agent-config` variant; the inventory variant is guildmaster's to supply. |
+| `cicd` | `guildmaster` (`.claude/skills/cicd/`) — layered on `devex pr` (in `agentculture/devex`) | `afi-cli`, `devex` (adapted-thin delegate — owns `devex pr`; see [devex#53](https://github.com/agentculture/devex/pull/53)), `agtag`, `antoine`, `appsec`, `auntiepypi`, `cfafi` (still named `pr-review`), `code-lens-cli`, `culture` (still named `pr-review`), `devague`, `katvan`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `grant` (still named `pr-review`), `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Thin delegate to `devex pr` for lint / open / read / reply / delta, plus guildmaster's `status` (SonarCloud quality gate + hotspots + unresolved-thread tally) and `await` (composes `devex pr read --wait` with `status`, non-zero exit on Sonar ERROR / unresolved threads) extensions. **Inverted case:** devex, as the `devex pr` upstream, vendors the skill adapted-thin — a `workflow.sh`-only pure delegate ([devex#53](https://github.com/agentculture/devex/pull/53)). Renamed from `pr-review` in steward 0.7.0; downstream copies may keep the old name on their own cadence. |
+| `communicate` | `guildmaster` (`.claude/skills/communicate/`) | `afi-cli`, `devex` (identifier-only — vendored steward 0.11.0; scripts current as of 0.18.0), `agtag`, `antoine`, `appsec`, `auntiepypi`, `code-lens-cli`, `culture` (still named `coordinate`), `devague`, `katvan`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Cross-repo + mesh communication: file issues / hand off briefs to sibling-repo agents (auto-signed), comment on existing issues, fetch issues to inline state into briefs, and send live messages to Culture mesh channels (unsigned — nick is the speaker). Renamed from `coordinate` in steward 0.8.0; absorbed `gh-issues` (as `fetch-issues.sh`) in 0.9.1. Issue I/O backed by `agtag` (>=0.1) since steward 0.11.0 — signature resolves from local `culture.yaml` (override via `--as`). |
+| `doc-test-alignment` | `guildmaster` (`.claude/skills/doc-test-alignment/`) | `devague`, `lecodeur`, `lepenseur`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Stub; real implementation TBD. `scripts/check.sh` exits not-yet-implemented today. |
+| `pypi-maintainer` | `guildmaster` (`.claude/skills/pypi-maintainer/`) | `agtag`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Switches a PyPI package install between pypi / test-pypi / local. Generalised from the original culture-specific `change-package`. |
+| `run-tests` | `guildmaster` (`.claude/skills/run-tests/`) | `agtag`, `antoine`, `appsec`, `code-lens-cli`, `culture`, `culture-sonar-cli`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `grant`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Coverage source resolves from `[tool.coverage.run]` in `pyproject.toml`, so the script is portable across siblings without modification. |
+| `sonarclaude` | `guildmaster` (`.claude/skills/sonarclaude/`) | `antoine`, `appsec`, `code-lens-cli`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | SonarCloud API client. Project key resolves from `$SONAR_PROJECT` or `--project KEY`. |
+| `version-bump` | `guildmaster` (`.claude/skills/version-bump/`) | `afi-cli`, `agtag`, `antoine`, `appsec`, `auntiepypi`, `cfafi`, `code-lens-cli`, `culture`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `grant`, `telek`, `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Pure Python, prepends a Keep-a-Changelog entry; no per-repo customization needed. |
 
 > **How the downstream column is maintained.** The "Downstream copies (known)"
 > entries are kept in sync with guildmaster's own drift detector:
@@ -86,14 +86,50 @@ harmless on `claude-code`. This is the only divergence from upstream.
 
 | Skill | Origin | Downstream copies (known) | Notes |
 |-------|--------|---------------------------|-------|
-| `think` | `devague` (`agentculture/devague`, `../devague/.claude/skills/think/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Operator for the **idea→spec** leg (announcement frame → capture/classify claims → interrogate with honesty conditions → park open vagueness → `export` once the frame converges). Renamed from `devague` in devague 0.4.0. **Divergence:** `type: command` added. Runtime dep: `uv tool install devague`. |
-| `spec-to-plan` | `devague` (`agentculture/devague`, `../devague/.claude/skills/spec-to-plan/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Operator for the **spec→plan** leg (`devague plan ...`): seed from a converged frame, cover every coverage target with acceptance-gated, acyclically-ordered tasks, park unknowns as risks, `export` once the plan converges. New in devague 0.4.0. **Divergence:** `type: command` added. Runtime dep: `uv tool install devague`. |
-| `assign-to-workforce` | `devague` (`agentculture/devague`, `../devague/.claude/skills/assign-to-workforce/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist` | Operator for the **implementation** leg: reads `devague plan waves` (read-only) and fans out independent tasks to one agent per task per wave in isolated git worktrees, with main-agent TDD-gated merges. Three human gates: spec / split plan / final PR. The CLI stays non-orchestrating ([devague#20](https://github.com/agentculture/devague/issues/20)). New in devague 0.10.0. **Divergence:** `type: command` added. Runtime deps: `uv tool install devague`, `git worktree`, the vendored `cicd` skill (for gate-3 `devex pr open`). |
+| `think` | `devague` (`agentculture/devague`, `../devague/.claude/skills/think/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Operator for the **idea→spec** leg (announcement frame → capture/classify claims → interrogate with honesty conditions → park open vagueness → `export` once the frame converges). Renamed from `devague` in devague 0.4.0. **Divergence:** `type: command` added. Runtime dep: `uv tool install devague`. |
+| `spec-to-plan` | `devague` (`agentculture/devague`, `../devague/.claude/skills/spec-to-plan/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Operator for the **spec→plan** leg (`devague plan ...`): seed from a converged frame, cover every coverage target with acceptance-gated, acyclically-ordered tasks, park unknowns as risks, `export` once the plan converges. New in devague 0.4.0. **Divergence:** `type: command` added. Runtime dep: `uv tool install devague`. |
+| `assign-to-workforce` | `devague` (`agentculture/devague`, `../devague/.claude/skills/assign-to-workforce/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `convertible`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli` | Operator for the **implementation** leg: reads `devague plan waves` (read-only) and fans out independent tasks to one agent per task per wave in isolated git worktrees, with main-agent TDD-gated merges. Three human gates: spec / split plan / final PR. The CLI stays non-orchestrating ([devague#20](https://github.com/agentculture/devague/issues/20)). New in devague 0.10.0. **Divergence:** `type: command` added. Runtime deps: `uv tool install devague`, `git worktree`, the vendored `cicd` skill (for gate-3 `devex pr open`). |
 
 Downstream is empty by design: these are still being introduced to the mesh.
 `guild teach --new --skill <name> --to <repos>` frames them as *new* skills to
 add fresh (not stale copies to resync).
 
+## Inbound first-party skill (origin = `convertible`, re-broadcast by `guildmaster`)
+
+`outsource` flows the **same opposite direction** as the devague trio above: a
+sibling, [`convertible`](https://github.com/agentculture/convertible), is its
+author/upstream; guildmaster pulls it from convertible and re-broadcasts it to
+the mesh. `cite, don't import` still applies — re-sync, when it later changes
+upstream, from `../convertible/.claude/skills/outsource/`.
+
+Where the devague skills drive a deterministic CLI, `outsource` is a portable
+wrapper (`scripts/outsource.sh`) that drives the **`convertible` CLI** so a
+Claude agent can hand a scoped task to a *different* engine/mind (default: a
+local vLLM `Qwen3.6-27B`) — `explore` (read-only investigation), `review` (a
+diverse second opinion on the committed diff, the headline verb), and `write`
+(delegate a small implementation to a drive branch / PR). `explore`/`review` run
+isolated in a throwaway `git worktree` at HEAD; `write` refuses a dirty tree.
+
+**Divergence from verbatim.** The upstream copy already carries `type: command`
+(load-bearing on the culture backend), so no frontmatter change was needed. The
+**only** edit is the SKILL.md *Provenance* paragraph: upstream says "the inverse
+of the other skills … which convertible vendors *from* guildmaster" — true in
+convertible's repo, misleading here — reframed to "guildmaster re-broadcasts it
+… tracking it in `docs/skill-sources.md`." No script or prompt body is edited.
+
+**Runtime dependency:** the `convertible` CLI on `PATH`
+(`uv tool install convertible-cli`) plus a reachable engine (override the local
+default via `--engine` / `--model` / `--base-url` or `CONVERTIBLE_*` env). Absent
+the CLI, the wrapper exits with a clear install hint rather than crashing.
+
+| Skill | Origin | Downstream copies (known) | Notes |
+|-------|--------|---------------------------|-------|
+| `outsource` | `convertible` (`agentculture/convertible`, `../convertible/.claude/skills/outsource/`) | — (broadcast pending; [`culture-agent-template#8`](https://github.com/agentculture/culture-agent-template/issues/8) proposes adding it to the clone template), `rtx-spark-cli` | First-party convertible skill: hand a scoped task to a *different* engine/mind. Verbs `explore` / `review` / `write`. **Divergence:** Provenance paragraph reframed for re-broadcast (above); `type: command` already present upstream. Runtime dep: `uv tool install convertible-cli` + a reachable engine. |
+
+Downstream is empty by design — guildmaster is the first holder outside
+convertible. `guild teach --new --skill outsource --to <repos>` frames it as a
+*new* skill when broadcasting.
+
 ## guildmaster-origin skills (origin = `guildmaster`)
 
 These are guildmaster's **own** operator skills — not vendored from anyone and

{guild_cli-0.8.5 → guild_cli-0.9.1}/guild/skills/__init__.py

@@ -15,12 +15,14 @@ from __future__ import annotations
 
 # Skills whose origin is a *sibling* (not guildmaster): re-broadcasting them
 # carries an origin-attribution block so consumers know guildmaster only
-# re-broadcasts. Mirrors the "Inbound workflow skills" section of
-# ``docs/skill-sources.md`` (the devague trio).
+# re-broadcasts. Mirrors the "Inbound workflow skills" + "Inbound first-party"
+# sections of ``docs/skill-sources.md`` (the devague trio; convertible's
+# ``outsource``).
 INBOUND_ORIGINS: dict[str, str] = {
     "think": "agentculture/devague",
     "spec-to-plan": "agentculture/devague",
     "assign-to-workforce": "agentculture/devague",
+    "outsource": "agentculture/convertible",
 }
 
 # guildmaster's own skills — present in ``.claude/skills/`` but NOT part of the

{guild_cli-0.8.5 → guild_cli-0.9.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "guild-cli"
-version = "0.8.5"
+version = "0.9.1"
 description = "guildmaster — an agent and CLI that manages skills for the AgentCulture mesh."
 readme = "README.md"
 license = "MIT"

{guild_cli-0.8.5 → guild_cli-0.9.1}/uv.lock

@@ -179,7 +179,7 @@ wheels = [
 
 [[package]]
 name = "guild-cli"
-version = "0.8.5"
+version = "0.9.1"
 source = { editable = "." }
 dependencies = [
     { name = "pyyaml" },