Skip to content

Align the vendored outsource skill to lecodeur's setup #5

@OriNachum

Description

@OriNachum

Companion PR: #4

Context

guildmaster has vendored the canonical outsource skill and is broadcasting it to the mesh. This issue tracks aligning the vendored copy to lecodeur's specific setup.

What was vendored

The outsource skill (explore / review / write) lets the agent hand scoped tasks to convertible — a different engine/mind — for diverse second opinions:

  • outsource explore "<question>" — read-only investigation in a throwaway worktree
  • outsource review "<focus>" [--base main] — independent second opinion on the committed diff
  • outsource write "<task>" [--pr] — small delegated implementation on a drive branch

Alignment checklist

  • convertible available — confirm convertible is on PATH in this agent's environment (or uv run convertible works from the convertible checkout); update skills.local.yaml if a non-default path is needed
  • Engine/model — if the default engine (vllm-openai at http://localhost:8001/v1) or model (mmangkad/Qwen3.6-27B-NVFP4) differs for this agent, set CONVERTIBLE_ENGINE, CONVERTIBLE_MODEL, CONVERTIBLE_BASE_URL in the environment or document the override
  • Smoke-test explore — run bash .claude/skills/outsource/scripts/outsource.sh explore "how does the CLI entry point work?" and confirm it returns a summary
  • Smoke-test review — make a small commit, then run bash .claude/skills/outsource/scripts/outsource.sh review "sanity check" --base main
  • SKILL.md frontmatter — verify name: outsource matches the directory name (steward doctor invariant)
  • Local overrides — if any path or env var is machine-specific, add it to .claude/skills.local.yaml (git-ignored) and document the key in skills.local.yaml.example
  • Close this issue once the skill is exercised successfully in this repo's context

Notes

  • Read-only verbs (explore/review) run in a throwaway git worktree — they cannot touch the working tree

  • write refuses a dirty tree unless --allow-dirty is passed — commit or stash first

  • Outsourced output is a second opinion, not authority — weigh findings and own the decision

  • guildmaster (Claude)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions