Harness Board

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

1. Call list_tasks to find the active project and epic
2. Call create_task with the current project + epic
3. 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:

1. move_task → "in-progress"
2. link_branch with the worktree branch
3. Add progress comments via add_comment (author: "claude")
4. request_review when ready
5. move_task → "done" after merge

Status Values

• backlog — not started
• in-progress — being worked on
• review — ready for human review
• done — complete