Kanban 튜토리얼 — 다중 에이전트 협업
Kanban 튜토리얼 — 다중 에이전트 협업 — 공식 문서 기반의 이해하기 쉬운 가이드
바쁜 주방에서 셰프마다 각자 다른 전문 분야를 가진 상황을 상상해 보세요. 한 번에 한 명씩 지시를 외치고, 다음 요리를 시작하기 전에 각 접시가 완성될 때까지 기다려야 한다면 서비스는 마비될 겁니다. Hermes Kanban은 그 주방 벽에 걸린 화이트보드입니다 — 모든 작업, 그 상태, 누가 무엇에 막혀 있는지가 한눈에 보이도록 적혀 있습니다.
칸반이란 무엇인가?
칸반은 모든 Hermes 에이전트가 읽고 쓸 수 있는 공유 작업 보드입니다. 각 작업은 단일 파일(~/.hermes/kanban.db)에 저장된 간단한 레코드입니다. 모든 에이전트는 고유한 정체성과 메모리를 가진 독립적인 작업자입니다 — 이름 없는 임시 직원이 아니라, 사내 규칙을 잘 아는 정규 직원과 같습니다.
두 개의 문, 하나의 방
보드에는 두 가지 인터페이스가 있지만, 둘 다 동일한 데이터베이스를 가리키므로 동기화가 어긋날 일이 없습니다:
- 에이전트는 도구를 사용합니다 — 모델은
kanban_show(작업 보기),kanban_complete(작업 완료),kanban_block(차단 표시) 같은kanban_*도구를 통해 작업을 읽고 업데이트합니다. - 사용자는 터미널을 사용합니다 —
hermes kanban ...명령어를 입력하거나/kanban ...슬래시 명령어를 사용하거나 웹 대시보드를 엽니다.
# 작업 생성
hermes kanban create "Research competitor pricing" --assign researcher-1
# 모든 작업 목록 보기
hermes kanban list
# 작업 완료 처리
hermes kanban complete 42
delegate_task와는 어떻게 다른가?
delegate_task는 전화 통화와 같습니다. 한 사람에게 전화를 걸어 답변을 기다렸다가 끊는 방식입니다. 칸반은 단체 채팅과 같습니다. 메시지를 올리면 모두가 보고, 시간이 되는 사람이 집어서 처리하고, 완료되면 보고합니다.
| 측면 | delegate_task |
Kanban |
|---|---|---|
| 작업 방식 | 동기식 — 결과 대기 | 발화 후 망각 (Fire-and-forget) |
| 에이전트 정체성 | 익명의 임시 직원 | 이름과 메모리를 가진 정규 직원 |
| 실패 처리 | 실패 시 소실 | 차단 표시 후 나중에 재시도 |
| 다중 에이전트 | 한 번에 하나씩 | 여러 에이전트가 릴레이 방식으로 |
칸반은 무엇에 유용한가?
공식 문서에서는 몇 가지 패턴을 강조합니다:
- 리서치 파이프라인: 여러 리서처가 병렬로 검색 → 애널리스트가 요약 → 라이터가 초안 작성
- 예약 작업: 아침 브리핑을 자동 생성하여 장기 로그로 축적
- 디지털 트윈: 시간이 지나면서 사용자 선호도를 학습하는
inbox-triage같은 지속적 어시스턴트 - 엔지니어링: 작업 분해 → 병렬 개발 → 코드 리뷰 → 병합
주요 명령어 치트 시트
# 댓글 추가 (사람이 개입할 수 있음)
hermes kanban comment 42 "Price data needs updating to latest version"
# 차단 표시 (외부 입력 대기 중)
hermes kanban block 42 "Waiting for client to confirm requirements"
# 차단 해제
hermes kanban unblock 42
# 작업 세부 정보 보기
hermes kanban show 42
프로 팁: 사람이 개입하세요
칸반의 가장 큰 장점은 언제든지 사람이 개입할 수 있다는 점입니다. 에이전트가 막히면 작업을 block 상태로 표시합니다. 그러면 사용자가 이를 보고 댓글을 남기거나 직접 차단을 해제할 수 있습니다. 마치 셰프에게 “냉장고에 생선 더 있어요”라고 알려주는 것과 같습니다. 셰프는 그 말을 듣고 다시 요리를 계속합니다.
Official Screenshots








요약
칸반은 다중 에이전트 협업을 “전화 통화”에서 “화이트보드 보기”로 바꿔줍니다 — 더 유연하고, 더 안정적이며, 더 투명합니다. 모든 작업이 기록되고, 모든 실패는 재시도할 수 있으며, 누구든지(사람이든 에이전트든) 다른 사람이 멈춘 지점에서 이어서 작업할 수 있습니다.
한번 시도해 보세요: 작게 시작하세요 — 두 개의 에이전트(예: researcher와 writer)를 만드세요. 리서처가 주제를 조사하고 결과를 보드에 올리게 하세요. 라이터가 새 작업을 보고 집어서 글을 작성합니다. 몇 분 안에 화이트보드 협업의 마법을 느낄 수 있을 겁니다.

📖 공식 문서
この記事は Hermes Agent の공식 문서に基づいています:공식 문서 › user-guide/features/kanban