Files
VoiceStudio/docs/agents/triage-labels.md
T
Palash Debnath 74796bb2ab chore(agents): record issue tracker, triage labels and domain-doc layout (#1400)
Scaffolds the per-repo agent configuration the engineering skills assume: where issues live (GitHub Issues via the gh CLI), the five canonical triage labels, and the single-context domain-doc layout. Adds docs/agents/{issue-tracker,triage-labels,domain}.md and an '## Agent skills' block in both CLAUDE.md and AGENTS.md so the two stay in sync.

Documentation only — no runtime code is touched.

Review fixes: CONTEXT.md is now described as 'read it when it exists' rather than stating its absence as permanent, and both directory-tree fences carry a language identifier (markdownlint MD040).
2026-08-07 05:35:09 +05:30

1.8 KiB

Triage Labels

The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.

Label in mattpocock/skills Label in our tracker Meaning
needs-triage needs-triage Maintainer needs to evaluate this issue
needs-info needs-info Waiting on reporter for more information
ready-for-agent ready-for-agent Fully specified, ready for an AFK agent
ready-for-human ready-for-human Requires human implementation
wontfix wontfix Will not be actioned

When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.

Edit the right-hand column to match whatever vocabulary you actually use.

Repo notes

wontfix and needs-info pre-date this file — they were already in use on debpalash/VoiceStudio with exactly these names, which is why the mapping is an identity mapping rather than an alias table. Reuse them; do not create variants (won't-fix, needs-information) alongside them.

needs-triage, ready-for-agent and ready-for-human were created for this vocabulary on 2026-08-07.

This repo also carries labels outside the triage vocabulary — bug, enhancement, documentation, question, duplicate, invalid, good first issue, help wanted, roadmap, from-discord, v0.3.0-investigate. They classify what an issue is; the five above track where it is in the queue. The two sets are orthogonal — applying a triage label never means removing a type label.