Triage Issue Local

Repo-specific triage guidance for warp

Prerequisite: install the parent skill

This skill specializes the core triage-issue skill (named in the specializes frontmatter field) and is not functional on its own. Before applying its guidance, confirm the parent skill is installed and resolvable at .agents/skills/triage-issue/SKILL.md. If it is missing, install it first by copying the skill directory from the source declared in the specializes_source frontmatter field (warpdotdev/oz-for-oss:.agents/skills/triage-issue). Then continue with the guidance below.

This file is a companion to the core triage-issue skill. It does not redefine the triage output schema, safety rules, or follow-up-question contract. It only specializes the override categories the core skill marks as overridable.

Heuristics

• warp is the public-facing Warp desktop client repository. Treat public issue reports as potentially incomplete and avoid asking for secrets, tokens, private workspace names, private repository names, or account identifiers in the public issue thread.
• Distinguish the user's observed Warp behavior from their guesses about Rust modules, UI components, server behavior, feature flags, or product intent.
• For issue reports that mention another terminal, editor, shell, or CLI tool, identify whether the problem is Warp-specific or generally reproducible outside Warp before assigning Warp ownership.
• 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 agent type (agent:bug, agent:feature, agent:security, agent:documentation), except billing or appeals reports which route to support via warp:needs-support. Explicitly bias towards tagging regressions ("broke in recent version", "worked in previous build"), panics/crashes, and security reports with agent:priority-high.

Follow-up question limit

Ask at most 2 follow-up questions per triage response. Each question must be high-value: it should meaningfully change the label assignment, owner routing, or reproduction confidence if answered. Do not ask questions whose answers can be inferred from existing evidence, and do not bundle multiple sub-questions into a single bullet. If more than 2 unknowns exist, prioritize the two that are most likely to unblock triage.

Label taxonomy

The label taxonomy for this repository is managed in .github/issue-triage/config.json. Prefer labels from that configuration, especially the area:*, os:*, repro:*, accessibility, needs-info, duplicate, agent:priority-high, and primary agent issue-type labels (agent:bug, agent:feature, agent:security, agent:documentation). Do not invent new labels unless the prompt explicitly allows it.

Primary issue types

Every issue should be classified with at least one primary agent type label:

• agent:bug: Bugs/regressions. Assigned by Warp triage agent.
• agent:feature: This issue is a feature request, not a bug report. Assigned by Warp triage agent.
• agent:security: Security issues/vulnerabilities that are immediately escalated. Assigned by Warp triage agent.
• agent:documentation: Missing documentation. Assigned by Warp triage agent.

Priority

• agent:priority-high: High-priority issues that are immediately escalated. Assigned by Warp triage agent. Tag issues with agent:priority-high when there is evidence of a regression ("broke in recent version", "worked in previous build"), panic or crash, data loss, or a security vulnerability.

Evaluate ready-to-implement during triage instead of relying on issue-template defaults. For bug reports, apply ready-to-implement only when the issue is reproducible from the provided evidence or straightforward local verification and the likely fix appears narrow enough to implement without a product spec, design mocks, or substantial investigation. If the bug is not reproducible, lacks a clear fix path, requires product/design decisions, or needs deeper technical discovery, omit ready-to-implement and prefer needs-info, ready-to-spec, needs-mocks, or the appropriate repro:* label.

Use area labels based on the user's reported surface:

• area:shell-terminal for terminal output, block rendering, shell integration, prompt rendering, command execution display, and terminal-emulation behavior.
• area:terminal-input for command-line input editing, cursor movement, key handling, and typed text behavior.
• area:window-tabs-panes for window, tab, pane, split, layout, and focus behavior.
• area:editor-notebooks for editors, notebooks, markdown rendering, LSP, and code display.
• area:agent for agent conversations, agent mode, cloud/local agent execution, prompts, and AI-specific UI.
• area:code-review for git diff views, review UI, review comments, and PR-focused agent flows.
• area:mcp for MCP server connection, tool/resource discovery, OAuth, and integration issues.
• area:settings-keybindings for settings UI, preferences, keyboard shortcuts, and keybinding configuration.
• area:warp-drive for Warp Drive objects, sync, sharing, workflows, notebooks, tab configs, and persisted artifacts.
• area:performance:* when the report includes CPU, memory, GPU, startup, rendering, latency, or responsiveness symptoms. Add the more specific CPU, memory, or GPU label when the evidence points to that resource.