Skip to content

Update triage taxonomy with agent: primary types and agent:priority-high - #15868

Merged
vkodithala merged 3 commits into
masterfrom
varoon/triage-taxonomy-update
Sep 9, 2026
Merged

vkodithala merged 3 commits into
masterfrom
varoon/triage-taxonomy-update

Conversation

@vkodithala

@vkodithala vkodithala commented Sep 8, 2026 •

Copy link
Copy Markdown
Contributor

Description

Updates the repository's issue triage configuration and companion triage skill to encode provenance directly into agent-assigned classifications (agent:bug, agent:feature, agent:security, agent:documentation) and support urgent issue prioritization with agent:priority-high.

What changed

  • .github/issue-triage/config.json: Added agent:bug (#8ff8fd), agent:feature (#f47f64), agent:security (#a0ce9f), agent:documentation (#5f966f), and agent:priority-high (#b60205) label definitions.
  • .agents/skills/triage-issue-local/SKILL.md: Documented the primary agent types and agent:priority-high in the label taxonomy section and updated heuristics to direct the triage agent to classify issues into primary agent types (exempting billing/appeals reports that route to support via warp:needs-support) and explicitly bias toward applying agent:priority-high to regressions ("broke in recent version", "worked before"), crashes/panics, data loss, and security vulnerabilities.

Stack & Connections

This PR is part of a 3-repo stack to pause non-KTLO triage noise ahead of Factory GA:

Co-Authored-By: Warp agent@warp.dev

Support explicit issue classification and priority tagging in local triage
guidance, adding feature, security, and priority:high labels to config.json.

Co-Authored-By: Warp <agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Sep 8, 2026
@warp-for-oss

warp-for-oss Bot commented Sep 8, 2026 •

Copy link
Copy Markdown
Contributor

@vkodithala

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@warp-for-oss warp-for-oss Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview

This PR updates Warp's issue-triage label configuration and repo-local triage guidance to add feature, security, and priority:high classification paths.

Concerns

  • The new primary-type requirement conflicts with the existing billing/appeals support-routing rule unless support-only reports are explicitly exempted.
  • The security guidance treats vulnerability disclosures as normal public triage instead of directing reporters to the private disclosure channels in SECURITY.md.
  • The new feature label coexists with the existing enhancement label and feature-request template behavior, which can split triage/search/routing unless the migration or aliasing behavior is defined.

Security

  • Public vulnerability reports need private-disclosure handling before this guidance is used by automated triage.

Tests

No tests are added or changed; the diff is limited to issue-triage configuration and skill guidance.

Verdict

Found: 0 critical, 3 important, 0 suggestions

Request changes

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

- When the issue includes screenshots, videos, logs, stack traces, or command output, use them as primary evidence and ask follow-up questions only for missing details that cannot be inferred from that evidence.
- Before asking any follow-up questions, check the Warp documentation and the repository's existing feature set to determine whether the desired behavior the reporter is describing is already supported. If an existing feature, setting, or workflow satisfies the request, recommend it to the reporter instead of treating the issue as a bug or feature gap.
- If the report is about billing (pricing, plans, subscriptions, payments, refunds, invoices, AI request quotas, charges) or about appeals (account suspensions, bans, takedowns, abuse decisions, or other account-status disputes), do not attempt to triage it as an actionable bug or feature request. Instead, notify the reporter that these requests must go through Warp's support channels (https://docs.warp.dev/support-and-community/troubleshooting-and-support/sending-us-feedback) and direct them there for resolution. Apply the relevant `area:billing` or `area:auth` label as appropriate so the issue is still routed correctly.
- Classify issues into at least one primary type (`bug`, `feature`, `security`, `documentation`). Explicitly bias towards tagging regressions ("broke in recent version", "worked in previous build"), panics/crashes, and security reports with `priority:high`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [IMPORTANT] This conflicts with the billing/appeals rule immediately above: those reports should be routed to support, not forced into one of the OSS primary types. Scope the primary-type requirement to actionable OSS issues and make the same exception in the section below.

Suggested change
- Classify issues into at least one primary type (`bug`, `feature`, `security`, `documentation`). Explicitly bias towards tagging regressions ("broke in recent version", "worked in previous build"), panics/crashes, and security reports with `priority:high`.
- Classify actionable OSS issues into at least one primary type (`bug`, `feature`, `security`, `documentation`). For billing and appeals reports covered above, apply the routing label and support-channel guidance instead. Explicitly bias towards tagging regressions ("broke in recent version", "worked in previous build"), panics/crashes, and security reports with `priority:high`.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Erm yeah I think we should do this but not critical since we have guidance in the bullet above (which should apply due to precedence) directing agents to escalate to support for billing/etc. issues. Can add though.

Every issue should be classified with at least one primary type label:
- `bug`: Something isn't working.
- `feature`: This issue is a feature request, not a bug report.
- `security`: Security vulnerability or report.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [IMPORTANT] [SECURITY] Public vulnerability reports should be redirected to the private channels in SECURITY.md rather than handled as normal public issue triage; otherwise the triage agent can amplify disclosure details with labels and comments.

Suggested change
- `security`: Security vulnerability or report.
- `security`: Security-adjacent issue or report. If the issue may disclose a vulnerability, avoid public details and direct the reporter to the private disclosure channels in `SECURITY.md`.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't think this is actually important, but lemme know if there's a reason for this. If there's information that shouldn't be exposed it's already in the (public) issue, so there's no extra harm being done.

Comment thread .github/issue-triage/config.json Outdated
"color": "d73a4a",
"description": "Something isn't working."
},
"feature": {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [IMPORTANT] Adding feature without migrating or aliasing the existing enhancement label creates two canonical labels for the same issue type; the feature-request template still auto-applies enhancement, so triage/search/routing can split. Update the template/workflow to normalize one label or document enhancement as a legacy alias.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's fine to have both labels for now, IIUC enhancement is used for features or bugs reported via the dedicated feature request form. It's fine to have both labels but I think what we're getting at is that feature, bug, security, and priority:high are all agent-assigned and we should maybe distinguish them from other sources?

How broad-sweeping would it be to refactor this logic so that all labels just have an agent: alias to avoid interference with existing workflows? Maybe this is the change to make.

Use agent:bug, agent:feature, agent:security, and agent:documentation to
encode provenance for agent-assigned classifications, and update local
triage guidance.

Co-Authored-By: Warp <agent@warp.dev>
@vkodithala vkodithala changed the title Update triage taxonomy with feature, security, and priority:high Update triage taxonomy with agent: primary types and priority:high Sep 8, 2026
Update label definition in config.json and local skill guidance to use
agent:priority-high.

Co-Authored-By: Warp <agent@warp.dev>
@vkodithala vkodithala changed the title Update triage taxonomy with agent: primary types and priority:high Update triage taxonomy with agent: primary types and agent:priority-high Sep 8, 2026
@vkodithala
vkodithala merged commit 6db7fb7 into master Sep 9, 2026
46 of 48 checks passed
@vkodithala
vkodithala deleted the varoon/triage-taxonomy-update branch September 9, 2026 02:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants