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).
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.