loom-guide.yml

name: Loom Guide

# Periodic support role for the Loom orchestration system.
#
# Guide triages and prioritizes the backlog, ensuring the next batch of
# `loom:issue` work is the highest-leverage work available.
#
# Cadence: every 15 minutes (matches the daemon's historical interval).
#
# Disabled by default. To enable on your fork:
#   1. Uncomment the `schedule:` block below.
#   2. Add a `CLAUDE_API_KEY` secret to the repository
#      (Settings -> Secrets and variables -> Actions).
#
# This is Phase 2a of the shepherd/daemon deprecation epic (#3372 / #3375).

on:
  # schedule:
  #   # Uncomment and set CLAUDE_API_KEY secret to enable.
  #   - cron: "*/15 * * * *"
  workflow_dispatch:  # Allow manual runs for testing.

jobs:
  guide:
    runs-on: ubuntu-latest
    timeout-minutes: 10
    permissions:
      issues: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v7
      - name: Install Claude CLI
        run: npm install -g @anthropic-ai/claude-code
      - name: Run guide
        env:
          ANTHROPIC_API_KEY: ${{ secrets.CLAUDE_API_KEY }}
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        # Pinned model ID per the role mapping (issue #3477, Phase 1): cron
        # support roles are predictable, cost-sensitive load, so they pin an
        # exact ID rather than an alias. Bump deliberately on lineup changes.
        run: claude -p "/guide" --model claude-sonnet-4-6 --dangerously-skip-permissions