kb-board

name	kb-board
description	Show GitKB kanban board with task status columns

Display the kanban board and provide actionable context about the current workstream.

Input: $ARGUMENTS

Optional arguments: --group-by <field>, --columns <list>, --sort-by <field>, --sort-direction <asc|desc>, --all

Steps

1. Show the Board

If no arguments provided, show the default status board:

git-kb board --all

If --group-by was specified, pass it through:

git-kb board --group-by priority --all
git-kb board --group-by tags --all
git-kb board --group-by priority --columns critical,high,medium,low --all
git-kb board --group-by status --sort-by priority --sort-direction asc --all

Available flags:

• --group-by <field> — Group by any frontmatter property instead of status (e.g. priority, tags, assignee, component, or custom fields)
• --columns <list> — Explicit column order (comma-separated, requires --group-by). Unlisted values appear as extra columns at the end.
• --sort-by <field> — Sort items within columns by a frontmatter property (requires --group-by)
• --sort-direction <asc|desc> — Sort direction (default: asc, requires --group-by)
• --json — Machine-readable JSON output
• --all — Show all items and document types (don't truncate)

Notes:

• Array properties (like tags) place documents in multiple columns
• Documents without the grouped field appear in an (unset) column
• Status and priority columns use enum ordering; other fields sort alphabetically

2. Analyze Blocked Tasks

If any tasks are in the BLOCKED column (or have blockedBy relationships):

• Use kb_show to load each blocked task
• Identify what's blocking them
• Summarize: "X is blocked by Y because Z"

3. Suggest Next Task

Look at ACTIVE and DRAFT tasks. Suggest what to work on next based on:

• Priority: high > medium > low
• Dependencies: unblocked tasks first
• Momentum: tasks related to recently completed work

4. Flag Staleness

If any task has been ACTIVE with no progress log entries in the last 7 days, flag it:

• "task-slug has been active since [date] with no progress updates in 7+ days — is it still being worked on?"

5. Present Summary

Show the board output, then add:

• Count of tasks by status (or by the grouped field)
• Any blocked items with reasons
• Suggested next task with rationale