hwanyong/skill-kanban

English | 한국어
uhd-kanban is a Claude Code plugin that keeps a per-project Kanban board as plain Markdown files in kanban/. The main Claude Code session splits a request into cards, starts one background session (claude --bg) per card, and reviews each result. A side pane in Claude Code shows the cards of each milestone by column and whether each card session is running.
Nothing is installed besides the plugin: no Docker, no server, no database, no npm packages. The board is Markdown and JSON files in a fixed format that uk check verifies, and the commands use only Node.js built-in modules.
A sample board with fictional cards. The pane was captured from a Claude Code session with test board output, so no card sessions ran. The capture copy was changed to reread the board every 0.3 seconds. Playback is 2x speed, and the session state animation keeps running at the same speed during the 1.2 seconds left for reading each step. The line under the pane names the step and is not part of the pane. The pane shows milestone titles, counts and session states; work card titles are not displayed. GIF version of the same scene: board-monitor-hero.en.gif.
> [!NOTE]
> Command output, card session prompts and pane labels are available in English and Korean (see Language). The skill documents (SKILL.md) are written in Korean and include English trigger phrases.
## Contents
Why uhd-kanban
What is in the plugin
Quick start
Language
How the board is stored
Delegating work to card sessions
Commands
Board monitor pane
Requirements
Usage notes
FAQ
Credits
License
## Why uhd-kanban
| Feature | What it does |
| Plain files | One card is one .md file. The column is the directory name and the order is the number prefix of the file name, so ls, git diff and any editor show the board. No Docker, no server, no database, no account, no npm packages: the commands import only Node.js built-in modules (node:fs, node:child_process and others). |
| Delegation | The main session does not write code. Each card runs in its own claude --bg session that receives only the card body as its prompt, so the main session's context does not fill with implementation details. |
| Edit guard | A hook asks the user before the main session edits a project file with Edit, Write or NotebookEdit. The question appears in every permission mode, including bypassPermissions. |
| Dependencies and a parallel limit | depends_on keeps a card from starting before the cards it waits for are finished. run.max_parallel (default 3) caps the number of card sessions that run at once. |
| Recovery | uk recover resumes card sessions that stopped or were respawned by the daemon, and records the new session id on the card. |
| Board monitor | A pane draws one row per milestone with one cell per member card, animates the in-progress cells by session state, and plays a rearrangement when cards are created, deleted or moved. Rows collapse by click or keyboard. Below the legend it charts cards finished and created per day, activity comments per hour and the last activity of each in-progress card, and each milestone shows an estimated number of days. It rereads the board every 60 seconds by default. |