kanban is archived (not installed by init): copy it from examples/init-pack/ with its dependency closure, or ask create-workflow to build an equivalent. It reads Markdown tickets from .smithers/tickets/, runs each ticket in its own worktree branch, then asks an agent to merge successful branches back into the main workspace.
The kanban UI shows each ticket implemented on its own worktree branch, merging only the ones that pass.
Inputs
Ticket Layout
How It Runs
- Discovers
.mdticket files, skipping dot-prefixed files (e.g..gitkeep) andreadme.md(case-insensitive). - Creates a worktree branch for each ticket.
- Runs the shared
ValidationLoopper ticket. - Records a ticket result in the run log.
- Merges branches where validation passed and at least one reviewer approved.
Output Shape
Successful ticket branches merge into the main workspace; the run log records per-ticket validation results and reviewer feedback, and failing tickets stay in their worktree branches for inspection.Use it when
- You have multiple independent tickets in
.smithers/tickets/. - You want each ticket built in its own worktree branch and merged on success.
Use something else when
- Work not yet split: run
tickets-createfirst. - The work is a single change: use
implement.
Resume & retry
Runs are durable and resume withup --resume, and each ticket runs the validation loop independently (see Output Shape above for merge and failure handling).