Kanban

여러 AI 에이전트가 하나의 작업 보드에서 협업하는 멀티에이전트 시스템

v2.0 · 2026년 5월 · 정리: 김몽이 + Hermes Agent

한 줄로 말하면?

Kanban은 Hermes Agent 프로필들이 하나의 공유 작업 보드(Task Board)에서 협업할 수 있게 해주는 기능입니다. 칸반 보드처럼 해야 할 일 → 진행 중 → 완료로 작업을 관리하고, 여러 프로필(연구자, 작가, 개발자 등)이 각자 맡은 일을 처리한 뒤 다음 작업자에게 자동으로 넘깁니다.

왜 필요한가요?

기존 delegate_task로도 서브에이전트를 만들어 작업을 시킬 수 있었지만, 몇 가지 한계가 있었습니다:

Kanban은 이런 상황에 딱 맞습니다:

핵심 개념 — 단 6가지만 알면 됩니다

어떻게 동작하나요?

구체적인 예시: "2024년 AI 투자 동향 보고서 작성"이라는 작업을 시킨다고 해봅시다.

1. 오케스트레이터가 큰 작업을 받아서 세부 작업으로 나눕니다:
   • 작업 A: "북미 지역 AI 투자 조사" → researcher-a에 할당
   • 작업 B: "유럽 지역 AI 투자 조사" → researcher-b에 할당
   • 작업 C: "조사 결과 종합해서 보고서 작성" → writer에 할당, A와 B가 끝나야 시작
2. 디스패처가 researcher-a와 researcher-b를 실행
3. 두 연구자가 각자 조사 완료 후 핸드오프 (요약 + 파일 목록) 남김
4. 작업 C가 자동으로 준비 상태가 되고, writer가 실행됨
5. writer가 두 연구자의 핸드오프를 읽고 최종 보고서 작성
6. 완료 알림이 텔레그램으로 도착

빠른 시작 — 딱 3단계

1단계: 칸반 초기화

hermes kanban init

~/.hermes/kanban.db 파일이 생성됩니다. 이 파일이 모든 작업을 저장하는 데이터베이스입니다.

2단계: 게이트웨이 실행

hermes gateway start

게이트웨이 안에 디스패처가 내장되어 있어서, 별도로 뭘 실행할 필요가 없습니다.

3단계: 작업 만들기

hermes kanban create "AI 투자 동향 조사" --assignee researcher

이제 60초 내에 디스패처가 researcher 프로필을 실행하고 작업을 시작합니다.

상태 확인

hermes kanban list        # 전체 작업 목록
hermes kanban show t_xxxx  # 특정 작업 상세
hermes kanban watch        # 실시간 이벤트 스트림
hermes kanban stats        # 상태별 통계

대시보드 — 눈으로 보는 칸반

CLI만으로도 충분하지만, 시각적으로 보고 싶다면 웹 대시보드를 열 수 있습니다:

hermes dashboard

대시보드에서는 다음과 같은 작업을 할 수 있습니다:

• 드래그 앤 드롭으로 작업 상태 변경 (카드를 옆 칸으로 끌어놓기)
• 카드 클릭으로 상세 정보 보기 (제목·내용 수정, 댓글, 이벤트 이력)
• 실시간 업데이트 — 다른 작업자가 상태를 바꾸면 즉시 반영
• 필터 — 담당자별, 상태별, 키워드 검색
• 인라인 생성 — 칸 헤더의 + 버튼으로 바로 작업 추가

주요 협업 패턴 — 이렇게 활용하세요

텔레그램에서 칸반 사용하기

게이트웨이(Tekegram)에서 /kanban 슬래시 명령어로 칸반을 조작할 수 있습니다. CLI에 접속하지 않아도 됩니다:

/kanban list                                    # 작업 목록
/kanban create "번역 작업" --assignee linguist  # 새 작업 생성
/kanban show t_xxxx                              # 상세 보기
/kanban comment t_xxxx "좋아 보입니다"            # 댓글 달기
/kanban unblock t_xxxx                           # 차단된 작업 재개

실전 시나리오 — 이렇게 씁니다

# 09:00 — 팀장
/kanban create "이번 주 블로그 키워드 리서치" --assignee researcher
/kanban create "경쟁사 A 신제품 분석" --assignee analyst

# 09:02 — 디스패처 감지 → AI 실행
# 09:10 — researcher 완료 (결과: 키워드 3건 추천)

# 09:11 — 기획자 A (결과 확인 후)
/kanban create "AI 트렌드 블로그 원고" --assignee writer
/kanban create "썸네일 제작: AI 트렌드" --assignee designer

# 09:25 — writer + designer 완료

# 09:26 — 운영자 C (원고 확인 후)
/kanban show t_xxxx
/kanban create "인스타 요약본 + 해시태그" --assignee writer

# 14:00 — 분석가 D
/kanban create "주간 광고 성과 리포트" --assignee analyst

# 10:00 — 리드 개발자
/kanban create "사용자 인증 API 구현" --assignee backend-eng
/kanban create "로그인 페이지 UI" --assignee frontend-eng

