Artifact 524eacfeef9ccb457572c61f2a55660a8ae2c9368229bd7220232400a434b79a:
- File
docs/agents/triage-labels.md
— part of check-in
[f894e896c1]
at
2026-05-04 16:50:06
on branch trunk
— chore(agents): scaffold ## Agent skills section + docs/agents/ (#107)
Adds the per-repo configuration that the engineering skills (triage, to-issues, to-prd, diagnose, tdd, improve-codebase-architecture) assume:
- Issue tracker mapping → docs/agents/issue-tracker.md (GitHub via gh CLI) - Triage label vocabulary → docs/agents/triage-labels.md (canonical names; needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) - Domain doc layout → docs/agents/domain.md (single-context; ADRs live in docs/architecture/, no CONTEXT.md so skills fall back to CLAUDE.md + MEMORY.md)
CLAUDE.md gets an ## Agent skills block pointing at the three docs.
The four missing triage labels (needs-triage, needs-info, ready-for-agent, ready-for-human) were created on the GitHub repo at the same time. (user: [email protected], size: 1100) [annotate] [blame] [check-ins using]
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.
| Canonical role | 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 |
Category roles:
| Canonical role | Label in our tracker |
|---|---|
bug |
bug |
enhancement |
enhancement |
When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.