Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions .agents/skills/triage-issue-local/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,15 @@ The label taxonomy for this repository is managed in `.github/issue-triage/confi

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.

### `feature` vs `bug` / `enhancement`

`feature` is in this repository's taxonomy (`.github/issue-triage/config.json`). Apply it **at your discretion** whenever the issue is a feature request, alongside the following guidelines:

- **`feature`** — the reporter is asking for something that does not exist in Warp today: a new command, setting, surface, integration, or workflow. If the classification step (core skill, step 2) identifies the issue as an enhancement/feature request rather than a bug, and the request describes genuinely new functionality, include `feature` in the label set.
- **`bug`** — the reporter describes existing functionality behaving incorrectly (crashes, wrong output, broken rendering, regressions). Never apply `feature` to a bug report, even when the reporter frames a gap as "broken" — if the described behavior never existed in Warp, classify it as a feature request (`feature`), not a bug, regardless of how the reporter phrased it.
- **`enhancement` vs `feature`** — both describe non-bug requests, so both may be relevant on the same issue: apply `enhancement` when the ask improves, extends, or reconfigures something that already exists (e.g. more granular control over an existing setting, better performance on an existing flow); apply `feature` when the ask is for new functionality that doesn't exist yet. A single issue can carry both when a feature request also reads as a meaningful enhancement to an adjacent existing capability, but most feature requests only need `feature`. When uncertain whether something "already exists", check the codebase and docs (per the core skill's process) before deciding.
- The feature-request issue template currently seeds `enhancement` only — this is a template default, not a triage signal. Add `feature` on top of the template's seeded labels whenever the request is a genuine feature ask; do not treat the template's `enhancement` seed as a reason to omit `feature`.

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.
Expand Down
4 changes: 4 additions & 0 deletions .github/issue-triage/config.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@
"color": "a2eeef",
"description": "New feature or request."
},
"feature": {
"color": "f47f64",
"description": "This issue is a feature request, not a bug report."
},
"documentation": {
"color": "0075ca",
"description": "Improvements or additions to documentation."
Expand Down
4 changes: 4 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,10 @@ The Warp team applies one of the following labels when an issue is ready for con

Anyone can pick up a ready issue — readiness labels are not assignments, and the best implementation wins through normal review. If an issue has been sitting un-triaged or you'd like readiness re-evaluated, mention **@oss-maintainers** in a comment to flag it for the team.

### Escalation for maintainer attention

Beyond the readiness labels above, we run an internal process that surfaces untriaged or unreviewed issues for direct Warp team attention. An issue is escalated through that process only once it has received **at least 5 upvotes** (👍 reactions on the issue). Issues labeled **`feature`** are never escalated through this path, regardless of upvote count — feature requests are already tracked through the `ready-to-spec` / `ready-to-implement` labeling flow described above. If you'd like an issue looked at sooner and it doesn't yet meet the upvote bar, mention **@oss-maintainers** in a comment instead of waiting.

## Contribution Flow

Steps owned by you (the contributor) are shown in yellow; steps owned by the Warp team or Oz are shown in blue.
Expand Down
Loading