# AI 개발 완료 → 자동으로 PR 생성
# 완료 시 핸드오프: 변경 파일, 테스트 결과, PR 링크

# 11:00 — 리드 개발자 (AI 결과 확인 후)
/kanban create "auth 모듈 코드 리뷰" --assignee reviewer \
    --parent t_api t_ui   ← API·UI 둘 다 완료되면 시작

# 리뷰어 AI: 코드 품질·보안·테스트 커버리지 분석 → PR 코멘트 작성
# 완료 시 핸드오프: 발견된 이슈, 추천 수정사항, 승인 여부

# 08:00 — PD
/kanban create "이번 주 AI 트렌드 리서치" --assignee researcher

# researcher 완료 (관련 뉴스·논문·통계 링크 포함)

# 08:15 — PD (리서치 확인 후)
/kanban create "AI 트렌드 영상 스크립트" --assignee writer \
    --workspace dir:~/projects/yt-ai-trends/

# writer: 15분 분량 스크립트 + 섬네일 텍스트 + 설명란 문구 + 해시태그
# 완료 핸드오프: 스크립트.md, 섬네일-아이디어.txt, 설명란.txt

# 09:00 — 편집자 (스크립트 확인 후)
/kanban create "스크립트 기반 편집 지시서 작성" --assignee editor \
    --workspace dir:~/projects/yt-ai-trends/

# editor: 타임코드별 B-roll 제안, 자막 하이라이트, 인트로/아웃트로 구성
# 완료 핸드오프: 편집노트.md

# 10:00 — PD (전체 검토 후 최종 승인)
/kanban create "영상 설명란 SEO 최적화" --assignee writer

# 11:00 — 배포 담당
/kanban create "유튜브·블로그·SNS 발행 스케줄" --assignee writer

멀티 보드 — 프로젝트별로 완전히 분리하기

보드(Board)를 여러 개 만들어서 프로젝트·도메인별로 작업을 완전히 분리할 수 있습니다. 각 보드는 별도의 SQLite DB, 작업 공간, 로그 디렉토리를 가집니다.

# 현재 보드 확인
hermes kanban boards list

# 새 보드 만들기
hermes kanban boards create marketing \
    --name "마케팅팀" \
    --description "캠페인·콘텐츠 작업 관리" \
    --switch                 # 이 보드를 활성 보드로 전환

# 특정 보드에 작업 생성
hermes kanban --board marketing create "블로그 원고 작성" --assignee writer

# 보드 전환
hermes kanban boards switch marketing

# 보드 아카이브 (복구 가능)
hermes kanban boards rm marketing

# 보드 완전 삭제
hermes kanban boards rm marketing --delete

중복 방지 생성 (Idempotent Create)

자동화 스크립트나 웹훅에서 같은 작업이 중복 생성되는 것을 방지합니다. 동일한 idempotency-key로 다시 호출하면 새 작업을 만들지 않고 기존 작업 ID를 반환합니다.

# 첫 호출 — 작업 생성
hermes kanban create "매일 아침 뉴스 브리핑" \
    --assignee researcher \
    --idempotency-key "daily-brief-2026-05-08"

# 같은 키로 두 번째 호출 — 새 작업 안 만듦, 기존 ID 반환
hermes kanban create "매일 아침 뉴스 브리핑" \
    --assignee researcher \
    --idempotency-key "daily-brief-2026-05-08" \
    --json

Kanban-worker & Kanban-orchestrator 스킬

작업자를 위한 두 가지 번들 스킬이 기본 설치됩니다. 이 스킬들은 작업자가 CLI 명령어 대신 도구 호출(tool call)로 보드를 조작하는 방법을 알려줍니다.

kanban-worker — 작업자용

모든 칸반 작업자가 반드시 로드해야 하는 스킬입니다:

1. kanban_show() — 작업 시작 시 제목+본문+이전 시도+댓글 읽기
2. 작업 수행 — 지정된 워크스페이스 디렉토리에서 실제 작업 진행
3. kanban_heartbeat(note="...") — 긴 작업 중 수 분마다 생존 신호
4. kanban_complete(summary="...", metadata={...}) — 완료 시 결과 핸드오프
5. kanban_block(reason="...") — 막히면 사람에게 도움 요청

# 작업자에게 스킬이 설치되어 있는지 확인
hermes -p worker skills list | grep kanban-worker

# 누락 시 복구
hermes -p worker skills reset kanban-worker --restore

kanban-orchestrator — 조정자용

오케스트레이터는 직접 작업을 수행하지 않고, 큰 목표를 세부 작업으로 분해·배정·연결합니다:

# 오케스트레이터의 전형적인 턴
kanban_show()                          # 작업 내용 확인
kanban_create(                         # 연구 작업 A 생성
    title="북미 AI 투자 동향 조사",
    assignee="researcher-a",
    body="시드·시리즈A, AI 분야 중점")
kanban_create(                         # 연구 작업 B 생성
    title="유럽 AI 투자 동향 조사",
    assignee="researcher-b")
kanban_create(                         # 종합 작업 (A,B 완료 후 시작)
    title="조사 결과 종합 보고서",
    assignee="writer",
    parents=["t_a", "t_b"])
