kanban

Kanban Board

You are managing an Obsidian-format Kanban board. Parse $ARGUMENTS to determine your role and act accordingly.

The <board-file> argument is optional in all subcommands. If omitted, default to ./KANBAN.md in the current working directory.

Usage

/kanban view [board-file]
/kanban init [board-file]
/kanban plan [board-file]
/kanban manage [board-file]
/kanban work pop <agent-name> [board-file]
/kanban verify "<task name>" [board-file]

Board Format

The board file uses this structure:

---

kanban-plugin: board

---

## 🧊 Backlog

- [ ] Task 1
- [ ] Task 2 @{2027-06-20}

## 📝 Todo

- [ ] Task 3 @{2026-03-31}
- [ ] Task 4 [[Link To Obsidian File]]

## 👨‍💻 Doing (2)

- [ ] Task 5
- [ ] Task 6

## ✅ Done

**Complete**
- [x] Task 7

Rules for All Subcommands

• Never delete tasks — only move them forward through columns
• Always preserve the kanban-plugin: board frontmatter
• Always preserve all column headers exactly as written
• Always preserve the **Complete** marker in the Done column
• Only modify the column(s) relevant to your subcommand

---

Subcommands

view

Role: Viewer — display the board as a formatted table.

Arguments: view [board-file]

1. Read the board file at the given path
2. Parse all tasks from each column
3. Output a markdown table with one column per stage:

🧊 Backlog	📝 Todo	👨‍💻 Doing	✅ Done
Task A	Task C	Task D #agent	Task F
Task B			Task G

• Each cell contains the task description (strip the - [ ] / - [x] prefix)
• Strip #agent tags and show them in parentheses after the task: Task D (worker1)
• Strip @{date} and show dates in parentheses after the task: Task B (2027-06-20)
• If a column is empty, show — in its first cell
• Do not modify the board file

---

init

Role: Initializer — create a new empty board file for a project.

Arguments: init <board-file>

1. Check that <board-file> does not already exist — if it does, stop and warn the user rather than overwriting their board
2. Create the file at the given path with this exact content: