Skip to content

Pipeline phases

Every task carries its pipeline phase as a Backlog label — exactly one of phase/spec, phase/plan, phase/impl, phase/verify per task. The label records where a task stands between review gate and archive.

Why this matters to you

Before phases, the pipeline lived only in agent instructions. Every new session started with reconstructing where work stood, gate approvals left no durable trace, and the dashboard could show task status but not pipeline position.

With phases you get:

  • Faster session starts — the agent reads the task and its phase and resumes exactly where work stopped. No re-explaining, no guessing.
  • One-command answerssbl phase TASK-1 tells you where any task stands.
  • Visible progress — the dashboard stepper, task table, and task modal show the live phase; the task modal offers a copyable advance command.
  • Guarded transitionssbl phase validates every change (no typos, no impossible jumps, no duplicate labels), and sbl doctor reports missing or unknown phase labels with fix hints.
  • Zero bookkeeping — tasks created through the spec-to-backlog flow start at phase/spec automatically. You never maintain labels by hand.

Lifecycle

LabelMeaningAdvance when
phase/specCreated from an approved design; review gate openHuman approved specs + acceptance criteria
phase/planPlan being written or awaiting approvalHuman approved the written plan
phase/implTDD implementation runningImplementation complete
phase/verifyVerification & final summaryTests/lint green, summary recorded
(removed)Done / archivedMerge + archive complete

Commands

  • sbl phase TASK-1 — show the current phase
  • sbl phase TASK-1 plan — advance (or done to remove the label)
  • sbl doctor — reports missing, duplicate, or unknown phase labels

Phase transitions happen at gate passages, driven by the agent or copied from the dashboard's task-modal chip. Never edit phase labels by hand.

Dashboard

The Feature Cycle stepper shows live task counts on phases 5–8; the tasks table and detail modal show a phase chip per task. The detail modal also offers a copyable sbl phase advance command, and live-reload reflects every transition immediately.