docs(kanban): add step-by-step tutorial with 10 dashboard screenshots
New website/docs/user-guide/features/kanban-tutorial.md walks four
user stories end-to-end, each backed by a real screenshot of the
dashboard running against seeded data.
Stories
1. Solo dev shipping a feature (parent->child dependencies,
structured handoff, run history rendering).
2. Fleet farming (parallel independent tasks across 3 assignees,
lanes-by-profile grouping, dispatcher daemon).
3. Role pipeline with retry (PM spec -> eng implements -> review
blocks -> eng retries -> review approves; two-run history
visible in the drawer; downstream workers pull parent
summary+metadata).
4. Circuit breaker + crash recovery (2 spawn_failed + 1 gave_up
for a deploy with missing creds; 1 crashed + 1 completed for
an OOM-killed migration that recovered on retry).
Each story shows both CLI commands and the dashboard drawer
equivalent. Screenshots captured via playwright + chromium at 2x
device scale, then repalettized with PIL (22MB -> 6.1MB for the
10-image set, no visible quality loss verified against vision).
Side updates
- website/sidebars.ts: added kanban-tutorial under features.
- website/docs/user-guide/features/kanban.md: prefix banner
linking new readers to the tutorial before the reference.
All image references validate: `/img/kanban-tutorial/*` maps to
website/static/img/kanban-tutorial/ (10 files). Docusaurus build
not run locally (no node_modules in worktree); CI build on merge
will confirm.
BIN
website/static/img/kanban-tutorial/01-board-overview.png
Normal file
|
After Width: | Height: | Size: 748 KiB |
BIN
website/static/img/kanban-tutorial/02-board-flat.png
Normal file
|
After Width: | Height: | Size: 764 KiB |
BIN
website/static/img/kanban-tutorial/03-drawer-schema-task.png
Normal file
|
After Width: | Height: | Size: 476 KiB |
|
After Width: | Height: | Size: 500 KiB |
BIN
website/static/img/kanban-tutorial/06-drawer-crash-recovery.png
Normal file
|
After Width: | Height: | Size: 496 KiB |
BIN
website/static/img/kanban-tutorial/07-fleet-transcribes.png
Normal file
|
After Width: | Height: | Size: 811 KiB |
BIN
website/static/img/kanban-tutorial/08-pipeline-auth.png
Normal file
|
After Width: | Height: | Size: 804 KiB |
BIN
website/static/img/kanban-tutorial/09-drawer-pipeline-review.png
Normal file
|
After Width: | Height: | Size: 463 KiB |
BIN
website/static/img/kanban-tutorial/10-drawer-in-flight.png
Normal file
|
After Width: | Height: | Size: 472 KiB |
BIN
website/static/img/kanban-tutorial/11-drawer-gave-up.png
Normal file
|
After Width: | Height: | Size: 471 KiB |