issue-triage

name	issue-triage
description	Triage new and updated GitHub issues on ric03uec/clawrium — apply type/complexity/area labels and draft a planning file.
version	0.1.0
license	MIT
author	clawrium
platforms	["linux","macos"]
metadata	{"cadence":"every 10 minutes","trigger":"poll","outputs":["labels","pull-request"]}

issue-triage

Triage incoming work on ric03uec/clawrium. Run on a 10-minute poll cycle. The loop is: find issues that need triage → read them carefully → apply labels → draft a planning file as a PR.

Inputs

For each candidate issue:

• Title and body.
• Current labels (skip if needs-triage is absent or the issue already has a type:* label).
• The repo's LABELS.md for the allowed taxonomy. Do not invent labels.

Candidates are issues opened or updated in the last 15 minutes (giving the poll a 5-minute overlap so nothing is missed during a slow run). Use:

gh issue list --repo ric03uec/clawrium \
  --search "sort:updated-desc updated:>$(date -u -d '15 minutes ago' +%Y-%m-%dT%H:%M:%SZ)" \
  --json number,title,body,labels,updatedAt

Output

• Apply labels from the taxonomy in LABELS.md. At minimum: one type:*, one complexity:*, one area:*. Add needs-review when the issue lacks a clear Definition of Done.
• Open a PR adding .itx/active/<issue-number>/plan.md with a one-page scaffold (Outcome / Approach / Files / Risk). Title: chore(triage): draft plan for #<n>. Body links to the issue.

Hard constraints

• Never apply the agent-ready label. The PAT denies it; even if it did not, this label is a human decision.
• Never push directly to main or merge a PR. PRs target main with a feature branch named triage/<issue-number>-<slug>.
• If the issue body is empty or one sentence, label needs-review and leave a single short comment asking for Outcome + Definition of Done. Do not invent requirements.
• If LABELS.md is missing or unreadable, stop and post a [ITX-STUCK] comment on the issue rather than guessing label names.

Anti-patterns

• Re-labeling issues that already have a type:* label — assume a human or earlier triage decided. Touch only the missing dimensions.
• Drafting an .itx/active/<n>/plan.md that exceeds one page. The plan is a starting point for /itx:plan-create, not a substitute for it.
• Commenting on the issue with summaries of the body. The body is the source of truth; do not paraphrase it back.