Kanban

Hermes Kanban 사용해보기

Kanban은 여러 Hermes 프로필이 함께 보는 작업 보드입니다. 작업을 카드로 만들고, 담당 프로필을 정하면 dispatcher가 해당 프로필을 worker로 실행해 작업을 진행합니다.

초보자라면 먼저 대시보드에서 Kanban 탭을 열어 “카드가 어느 칸에 있는지” 보는 것부터 시작하세요. 터미널 명령어는 보드를 준비하거나 문제가 생겼을 때 확인하는 보조 수단으로 생각하면 됩니다.

Kanban은 “공유 작업판”입니다

공식 문서에 따르면 Kanban 작업은 `~/.hermes/kanban.db`에 저장됩니다. 그래서 대화가 바뀌거나 화면을 닫아도 작업 기록이 남고, 다른 프로필도 같은 보드를 읽을 수 있습니다.

Triage아이디어

Todo대기

Ready담당자 준비

Running작업 중

Blocked사람 확인 필요

Done완료

Task: 보드 위의 작업 카드입니다. Assignee: 작업을 맡을 프로필 이름입니다. Dispatcher: 준비된 작업을 담당 프로필에게 실행시키는 흐름입니다.

공식 문서 기준으로 Kanban은 대시보드, CLI, worker 도구가 같은 보드 데이터를 봅니다. 그래서 처음에는 터미널에서 목록을 읽으려고 하기보다, 브라우저 대시보드에서 Kanban 탭을 여는 편이 가장 쉽습니다.

Kanban dashboard

hermes kanban init
hermes dashboard

1브라우저가 열리면 주소가 http://127.0.0.1:9119인지 확인합니다.

2왼쪽 메뉴에서 Kanban을 클릭합니다.

3보드 위에 Triage, Todo, Ready, In progress, Blocked, Done 칸이 보이면 성공입니다.

공식 Kanban tutorial도 대시보드를 “시스템을 보기 가장 편한 곳”으로 설명합니다. worker가 내부에서 쓰는 도구나 CLI 명령어를 처음부터 외울 필요는 없습니다.

hermes dashboard만 실행해서 열린 화면에서 Kanban을 찾으세요. 보드가 비어 있어도 정상입니다. 아직 카드를 만들지 않았다는 뜻입니다.

아래 명령어를 터미널에 입력하세요. 예시는 `researcher` 프로필에게 “Hermes 공식문서에서 Kanban 핵심만 조사하기”를 맡기는 카드입니다.

Create task

hermes kanban create "Hermes Kanban 공식문서 핵심 5줄 요약" --assignee researcher

`researcher` 프로필이 없다면 이 작업은 바로 실행되지 않을 수 있습니다. 먼저 `profiles.html`에서 역할별 프로필을 만든 뒤 시도하세요.

카드를 만든 뒤에는 대시보드의 Kanban 탭으로 돌아가세요. 새 카드가 Todo나 Ready 칸에 보이면 정상입니다. 카드를 클릭하면 오른쪽 drawer에서 담당자, 상태, 댓글, 실행 기록을 볼 수 있습니다.

터미널로 확인하고 싶을 때만 아래 명령어를 입력하세요.

List tasks

hermes kanban list
hermes kanban stats

Gateway가 켜져 있으면 Kanban dispatcher가 준비된 작업을 주기적으로 확인하고 담당 프로필을 worker로 실행합니다. 아래 명령어를 터미널에 입력하세요.

Start gateway

hermes gateway start

작업 진행을 실시간으로 보려면 아래 명령어를 입력합니다.

Watch board

hermes kanban watch

공식 문서에서 Kanban은 `blocked` 상태를 지원합니다. 작업자가 사람의 입력이 필요하다고 판단하면 blocked로 멈추고, 사람이 확인한 뒤 다시 풀 수 있습니다.

Unblock example

hermes kanban unblock TASK_ID

Kanban의 assignee는 보통 프로필 이름과 연결됩니다. 예를 들어 `researcher`, `writer`, `coder`처럼 역할별 프로필을 만들어 두면 카드마다 담당자를 분리할 수 있습니다.

researcher자료 조사 카드

writer요약문 작성 카드

coder코드 수정 카드