GitHub Triage

Step 3: Bug reproduction (bugs only)

If the issue is categorized as a bug, attempt to reproduce it before starting a grilling session. This will vary by codebase, but do your best:

• Read the reporter's reproduction steps (if provided)
• Explore the codebase to understand the relevant code paths
• Try to reproduce the bug: run tests, execute commands, or trace the logic to confirm the reported behavior
• If reproduction succeeds, report what you found to the maintainer — include the specific behavior you observed and where in the code it originates
• If reproduction fails, report that too — the bug may be environment-specific, already fixed, or the report may be inaccurate
• If the report lacks enough detail to attempt reproduction, note that — this is a strong signal the issue should move to needs-info

The reproduction attempt informs the grilling session and the agent brief. A confirmed reproduction with a known code path makes for a much stronger brief.

Step 4: Grilling session (if needed)

If the issue needs to be fleshed out before it's ready for an agent, interview the maintainer to build a complete specification.

Step 5: Apply the outcome

Depending on the outcome:

• ready-for-agent — post an agent brief comment (see AGENT-BRIEF.md)
• ready-for-human — post a comment summarizing the task, what was established during triage, and why it needs human implementation. Use the same structure as an agent brief but note the reason it can't be delegated to an agent (e.g. requires judgment calls, external system access, design decisions, or manual testing).
• needs-info — post triage notes with progress so far and questions for the reporter (see Needs Info Output below)
• wontfix (bug) — post a polite comment explaining why, then close the issue
• wontfix (enhancement) — write to .out-of-scope/, post a comment linking to it, then close the issue (see OUT-OF-SCOPE.md)
• needs-triage — apply the label. Optionally leave a comment if there's partial progress to capture.

Workflow: Quick State Override

When the maintainer explicitly tells you to move an issue to a specific state (e.g. "move #42 to ready-for-agent"), trust their judgment and apply the label directly.

Still show a confirmation of what you're about to do: which labels will be added/removed, and whether you'll post a comment or close the issue. But skip the grilling session entirely.

If moving to ready-for-agent without a grilling session, ask the maintainer if they want to write a brief agent brief comment or skip it.

Needs Info Output

When moving an issue to needs-info, post a comment that captures the grilling progress and tells the reporter what's needed:

## Triage Notes

**What we've established so far:**

- point 1
- point 2

**What we still need from you (@reporter):**

- question 1
- question 2

Include everything resolved during the grilling session in "established so far" — this work should not be lost. The questions for the reporter should be specific and actionable, not vague ("please provide more info").

Resuming Previous Sessions

When triaging an issue that already has triage notes from a previous session:

1. Read all comments to find prior triage notes
2. Parse what was already established
3. Check if the reporter has answered any outstanding questions
4. Present the maintainer with an updated picture: "Here's where we left off, and here's what the reporter has said since"
5. Continue the grilling from where it stopped — do not re-ask resolved questions