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.

Type labels

Label	Meaning
prd	Context-only parent issue (PRD). Never implemented directly; excluded from agent dispatch batches
task	Implementable work item (a slice produced by issue breakdown)

Creation-time rules (for issue-producing skills)

When publishing an issue to the tracker:

• A PRD / parent issue gets prd. Type labels are orthogonal to triage labels — a PRD keeps whatever triage label applies; the prd label alone excludes it from dispatch.
• A work item (an implementable slice) gets task plus the triage label that reflects its state (normally ready-for-agent).

Agent lifecycle labels (agent:: prefix)

Applied and removed automatically by the /dispatch pipeline (canonical implement-issues workflow). Humans normally never set these.

Label	Meaning
agent::implementing	An agent is implementing this issue in an isolated worktree
agent::reviewing	Adversarial review of the pushed branch is in progress
agent::fixing	Fix round (max 1) is addressing review findings
agent::merging	Serial rebase + full gate re-run + merge is in progress
agent::stalled	The pipeline gave up; the latest issue note explains why

Rules:

• Success leaves no lifecycle label: the merged MR closes the issue via Closes #N.
• Dispatch discovery skips any issue carrying an agent::* label (in-flight or stalled) or the prd label (context-only parent).
• To retry a stalled issue: fix the cause, remove agent::stalled, keep ready-for-agent.