Skip to content

Starter kits

issue-triage — the issue-only triage loop

Reads every new or updated issue since the last beat, ranks it by urgency, and leaves a suggested label and priority — never applies either itself.…

Reads every new or updated issue since the last beat, ranks it by urgency, and leaves a suggested label and priority — never applies either itself. daily-triage's five-line-report mold, narrowed to issues alone.

Category: D · Issue & intake · Heartbeat: schedule (every few hours, inside the 2h–1d band) · Level: L1 (report-only) · Cost: Low

Quickstart

1. Read LOOP.md — the six parts, the prompt, the limits, the three stops.
2. issue-triage-state.md is your spine — already committed with empty
   last-seen marks.
3. Claude Code: point a Routine or `claude -p` cron at
   .claude/skills/loop-task/SKILL.md. OpenCode: rename
   opencode.json.example → opencode.json, add the AGENTS.md line, wire
   skills/loop-task.md into a cron + wrapper script.
4. Rehearse once, by hand, before the schedule ever fires:
   "Run the issue-triage skill now, exactly as the schedule would."
5. Grade the rehearsal with the loop-verifier agent. PASS → arm the
   schedule. FAIL → fix the skill, never the report.

What's in this kit

FileRole
LOOP.mdthe definition — six parts, prompt, limits, ownership, three stops
issue-triage-state.mdthe spine — last-seen issue marks, so a beat never re-triages what it already reported
loop-budget.mdcaps: 12 runs/day, 60k tokens/day, 80% tripwire
loop-constraints.mdthe constitution — report-only, no labels/closures
loop-run-log.mdappend-only, one line per beat
.claude/skills/loop-task/SKILL.mdthe procedure (Claude Code)
.claude/agents/loop-verifier.mdthe read-only reviewer that grades the report's format
opencode.json.example · skills/loop-task.mdthe OpenCode twin — same skill text, cron + wrapper heartbeat

Loop Ready checklist

  • Provable success condition — issue-triage-report.md exists, ≤5 lines, ranked, template-matched
  • Run limit — 12/day
  • Spine written first, committed empty
  • Report-only (L1) start — writes only issue-triage-report.md + spine + log
  • Human gate placed — you apply labels/priority yourself; nothing acts until you do
  • One log line per beat, no silent runs
  • Kill switch — loop-pause-all in loop-budget.md

How this relates to the course

The heartbeat, level, and cost come from the Part V §15D catalog entry. The shape itself — scheduled poll, last-seen marks in the spine, a ≤5-line ranked report, a read-only reviewer — is daily-triage's mold, applied exactly as Step 13a invites: "swap the skill and the report name and out comes a security sweeper, a dependency scout, a docs-drift detector." This kit is that reuse, narrowed from issues+PRs+CI down to issues alone.


Source: Panaversity's Loop Engineering: A Crash Course (S1). Full attribution: resources/sources.md.