Harness Board
Use this skill when the user invokes /board or asks to manage tasks, create epics, move tasks, or check project status on the Harness Board.
What is Harness Board?
A lightweight Kanban board with real-time two-way sync between Claude and a web UI. Tasks live in ~/.harness/board/projects/<slug>.yaml. Claude interacts via MCP tools; humans interact via browser.
MCP Tools Available
| Tool | Purpose |
|---|---|
create_project |
Create a new project |
create_epic |
Create an epic under a project |
create_task |
Create a task under an epic |
update_task |
Edit title, description, flags |
move_task |
Change status column |
add_comment |
Post a comment as "claude" or "user" |
list_tasks |
Read board state (filterable) |
link_branch |
Associate branch/worktree with task |
link_commit |
Attach a commit SHA |
request_review |
Flag task ready for human review |
block_task |
Mark blocked with reason |
unblock_task |
Clear blocked status |
Usage Patterns
/board — Open the board UI
Open the board web UI (requires the board server to be running as a background service):
bash ${CLAUDE_PLUGIN_ROOT}/scripts/start-board.sh
If the server is not running, the script prints instructions to install it as a persistent launchd service with pnpm board:install.
/board create <title> — Create a task
- Call
list_tasksto find the active project and epic - Call
create_taskwith the current project + epic - Confirm task ID and status to the user
/board status — Show current board state
Call list_tasks and format a concise summary grouped by status.
/board move <task-id> <status> — Move a task
Call move_task with the appropriate project, task_id, and status.
Workflow Integration
When starting work on a task:
move_task→ "in-progress"link_branchwith the worktree branch- Add progress comments via
add_comment(author: "claude") request_reviewwhen readymove_task→ "done" after merge
Status Values
backlog— not startedin-progress— being worked onreview— ready for human reviewdone— complete