Headmaster Docs/Features/Kanban

Kanban

Visual task board — cards, columns, agent progress

Kanban — task board

The Kanban board is Headmaster's visual task management surface. It shows work items as cards organized in columns, letting you and the agent track progress on multi-step tasks.


What it is

The Kanban board is a shared task board between you and the agent. The agent creates cards as it breaks down a task, moves them across columns as it works, and marks them done when complete. You can also create cards manually and the agent will pick them up.


Kanban board with cards

Screenshot placeholder: The Kanban board showing cards across columns.

Columns

| Column | Meaning | |---|---| | Backlog | Tasks identified but not started. The agent hasn't picked them up yet. | | In Progress | Tasks the agent is actively working on right now. | | Review | Tasks that are done but need your review or approval. | | Done | Completed tasks. |

You can customize the columns — add, rename, reorder, or remove them to match your workflow.


Creating a card

Two approaches:

  1. Manually: Click Add card in any column. Type a title and description. The agent sees it and can pick it up.
  2. From chat: When you give the agent a complex task, it breaks it into subtasks and creates cards automatically. Each card shows in the board with a link back to the conversation.

Card details

Each card shows:

  • Title — short description of the task.
  • Status — which column it's in.
  • Assignee — which specialist is working on it (or "unassigned").
  • Labels — color-coded tags for categorization.
  • Due date — optional deadline.
  • Links — links to the conversation and any files the agent created.

Click a card to open its detail view — full description, comments, activity log, and file links.


Drag and drop

Drag cards between columns to change their status. The agent respects the board state — if you move a card back to Backlog, the agent stops working on it. If you move a card to Review, the agent knows it's waiting for your sign-off.


Agent interaction

The agent reads the board to decide what to work on next:

  • In Run It Yourself mode, the agent pulls the next card from Backlog, moves it to In Progress, works on it, and moves it to Review or Done.
  • In Work Along mode, the agent proposes pulling a card and asks for your approval before starting.
  • In Autopilot, the agent works through cards in Backlog order without asking.

The Council Chamber and Kanban

When the Council is active, the Kanban board becomes the Council Chamber — the shared task board where specialists claim cards, work in parallel, and report back. Each specialist's card shows their avatar and live status.

See The Council for details.