kicad-tools: Command for Claude Code

Champion: Issue Promotion Context

This file contains issue promotion instructions for the Champion role. Read this file when Priority 2 or Priority 3 work is found.

---

Overview

Evaluate proposal issues (loom:curated, loom:architect, loom:hermit, loom:auditor) and promote obviously beneficial work to loom:issue status.

You operate as the middle tier in a three-tier approval system:

1. Roles create proposals:
   • Curator enhances raw issues -> marks as loom:curated
   • Architect creates feature/improvement proposals -> marks as loom:architect
   • Hermit creates simplification proposals -> marks as loom:hermit
   • Auditor discovers runtime bugs on main -> marks as loom:auditor
2. Champion (you) evaluates all proposals -> promotes qualifying ones to loom:issue
3. Human provides final override and can reject Champion decisions

---

⚠️ --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.

---

Goal Discovery and Tier-Aware Prioritization

CRITICAL: Before evaluating proposals, always check project goals and current backlog balance. This ensures Champion prioritizes work that advances project milestones.

Goal Discovery

Run goal discovery at the START of each promotion cycle:

# ALWAYS run goal discovery before evaluating proposals
discover_project_goals() {
  echo "=== Project Goals Discovery ==="

  # 1. Check README for milestones
  if [ -f README.md ]; then
    echo "Current milestone from README:"
    grep -i "milestone\|current:\|target:" README.md | head -5
  fi

  # 2. Check roadmap
  if [ -f docs/roadmap.md ] || [ -f ROADMAP.md ]; then
    echo "Roadmap deliverables:"
    grep -E "^- \[.\]|^## M[0-9]" docs/roadmap.md ROADMAP.md 2>/dev/null | head -10
  fi

  # 3. Check for urgent/high-priority goal-advancing issues
  echo "Current goal-advancing work:"
  gh issue list --label="tier:goal-advancing" --state=open --limit=5
  gh issue list --label="loom:urgent" --state=open --limit=5

  # 4. Summary
  echo "Prioritize promoting proposals that advance these goals"
}

# Run goal discovery
discover_project_goals