Skip to content

Board Columns

Columns are derived, not configured: the union of every enabled workflow's stage columns in stage order (from, during, to per stage, deduplicated), plus Done. Change your workflows and re-run trkr init to migrate — missing columns are appended, existing ones never removed.

Blocked is not a column — it's the trkr:blocked label, so a blocked ticket keeps its position in the pipeline.

The preset columns

Every preset workflow runs over the same five columns:

ColumnColorRole
BacklogGRAYInert. Not started — drag a ticket forward to begin
SpecYELLOWSpec or diagnosis session running
ImplementPURPLEImplementation session running or queued
ReviewORANGEAgent review pass running
DoneGREENReviewed and handed off — your review & merge

With validate configured, a sixth column appears between Review and Done:

ColumnColorRole
ValidatePINKBlack-box validation against the contract

Backlog is inert. Every preset workflow's first stage is manual: the daemon never picks a ticket up from Backlog. You start work by dragging the ticket into the first stage's working column (Spec for feature/bugfix, Implement for the rest); from there every transition is automatic until Done.

Done means handed off, not merged. When the review stage passes, trkr requests your review on the open PR (or @mentions you) and moves the ticket to Done. You merge; trkr never does. If every linked PR is closed without merging, the ticket gets the trkr:blocked label.

Columns referenced by a custom workflow but not in this table get GRAY and an empty description.