Skip to content

docs: refresh label catalog to match live taxonomy#715

Open
corazonthedev wants to merge 1 commit into
dgenio:mainfrom
corazonthedev:fix/label-catalog-refresh
Open

docs: refresh label catalog to match live taxonomy#715
corazonthedev wants to merge 1 commit into
dgenio:mainfrom
corazonthedev:fix/label-catalog-refresh

Conversation

@corazonthedev

Copy link
Copy Markdown
Contributor

Summary

docs/agent-context/labels.md was badly stale:

  • Documented 20+ labels that don't exist on the repo (needs triage, confirmed, stale, breaking, launch, etc.)
  • Used colon prefix (area:context) instead of slash (area/context)
  • Missing priority/, complexity/, and milestone/ families entirely
  • Wrong colour codes throughout

Rewrite from the live label set (verified against gh label list):

Metric Before After
Labels documented ~28 (many phantom) 30 (all real)
Families 4 7
area: colon prefix 6 entries 0
area/ slash prefix 0 entries 7
Keep-current command none gh label list snippet

Verification

Doc labels: 30
Live labels: 30
✅ All doc labels exist on repo (0 missing)
✅ Zero area: colon entries
✅ No phantom labels remain

Closes

Closes #711

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 dgenio left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for tackling the label-catalog drift — but I think this PR has been overtaken by events and should likely be closed as superseded:

  1. #711 is already resolved on main. Commit 791bdde refreshed docs/agent-context/labels.md and closed #711. The current canonical file documents the priority:, complexity:, area/, and type: families plus all topic labels, good-first-ai-issue, and area/gateway·area/cli·area/benchmarks·area/docs. This branch (cut before that landed) is now in merge conflict for that reason.
  2. Merging would regress the canonical file. This version drops the type: family and ~25 topic labels, and switches priority:/complexity: to the slash form, whereas main treats the colon priority:<level> form as canonical and notes the slash/spaced variants as drift to consolidate.
  3. The "30 live labels / 0 missing" check is truncated. gh label list defaults to 30 rows, but the repo has well over 30 labels — so the file omits many in-use labels and asserts type:feature/type:task/good-first-ai-issue are "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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refresh the stale label catalog docs/agent-context/labels.md to match the live taxonomy (wrong area: prefix; missing priority/complexity/type families)

2 participants