튜토리얼 23: 칸반 — 멀티 에이전트 보드
튜토리얼 23: 칸반 — 멀티 에이전트 보드 — 공식 문서 기반의 쉬운 이해 가이드
이 글은 Hermes Agent 공식 튜토리얼 시리즈의 일부입니다. 전체 튜토리얼 보기
공용 사무실에 있는 화이트보드를 상상해 보세요. 여러 동료가 포스트잇을 붙이고, 옮기고, 댓글을 달 수 있는 그런 화이트보드요. 다만 그 동료들이 AI 에이전트이고, 화이트보드는 절대 지워지지 않는다고 생각해 보세요. 그게 바로 Hermes 칸반입니다. 여러 이름 있는 에이전트가 취약한 인수인계나 작업 손실 없이 협업할 수 있는 영구적인 작업 보드입니다.
1단계: 핵심 개념 이해하기
칸반은 공유 데이터베이스입니다 (~/.hermes/kanban.db 파일 하나). 모든 Hermes 프로필이 읽고 쓸 수 있죠. 각 작업은 하나의 행(row)이고, 각 인수인계도 하나의 행입니다. 각 작업자는 고유한 정체성과 메모리를 가진 완전한 OS 프로세스입니다.
delegate_task와의 핵심 차이점:
delegate_task는 전화 통화와 같습니다. 전화 걸고, 기다리고, 끊는 거죠. 실패하면 그대로 사라집니다.- 칸반은 게시판과 같습니다. 작업을 올려두고 떠나면, 나중에 누구든 가져갈 수 있습니다. 작업자가 죽어도 작업은 남아 있고, 다른 에이전트가 다시 가져갈 수 있습니다.
2단계: 두 가지 진입점 알아보기
두 인터페이스 모두 같은 데이터베이스를 사용하므로 서로 어긋날 일이 없습니다.
문 1 — 에이전트는 도구(tool)를 사용합니다.
AI 모델은 전용 도구 세트를 통해 보드와 소통합니다: kanban_show, kanban_list, kanban_create, kanban_complete, kanban_block, kanban_comment 등이 있죠. 디스패처가 이 도구들을 모든 작업자에게 자동으로 제공합니다.
문 2 — 당신은 CLI를 사용합니다.
당신(또는 스크립트, 크론 작업)은 터미널에서 hermes kanban …을 쓰거나, 슬래시 명령어 /kanban …을 쓰거나, 대시보드를 사용할 수 있습니다.
경험칙: 뒤에 모델이 있다면 도구를 쓰세요. 사람이나 자동화라면 CLI를 쓰세요.
3단계: 기본 명령어 사용해 보기
터미널에서 작업을 만들고 관리하는 방법은 다음과 같습니다:
# 새 작업 만들기
hermes kanban create "블로그 포스트 작성" --assign researcher-1
# 모든 작업 목록 보기
hermes kanban list
# 작업 상세 보기
hermes kanban show 42
# 작업 완료 처리
hermes kanban complete 42
# 작업 차단 (무언가 기다려야 할 때)
hermes kanban block 42 "추가 데이터 필요"
# 나중에 차단 해제
hermes kanban unblock 42
# 댓글 달기
hermes kanban comment 42 "초안 검토 준비 완료"
모든 CLI 동사에는 모델이 내부적으로 사용하는 동일한 도구 호출이 있습니다. 같은 데이터베이스, 같은 결과입니다.
4단계: delegate_task로는 안 되는 걸 칸반이 해내는 모습 보기
이 보드가 만들어진 작업 유형들은 다음과 같습니다:
- 리서치 트리아지 — 여러 연구자가 병렬로 작업하고, 분석가가 검토하고, 작가가 초안을 씁니다. 인간은 언제든 댓글을 달고 차단을 해제할 수 있습니다.
- 예약 운영 — 몇 주에 걸쳐 저널을 만드는 일일 브리핑 에이전트.
- 디지털 트윈 — 시간이 지나면서 메모리를 축적하는
inbox-triage같은 지속형 어시스턴트. - 엔지니어링 파이프라인 — 큰 기능을 분해하고, 병렬 워크트리에서 구현하고, 검토하고, 반복한 다음 PR을 만듭니다.
- 대규모 작업 — 한 명의 전문가가 50개 소셜 계정 또는 12개 모니터링 서비스를 관리하는 경우.
5단계: 한 문장으로 구분하기
delegate_task는 fork-join RPC 호출이고, 칸반은 상태 머신을 가진 영구 메시지 큐입니다.
쉽게 말하면: delegate_task는 “물어보고 기다리기”이고, 칸반은 “올려두고 팀이 일하게 하기”입니다.
Official Screenshots

요약
칸반은 Hermes를 단일 에이전트 어시스턴트에서 공유되고 영구적인 메모리를 가진 멀티 에이전트 워크포스로 바꿔줍니다. 작업은 크래시에도 살아남고, 인간은 언제든 개입할 수 있으며, 여러 에이전트가 작업 수명 동안 같은 작업을 건드릴 수 있습니다. 임시 직원을 고용하는 것과 팀을 만드는 것의 차이입니다.
다음 편: 튜토리얼 24 — 지속 목표(Persistent Goals): 작업이 진짜로 끝날 때까지 에이전트를 계속 움직이게 하기.
📖 공식 문서
この記事は Hermes Agent の공식 문서に基づいています:공식 문서 › user-guide/features/kanban