You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The task label is overused across the open issue backlog. It currently covers UI polish, bugs, tech debt, CI false positives, tracking work, and implementation follow-ups, which makes the backlog harder to scan and filter.
Current snapshot checked on 2026-05-21:
57 open issues
33 labeled task
10 labeled bug
14 labeled enhancement
13 labeled tech-debt
This is not just a backlog cleanup problem. The current templates and policy still make task the easiest bucket for maintainer/agent execution work.
PR docs(github): tighten PR and task templates against agent misuse #752 tightened the PR template and task issue template after agent misuse. It also documented follow-ups around issue-template restructuring and left the .github/workflows/** -> task labeler behavior as a separate decision.
The current label policy still treats PR type labels as exactly one of bug, enhancement, task, or documentation, and currently requires tech-debt to be paired with task. Any taxonomy change must update this policy deliberately instead of only changing prose.
Proposed taxonomy
Use one primary issue/PR type where possible:
bug: existing behavior is broken, incorrect, regressed, flaky, misleading, or creates false positives.
enhancement: new capability or user-visible workflow improvement.
documentation: docs, repo guidance, templates, policies, or written process.
Problem
The
tasklabel is overused across the open issue backlog. It currently covers UI polish, bugs, tech debt, CI false positives, tracking work, and implementation follow-ups, which makes the backlog harder to scan and filter.Current snapshot checked on 2026-05-21:
taskbugenhancementtech-debtThis is not just a backlog cleanup problem. The current templates and policy still make
taskthe easiest bucket for maintainer/agent execution work.Prior work to preserve
Do not repeat or undo these decisions:
pr-triageworkflow to avoid label race failures..github/workflows/** -> tasklabeler behavior as a separate decision.bug,enhancement,task, ordocumentation, and currently requirestech-debtto be paired withtask. Any taxonomy change must update this policy deliberately instead of only changing prose.Proposed taxonomy
Use one primary issue/PR type where possible:
bug: existing behavior is broken, incorrect, regressed, flaky, misleading, or creates false positives.enhancement: new capability or user-visible workflow improvement.documentation: docs, repo guidance, templates, policies, or written process.tech-debt: internal cleanup, maintainability, architecture, test/quality debt, or non-user-visible refactor work.task: execution-only, audit, spike, tracking, upstream-followup, or migration work without clearer bug, feature, docs, or tech-debt semantics.taskshould not be the default label for "work an agent can do." It should be narrow.Proposed changes
tasklabel description to narrow its meaning.tech-debtbecomes a primary type label or remains supplemental but no longer requirestask..github/scripts/label-policy-check.jsand its tests to match the chosen taxonomy..github/pull_request_template.mdtype-label checklist iftech-debtbecomes a primary type..github/ISSUE_TEMPLATE/03-task.ymlwith explicit "do not use this for bug / feature / docs / tech-debt" guidance..github/ISSUE_TEMPLATE/04-tech-debt.ymlissue form iftech-debtis promoted to a first-class issue type..github/ISSUE_TRIAGE.mdor in the issue forms, explaining when to use each type.Non-goals
tasklabel.Suggested follow-up batches
After the guardrail PR lands:
task.tech-debtissues and remove unnecessarytask.Acceptance criteria
taskis documented as a narrow execution/tracking type, not a general work bucket.