Label Reference
Zozo reads a fixed vocabulary of GitHub labels. A Control Label changes whether or when the Dispatcher picks an Issue. A Classification Label identifies a Wayfinder artifact or Ticket type and can veto a pick when that kind is never fleet work.
Control Labels
| Label | Meaning | Effect on a pick |
|---|---|---|
ready-for-agent | Spec is complete and an AFK agent can pick up the Issue. | Makes the Issue eligible, subject to the other eligibility rules. |
agent-in-progress | An autonomous agent is actively working the Issue. | Stops a fresh pick because the Issue is already claimed. |
needs-info | The dispatch attempt ended and a human must review and re-tag the Issue. | Stops a fresh pick. |
needs-triage | A human needs to evaluate or complete the Issue before agent work starts. | Stops a fresh pick. |
blocked | The Issue has an unresolved blocking Issue. | Stops a fresh pick until every blocker resolves. |
wontfix | The Issue won't be worked on. | Stops a fresh pick. |
awaiting-answers | A Clarification is waiting for answers or a valid Declared Understanding; objective conflicts require explicit adoption. | Stops a fresh pick while the existing attempt waits. |
landing-blocked | Landing couldn't merge the completed work and will retry. | Stops a fresh pick. |
not-for-agent | The Issue is valid human-owned work that Zozo must exclude. | Stops a fresh pick and prevents automatic promotion to ready-for-agent. |
priority-next | A human wants this work considered before ordinary eligible work. | Orders picks. Among eligible Issues in the same Project, these are picked first. |
Use not-for-agent for human-owned work
not-for-agent is the only label for work a person must implement. A ready-for-human label isn't part of Zozo's vocabulary and won't stop a pick.
An open Pull Request that closes an Issue also vetoes a fresh pick while it awaits Landing. Zozo reads that state from GitHub, so it doesn't need an awaiting-landing label.
Classification Labels
Classification Labels identify Wayfinder work. A kind that is never fleet work stops a pick, including a forced targeted Dispatch.
| Label | Meaning | Effect on a pick |
|---|---|---|
wayfinder:map | Wayfinder shared Map. | A Map is never fleet work; this label stops a pick even when ready-for-agent is present. |
wayfinder:spec | Wayfinder endgame Spec. | A Spec is never fleet work; this label stops a pick even when ready-for-agent is present. |
wayfinder:research | Wayfinder research Ticket for AFK work. | A research Ticket is never fleet work; this label stops a pick even when ready-for-agent is present. |
wayfinder:grilling | Wayfinder grilling Ticket for human-in-the-loop work. | A grilling Ticket is never fleet work; this label stops a pick even when ready-for-agent is present. |
wayfinder:prototype | Wayfinder prototype Ticket for human-in-the-loop work. | A prototype Ticket is never fleet work; this label stops a pick even when ready-for-agent is present. |
wayfinder:task | Wayfinder task Ticket. | None. |
Labels outside these tables are Inert Labels. Zozo doesn't read them when it selects work, though they can still carry useful meaning for people in GitHub.
Related
- How Dispatch Decides explains the complete eligibility and selection process.
- Watch a Project explains how to register a Project and place work on the Frontier.
- Work Model follows an Issue from selection to a Pull Request.