kanban

name	kanban
description	View the story board grouped by status, with optional filters

/kanban

Display all stories in stories/ grouped by status column. Read-only — use /story update to change status.

1. Load stories

Glob stories/*.md. For each file, parse the YAML front matter to extract: id, title, status, priority, components, epic, branch.

If stories/ is empty or absent, output:

No stories yet. Run /story <title> to create one.

2. Group and sort

Group stories into columns in this order:

idea  →  backlog  →  in-progress  →  review  →  done

Within each column, sort by priority ascending (1=high first), then by id ascending.

3. Render the board

IDEA             (N)
  S-NNN [P?] <title>                    <components>

BACKLOG          (N)
  S-NNN [P?] <title>                    <components>

IN-PROGRESS      (N)
  S-NNN [P?] <title>  [branch]          <components>

REVIEW           (N)
  S-NNN [P?] <title>                    <components>

DONE             (N)
  S-NNN [P?] <title>                    <components>

• [P?] is the priority: [P1], [P2], [P3]
• [branch] shows the branch: field for in-progress stories (omit for other statuses)
• Skip empty columns

---

Filters

By column: /kanban backlog — show only that status column.

By epic: /kanban epic=Auth — show only stories whose epic field matches (case-insensitive, partial match).

Story detail: /kanban S-004 — pretty-print the full content of that story file (same as /story show S-004).

---

Don't:

• Modify any story files
• Omit stories — if a file fails to parse, note the filename and skip it rather than silently dropping it