maestro: Command for Claude Code

Triage Idea

Run the upstream idea-inbox triage loop on a GitHub issue created from .github/ISSUE_TEMPLATE/idea.yml. Dispatches subagent-idea-triager, validates the structured report through .maestro/hooks/parse_idea_triager_report.py, and prints a digest. Does not mutate GitHub state without explicit user confirmation — every comment posting and label change is gated on a yes/no prompt. v0.16.1 is the foundation milestone; auto-mutation flows ship later (see Consultive Boundaries below).

Usage: /triage-idea #123 or /triage-idea 123

---

Arguments

$ARGUMENTS contains the idea issue number with an optional # prefix. Extract the first \d+ and reject if no number is present.

---

Instructions

Step 0: Parse arguments

Extract the first run of digits from $ARGUMENTS and re-validate the result is digits-only before exporting. Never pass $ARGUMENTS directly to gh.

IDEA_NUMBER=$(printf '%s' "$ARGUMENTS" | grep -oE '[0-9]+' | head -n1)
[[ "$IDEA_NUMBER" =~ ^[0-9]+$ ]] || {
  echo "no issue number in arguments" >&2
  exit 1
}
export IDEA_NUMBER

If no number is found, ask: "Which idea issue should I triage?" and stop.

Step 1: Confirm the issue exists and surface its labels

gh issue view "$IDEA_NUMBER" \
  --json number,title,labels,state,body \
  --jq '{number, title, state, labels: [.labels[].name], body}'

• If gh is not installed or not authenticated → exit 1 with the standard hint (brew install gh / gh auth login).
• If the issue does not exist → exit 1.
• If the issue is CLOSED → exit 1. Re-open or pick a different issue.
• If the labels do not include idea, print a warning and ask the user whether to proceed anyway. Some users may file ideas without the template; the triager can still score the body.

Step 2: Dispatch subagent-idea-triager

Invoke subagent-idea-triager via the Agent tool. Pass:

• The full issue JSON from Step 1 (including title and body).
• The repo name: gh repo view --json nameWithOwner --jq .nameWithOwner.