Skip to content

docs: overhaul GitHub labels — namespaced taxonomy + retroactive labeling #33

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
DimazzzZ merged 1 commit into from
Aug 17, 2026
Merged

docs: overhaul GitHub labels — namespaced taxonomy + retroactive labeling #33

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
39 changes: 37 additions & 2 deletions docs/agents/triage-labels.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,10 @@
# Triage label vocabulary
# Label vocabulary

All labels are namespaced. Every PR gets exactly one `type:` label and 0–2
`domain:` labels. Issues additionally get one triage label and, when relevant,
one `priority:` label.

## Triage (issues)

Use these exact labels when triaging incoming issues:

Expand All @@ -10,4 +16,33 @@ Use these exact labels when triaging incoming issues:
| Ready for human | `ready-for-human` | Requires human implementation or intervention. |
| Will not fix | `wontfix` | Will not be actioned. |

Do not invent alternate labels unless this mapping is deliberately updated.
## Priority (optional, issues)

| Label | Meaning |
| --- | --- |
| `priority: critical` | Blocks release or breaks production. |
| `priority: high` | Impacts users; should ship soon. |
| `priority: low` | Nice-to-have; can be deferred. |

## Type (required on every PR and issue)

| Label | Meaning |
| --- | --- |
| `type: feature` | New feature or enhancement. |
| `type: bug` | Defect or unexpected behavior. |
| `type: refactor` | Code quality change with no behavior change. |
| `type: docs` | Documentation only. |
| `type: chore` | CI, build, deps, config. |

## Domain (optional, may combine)

| Label | Scope |
| --- | --- |
| `domain: provider` | AI provider integrations. |
| `domain: ui` | UI/UX (status bar, dialogs, tooltips). |
| `domain: settings` | Plugin configuration. |
| `domain: security` | Credentials, PasswordSafe, OAuth. |
| `domain: service` | Background services, refresh, caching. |
| `domain: infra` | CI/CD, build, gradle. |

Do not invent alternate labels unless this mapping is deliberately updated.
Loading