docs: refresh label catalog to match live taxonomy#715
Open
corazonthedev wants to merge 1 commit into
Open
Conversation
The labels.md was badly stale: documented 20+ labels that don't exist on the repo, used colon prefix (area:context) instead of slash (area/context), and was missing the priority/, complexity/, and milestone/ families entirely. Rewrite from the live label set (verified against gh label list): - 30 labels across 7 families - All area/* use slash form - Add gh label list command for keeping current - Note on commonly-used but unregistered labels
dgenio
requested changes
Jun 20, 2026
dgenio
left a comment
Owner
There was a problem hiding this comment.
Thanks for tackling the label-catalog drift — but I think this PR has been overtaken by events and should likely be closed as superseded:
- #711 is already resolved on
main. Commit791bdderefresheddocs/agent-context/labels.mdand closed #711. The current canonical file documents thepriority:,complexity:,area/, andtype:families plus all topic labels,good-first-ai-issue, andarea/gateway·area/cli·area/benchmarks·area/docs. This branch (cut before that landed) is now in merge conflict for that reason. - Merging would regress the canonical file. This version drops the
type:family and ~25 topic labels, and switchespriority:/complexity:to the slash form, whereas main treats the colonpriority:<level>form as canonical and notes the slash/spaced variants as drift to consolidate. - The "30 live labels / 0 missing" check is truncated.
gh label listdefaults to 30 rows, but the repo has well over 30 labels — so the file omits many in-use labels and assertstype:feature/type:task/good-first-ai-issueare "not registered," when all three exist on the repo. The keep-current snippet has the same gap (add--limit 999).
If there's net-new content worth keeping (the milestone/ section, the gh label list keep-current snippet), please rebase onto main and layer just those additions on top of the current file — after fixing the --limit truncation and the "not registered" wording.
Generated by Claude Code
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/agent-context/labels.mdwas badly stale:needs triage,confirmed,stale,breaking,launch, etc.)area:context) instead of slash (area/context)priority/,complexity/, andmilestone/families entirelyRewrite from the live label set (verified against
gh label list):area:colon prefixarea/slash prefixgh label listsnippetVerification
Closes
Closes #711