kanban_complete(summary="2개 연구 → 1개 종합 파이프라인 구성 완료")

작업에 특별 스킬 붙이기 (Pinning Skills)

특정 작업에만 필요한 전문 스킬을 작업별로 지정할 수 있습니다. 작업자의 프로필을 매번 수정할 필요가 없습니다.

# 번역 작업이 필요할 때
hermes kanban create "README 일본어 번역" \
    --assignee linguist \
    --skill translation

# 보안 감사 작업
hermes kanban create "인증 모듈 감사" \
    --assignee reviewer \
    --skill security-pr-audit \
    --skill github-code-review

대시보드에서도 작업 생성 시 skills 필드에 쉼표로 구분하여 입력할 수 있습니다.

일괄 명령어 (Bulk Verbs)

여러 작업을 한 번에 완료·보관·차단·해제할 수 있습니다.

hermes kanban complete t_abc t_def t_hij --result "일괄 완료"
hermes kanban archive  t_abc t_def t_hij
hermes kanban block    t_abc "검토 필요" --ids t_def t_hij
hermes kanban unblock  t_abc t_def

delegate_task와 무엇이 다른가요?

알아두면 좋은 점

• 단일 서버 전용: Kanban은 같은 서버 안에서만 동작합니다. 여러 서버에 걸친 분산 작업은 지원하지 않습니다.
• 디스패처는 게이트웨이 안에: hermes gateway start가 실행 중이어야 작업이 자동으로 처리됩니다.
• 워커 스킬 필수: 작업을 실행할 프로필에는 kanban-worker 스킬이 설치되어 있어야 합니다. (hermes skills install devops/kanban-worker)
• 오케스트레이터는 분리: 작업을 나누는 프로필과 실제 작업을 하는 프로필은 분리하는 것이 좋습니다. 오케스트레이터는 kanban-orchestrator 스킬을 사용합니다.

작업 이력 — 시도별로 기록됩니다

각 작업은 여러 번 실행될 수 있으며, 매 실행마다 별도의 행(Run)으로 기록됩니다. 재시도, 충돌, 타임아웃, 사람이 개입한 모든 이력을 추적할 수 있습니다.

# 작업 시도 이력 확인
hermes kanban runs t_abcd

#   #  OUTCOME       PROFILE           ELAPSED  STARTED
#   1  blocked       worker               12s  2026-04-27 14:02
#        → BLOCKED: rate-limit 키 결정 필요
#   2  completed     worker                8m  2026-04-27 15:18
#        → token bucket 구현 완료, user_id 기준 IP fallback

작업 완료 시 남기는 핸드오프는 다음 작업자에게 전달됩니다:

kanban_complete(
    summary="token bucket 구현 완료, 모든 테스트 통과",
    metadata={
        "changed_files": ["limiter.py", "tests/test_limiter.py"],
        "verification": ["pytest tests/ -q"],
        "residual_risk": ["초당 1000건 이상 부하 테스트 미수행"]
    }
)

게이트웨이 알림 — 텔레그램으로 결과 받기

/kanban create …로 작업을 생성하면, 완료·차단·실패 시 자동으로 메시지가 도착합니다.

you> /kanban create "오늘 팟캐스트 대본" --assignee transcriber

bot> Created t_9fc1a3  (ready, assignee=transcriber)
     (알림 구독 완료 — 완료 또는 차단 시 알려드립니다)

… 약 8분 후 …

bot> ✓ t_9fc1a3 완료 (transcriber)
     42분 분량 transcribed, podcast/2026-05-08.md 저장됨

수동으로 알림을 구독/해제할 수도 있습니다:

hermes kanban notify-subscribe t_abcd \
    --platform telegram --chat-id 12345678
hermes kanban notify-list
hermes kanban notify-unsubscribe t_abcd \
    --platform telegram --chat-id 12345678

멀티테넌트 — 하나의 보드로 여러 고객사 관리

하나의 전문가 함대(fleet)로 여러 비즈니스를 동시에 운영할 수 있습니다. 테넌트별로 데이터·워크스페이스·메모리를 분리합니다.

hermes kanban create "월간 리포트" \
    --assignee researcher \
    --tenant business-a \
    --workspace dir:~/tenants/business-a/data/

hermes kanban create "주간 성과 분석" \
    --assignee analyst \
    --tenant business-b

대시보드에서도 테넌트 필터를 선택하여 특정 고객사의 작업만 볼 수 있습니다.

주요 CLI 명령어 모음

더 자세한 내용은 Hermes Agent 공식 문서를 참고하세요.

이벤트 레퍼런스 — 무슨 일이 언제 일어났는지

모든 상태 변화는 task_events 테이블에 기록됩니다. 이벤트는 크게 세 가지로 나뉩니다:

# 특정 작업의 이벤트만 실시간 추적
hermes kanban tail t_abcd

# 보드 전체 이벤트 실시간 모니터링
hermes kanban watch

# 완료·실패 이벤트만 필터링
hermes kanban watch --kinds completed,gave_up,timed_out