Repository navigation
openkazoo: map agent triage roles to labels that exist - #73
Merged
Merged
Conversation
triage-labels.md still carried its unedited boilerplate, mapping the five canonical roles to needs-triage, needs-info, ready-for-agent, ready-for-human and wontfix. None of those labels exist in this repo, so an agent following the doc fails on `gh issue edit --add-label`. Only wontfix has a counterpart (Won't Fix). The table now says so, lists the six labels the repo actually uses, and tells agents to skip the label rather than invent one. AGENTS.md's "map 1:1" claim is corrected to match.
rdnn
approved these changes
Sep 25, 2026
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
2 participants
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.
Context
docs/agents/triage-labels.mdstill carried its unedited boilerplate, including the footer "Edit the right-hand column to match whatever vocabulary you actually use." It mapped the five canonical triage roles toneeds-triage,needs-info,ready-for-agent,ready-for-humanandwontfix.None of those labels exist in this repo. The actual set is:
An agent following the doc fails on
gh issue edit --add-label needs-triage.AGENTS.mdcompounded it by asserting the roles "map 1:1 to their default label strings" — it is 1:0 for four of the five.Rationale
Two options: create the four missing labels, or make the doc honest about the ones that exist. This PR takes the second.
The four absent roles encode a workflow — particularly the agent/human implementation split — that this repo's label set has no way to express today. Creating labels to satisfy a document would be inventing process, which is a maintainer's call and not a documentation fix.
Help Wantedis the nearest neighbour toready-for-human, but it means "we want outside help", which is a different claim; the table says so rather than pretending otherwise.The doc now also lists the six labels actually in use, tells agents to take the action a role implies and skip the label when there is no counterpart, and points at
gh label listfor verification rather than asking readers to trust a checked-in table.If the agent/human split is wanted, the right follow-up is to create those labels and revisit this table — happy to do that instead.
Test evidence
Label set read from the live repo with
gh label list --limit 100; every entry in the new table is copied from that output, including the spacing and apostrophe inWon't Fixthat would otherwise silently fail a label call.No code changes. Split out of #72, where this was found while checking which labels to apply to #70 and #71.