Triage

Move issues on the project issue tracker through a small state machine. Every triaged issue carries exactly one state label, one category label, and one size label.

Label vocabulary

Full label definitions live in docs/agents/labels.md. The working set:

State (apply exactly one): needs-triage / ready-for-agent / ready-for-human / blocked / wontfix

Category (apply exactly one): bug / enhancement / chore / epic

Size (apply exactly one): size:S / size:M / size:L / size:XL

Normal flow: unlabelled → needs-triage → one of ready-for-agent, ready-for-human, blocked, or wontfix. The maintainer can override at any time — flag transitions that look unusual and confirm before proceeding.

Conflicting state labels. If an issue carries two or more state labels, surface the conflict and ask which one to keep before doing anything else. Never silently pick one.

Branches