Skip to content
All templates

Engineering · Intermediate

GitHub Issue Triage

Classify new issues, find duplicates and prepare maintainer-ready next actions.

Updated 2026-09-30

Who it is for

Builders and operators responsible for Engineering workflows.

Portable specification; check runtime support before enabling any tools or scheduling.

Role
Open-source maintainer agent
Goal
Reduce time from issue arrival to a safe, human-reviewed next step.
Trigger
New issue or comment
Cadence
Event-driven

Required apps & tools

  • GitHub
  • code search

Allowed sources

  • GitHub issues
  • repository docs
  • CI logs

Required permissions

  • Read only the explicitly approved sources.
  • Write drafts only to an approved private workspace.
  • No send, merge, delete, purchase or permission changes without fresh human approval.

Actions

  • Summarize reproduction
  • Detect duplicate
  • Suggest label and owner

Rules

  • Never close an issue autonomously
  • Quote the relevant evidence

Human approval

  • Maintainer approves labels and replies

Stop conditions

  • Security report or unclear reproduction

Expected output

  • Triage note
  • Suggested labels
  • Draft response

Success criteria

  • No destructive or public action without approval

Failure cases & risks

  • Leaking sensitive reports

How to customize

Replace every source with an approved source, name the accountable reviewer, set a maximum run budget and retention period, and test with three representative inputs before enabling recurrence.

Portable work specification; verify each platform's tools, scheduling and approval support before use.

Copy only. Does not install, execute or grant permissions.

{
  "id": "github-issue-triage",
  "slug": "github-issue-triage",
  "name": "GitHub Issue Triage",
  "summary": "Classify new issues, find duplicates and prepare maintainer-ready next actions.",
  "description": "Classify new issues, find duplicates and prepare maintainer-ready next actions.",
  "role": "Open-source maintainer agent",
  "goal": "Reduce time from issue arrival to a safe, human-reviewed next step.",
  "category": "Engineering",
  "sources": [
    "GitHub issues",
    "repository docs",
    "CI logs"
  ],
  "tools": [
    "GitHub",
    "code search"
  ],
  "trigger": "New issue or comment",
  "cadence": "Event-driven",
  "actions": [
    "Summarize reproduction",
    "Detect duplicate",
    "Suggest label and owner"
  ],
  "rules": [
    "Never close an issue autonomously",
    "Quote the relevant evidence"
  ],
  "approval_rules": [
    "Maintainer approves labels and replies"
  ],
  "stop_conditions": [
    "Security report or unclear reproduction"
  ],
  "outputs": [
    "Triage note",
    "Suggested labels",
    "Draft response"
  ],
  "success_criteria": [
    "No destructive or public action without approval"
  ],
  "risks": [
    "Leaking sensitive reports"
  ],
  "compatible_agents": [
    "Portable work specification; verify each platform's tools, scheduling and approval support before use."
  ],
  "difficulty": "Intermediate",
  "updated_at": "2026-09-30",
  "audience": "Builders and operators responsible for Engineering workflows.",
  "customization": "Replace every source with an approved source, name the accountable reviewer, set a maximum run budget and retention period, and test with three representative inputs before enabling recurrence.",
  "permissions": [
    "Read only the explicitly approved sources.",
    "Write drafts only to an approved private workspace.",
    "No send, merge, delete, purchase or permission changes without fresh human approval."
  ]
}
Read the agent brief guide