rota

Tracker labels

Generated from internal/labels; do not edit this page by hand. Regenerate the defaults with go generate ./internal/labels.

rota labels sync compares the effective registry and project declarations with the tracker. It previews missing definitions, wrong descriptions or colors, overlapping tracker defaults, unused claims, and unknown labels. --apply creates missing definitions and repairs metadata on GitHub, GitLab and Linear. It never deletes or renames a label. Jira and It’s a Plan report names only; their sync makes no writes.

Open prefixes below describe existing definitions only. Sync does not create a literal prefix label. A claim used by no open issue is reported and left unchanged. Retired labels (including site:support) are unknown and left unchanged, as are overlapping tracker defaults (bug, enhancement, documentation).

issues.labels.* overrides the configured names and prefixes. Declare project labels in issues.labels.extra as a JSON object of name to description; exact registry entries retain their own metadata. Labels read through review.crossLabels, review.lenses, or ship.review.labels also count as known. The registry documents who applies and reads each definition and when it leaves an issue; sync never removes definitions.

For a project-specific page, run go run ./internal/labels/genref --config .rota/config.json <output.md>. This uses the same resolved entries as sync, including custom names and project declarations.

Colors are six-digit RGB: blue for milestones and sizes, purple for routing and review, red for defects and blocked work, orange for priorities and review changes, yellow for round decisions, green for released work, and pale blue for project labels and tasks. Existing colors change only with --apply.

Name or prefix Description Color Group Config Sets Reads Removed from issue
in-progress Work is held by a worker. 1d76db state issues.labels.inProgress item claim/state backlog; rounds; gate release or next state
needs-review Work is ready for review. 5319e7 state issues.labels.needsReview ship; item state rounds; review queue review result or next state
changes-requested Review feedback needs another pass. d93f0b state issues.labels.changesRequested review; item state backlog; rounds next state
released Work shipped in a release. 0e8a16 state issues.labels.released release backlog; release retained
not-planned Closed without a planned implementation. cfd3d7 state issues.labels.notPlanned item complete; tracker close backlog; tracker close reason reopen or next state
blocked Work is blocked and remains open. b60205 state issues.labels.blocked item complete –reason blocked backlog next state
needs-human Work is handed to the maintainer. b60205 state issues.labels.needsHuman round transfer –to human round candidates return to worker queue
milestone-tracker Tracking issue for a rota milestone. 0052cc milestone issues.labels.milestoneTracker milestone create milestone lookup; backlog filtering retained
type:bug A defect to fix. d73a4a type issues.labels.types.bug item create; migrate backlog type type change
type:feature A capability to build. a2eeef type issues.labels.types.feature item create; migrate backlog type type change
type:task A maintenance or supporting task. c5def5 type issues.labels.types.task item create; migrate backlog type type change
p0 Bug priority; lower numbers are more urgent. d93f0b priority issues.labels.priorityPrefix item create; migrate backlog ordering priority change
p1 Bug priority; lower numbers are more urgent. d93f0b priority issues.labels.priorityPrefix item create; migrate backlog ordering priority change
p2 Bug priority; lower numbers are more urgent. d93f0b priority issues.labels.priorityPrefix item create; migrate backlog ordering priority change
p3 Bug priority; lower numbers are more urgent. d93f0b priority issues.labels.priorityPrefix item create; migrate backlog ordering priority change
size:Major Feature implementation size. 0052cc size issues.labels.sizePrefix item create; migrate backlog; round tier; review depth size change
size:Minor Feature implementation size. 0052cc size issues.labels.sizePrefix item create; migrate backlog; round tier; review depth size change
size:Cosmetic Feature implementation size. 0052cc size issues.labels.sizePrefix item create; migrate backlog; round tier; review depth size change
on-milestone/* Work merged into a milestone branch and awaiting release. 0052cc milestone   merge gate cross-milestone dependency checks; release milestone release cleanup
claimed:* Worker and machine holding an open issue. 1d76db claim   item claim round claim arbitration; doctor release, return or completed merge
harness:claude Harness selected for this issue. 5319e7 routing   maintainer; round assign round worker selection explicit routing change
harness:codex Harness selected for this issue. 5319e7 routing   maintainer; round assign round worker selection explicit routing change
harness:opencode Harness selected for this issue. 5319e7 routing   maintainer; round assign round worker selection explicit routing change
model:* Model selected for this issue. 5319e7 routing   maintainer round worker selection explicit routing change
machine:* Machine assigned to this issue. 5319e7 routing   round support; maintainer round candidates; dispatch return or assignment change
decision:research Decision workflow requested for this issue. fbca04 round   maintainer round worker selection decision resolved
decision:grilling Decision workflow requested for this issue. fbca04 round   maintainer round worker selection decision resolved
status:planned Milestone lifecycle status. 0052cc milestone   milestone status milestone read next milestone status
status:active Milestone lifecycle status. 0052cc milestone   milestone status milestone read next milestone status
status:shipped Milestone lifecycle status. 0052cc milestone   milestone status milestone read next milestone status
status:archived Milestone lifecycle status. 0052cc milestone   milestone status milestone read next milestone status
review:claude Cross-harness review routing or explicit opt-out. 5319e7 review   maintainer review depth; merge gate explicit routing change
review:codex Cross-harness review routing or explicit opt-out. 5319e7 review   maintainer review depth; merge gate explicit routing change
review:opencode Cross-harness review routing or explicit opt-out. 5319e7 review   maintainer review depth; merge gate explicit routing change
review:none Cross-harness review routing or explicit opt-out. 5319e7 review   maintainer review depth; merge gate explicit routing change
partial-slice A PR may land one slice without closing this issue. fbca04 round   maintainer merge gate closing check final slice or explicit removal
refactor Architecture review or refactoring work. c5def5 round   round architecture; maintainer round architecture candidates retained
needs-info More information is needed before dispatch. fbca04 round   maintainer round candidates information supplied
best-of:2 Two independent attempts compete for one issue. fbca04 round   maintainer round assign; best-of merge gate explicit removal
risk:high Require a cross-harness review for high-risk work. b60205 review   maintainer review.crossLabels explicit removal

Edit this page on GitHub