Auto Issue Triage
This initiative has opted in to Agent Auto Issue Triage. When you have
spare capacity inside a workspace task scoped to this initiative, drain
items from the planning issues queue using the issue_triage_* tools.
You MUST follow this loop. Do not open Jira / Notion / Monday tickets
directly for these items — the platform already curates them inside
managents_planning_issues.
Sources you can pull from
dependabot — Dependabot vulnerability alerts synced from GitHub.
github_issue — GitHub issues synced from the connected repos.
agent_report — incidents another agent filed via
report_incident (mirrored into planning because the initiative opted
in to autoIncidentReports.planning.enabled).
The opt-in config may restrict you further with a source allow-list, a
label allow-list, and a label deny-list. The list tool already applies
all of these — items it returns are guaranteed eligible.
Loop
- Call
issue_triage_list to see eligible items. Optional inputs:
sources: subset of the allowed sources.
limit: 1–50 (default 10).
- Pick one item that fits your role and the initiative's current
sprint priorities. Prefer items with smaller diffs and clearer
reproduction steps if you are not sure.
- Call
issue_triage_claim with the chosen issue_id. Pass a short
note describing what you intend to do. If the call fails with
already_claimed_by_other, pick the next item.
- Do the work:
- For
github_issue: read the issue body, the linked PRs, and
the linked file paths. Reproduce locally with
agent_filesystem_* / agent_terminal_run when possible. Open a
branch and a PR with github_create_pull_request. Link the PR
back in the issue comments via github_* tools.
- For
dependabot: read the alert's metadata, find the
affected package + version, attempt the minimal upgrade in a
dedicated branch, run the relevant test suite, and open a PR.
- For
agent_report: read the linked incident key, look at the
bundled evidence files (initiative_file_*), and either (a) fix
the underlying defect with a PR, or (b) decide it is platform
scope and escalate via report_incident again with a clearer
hypothesis.
- When you finish (PR opened or fix landed), leave the row in
in_progress and call issue_triage_release with
keep_status: true so it stays in the queue for a human reviewer
to verify and close.
- When you decide the item is out of scope, blocked, or already
resolved, call
issue_triage_release with a short reason. The
row goes back to open and other agents can pick it up.
Hard rules
- Only claim one item at a time per workspace task unless the
initiative explicitly raised
autoIssueTriage.maxConcurrentClaims.
- If the initiative has
requireApprovalBeforePr: true, stop after
reproducing the issue and ask the user / scrum-master before
opening the PR. The platform does not block the PR call — your
compliance with this is what protects the customer.
- Never delete or close planning rows directly. The verification flow
closes them; you mark progress through
issue_triage_release and
status transitions in your own PR.
- If a tool inside the loop fails (sandbox timeout, MCP unavailable,
unauthorized), do not retry indefinitely. File one
report_incident with category: "issue" and release the claim
with reason: "blocked by <tool>".
1---2name: auto-issue-triage3description: Drain Dependabot / GitHub / agent_report items from the initiative's planning queue: list, claim, fix, release.4---56# Auto Issue Triage78This initiative has opted in to **Agent Auto Issue Triage**. When you have9spare capacity inside a workspace task scoped to this initiative, drain10items from the planning issues queue using the `issue_triage_*` tools.1112You MUST follow this loop. Do not open Jira / Notion / Monday tickets13directly for these items — the platform already curates them inside14`managents_planning_issues`.1516## Sources you can pull from1718* **`dependabot`** — Dependabot vulnerability alerts synced from GitHub.19* **`github_issue`** — GitHub issues synced from the connected repos.20* **`agent_report`** — incidents another agent filed via21 `report_incident` (mirrored into planning because the initiative opted22 in to `autoIncidentReports.planning.enabled`).2324The opt-in config may restrict you further with a source allow-list, a25label allow-list, and a label deny-list. The list tool already applies26all of these — items it returns are guaranteed eligible.2728## Loop29301. Call `issue_triage_list` to see eligible items. Optional inputs:31 * `sources`: subset of the allowed sources.32 * `limit`: 1–50 (default 10).332. Pick **one** item that fits your role and the initiative's current34 sprint priorities. Prefer items with smaller diffs and clearer35 reproduction steps if you are not sure.363. Call `issue_triage_claim` with the chosen `issue_id`. Pass a short37 `note` describing what you intend to do. If the call fails with38 `already_claimed_by_other`, pick the next item.394. Do the work:40 * For **`github_issue`**: read the issue body, the linked PRs, and41 the linked file paths. Reproduce locally with42 `agent_filesystem_*` / `agent_terminal_run` when possible. Open a43 branch and a PR with `github_create_pull_request`. Link the PR44 back in the issue comments via `github_*` tools.45 * For **`dependabot`**: read the alert's `metadata`, find the46 affected package + version, attempt the minimal upgrade in a47 dedicated branch, run the relevant test suite, and open a PR.48 * For **`agent_report`**: read the linked incident key, look at the49 bundled evidence files (`initiative_file_*`), and either (a) fix50 the underlying defect with a PR, or (b) decide it is platform51 scope and escalate via `report_incident` again with a clearer52 hypothesis.535. When you finish (PR opened or fix landed), leave the row in54 `in_progress` and **call `issue_triage_release` with55 `keep_status: true`** so it stays in the queue for a human reviewer56 to verify and close.576. When you decide the item is **out of scope, blocked, or already58 resolved**, call `issue_triage_release` with a short `reason`. The59 row goes back to `open` and other agents can pick it up.6061## Hard rules6263* Only claim **one** item at a time per workspace task unless the64 initiative explicitly raised `autoIssueTriage.maxConcurrentClaims`.65* If the initiative has `requireApprovalBeforePr: true`, **stop after66 reproducing the issue** and ask the user / scrum-master before67 opening the PR. The platform does not block the PR call — your68 compliance with this is what protects the customer.69* Never delete or close planning rows directly. The verification flow70 closes them; you mark progress through `issue_triage_release` and71 status transitions in your own PR.72* If a tool inside the loop fails (sandbox timeout, MCP unavailable,73 unauthorized), do **not** retry indefinitely. File one74 `report_incident` with `category: "issue"` and release the claim75 with `reason: "blocked by <tool>"`.