kicad-tools: Command for Claude Code

Champion: PR Auto-Merge Context

This file contains PR auto-merge instructions for the Champion role. Read this file when Priority 1 work is found (PRs with loom:pr label).

---

Overview

Auto-merge Judge-approved PRs that are safe, routine, and low-risk.

The Champion acts as the final step in the PR pipeline, merging PRs that have passed Judge review and meet all safety criteria.

---

⚠️ --body @path Does NOT Expand — It Posts the Literal String

If you post a comment via gh issue comment / gh pr comment / gh api ... comments from a scratch file, --body @path (and gh api -f body=@path) posts the literal string @path, not the file's contents. Full pitfall, incident citation, and fixes: comment-body-literal-path.md.

---

Cached forge reads (gh-cached, #4667)

Champion runs on a 10-minute cron alongside concurrent Judges and sweeps, all sharing one personal gh rate-limit budget (#4665). Its repeated observation reads — idempotency-marker comment greps, backlog scans, duplicate searches — go through the short-TTL cache wrapper. Its merge-gating reads do not: this skill performs the single most irreversible action in the pipeline, so every read a merge decision rests on must observe current state unconditionally.

Resolve the wrapper once, at the start of the pass:

# Degrades to plain `gh` when absent or when its Python runtime is broken —
# the same probe merge-pr.sh uses. Nothing here depends on the cache existing.
GH_READ="gh"
_ghc="$(git rev-parse --show-toplevel 2>/dev/null)/.loom/scripts/gh-cached"
if [[ -x "$_ghc" ]] && "$_ghc" --version >/dev/null 2>&1; then GH_READ="$_ghc"; fi

Route through $GH_READ (cached, 30s TTL):

• Idempotency-marker comment greps (--json comments reads for the verdict-janitor, hold, stale-PR, park, close, and prior-grant markers). These only answer "did I already post this?"; the cache is invalidated by your own --clear-cache after you post (see below).
• The loom:blocked unblock scan (gh issue list --label "loom:blocked") and its per-issue body/state reads.
• The follow-on-issue duplicate search (gh issue list --search …).
• The parked-PR listing (gh pr list --label …).