칸반 모드
정보칸반 모드의 전체 개요와 Origin-Trail Chain 설계 방향은 칸반 모드를 보세요. 이 페이지는 다중 세션(리드 + 컴패니언) 운용 절차를 다룹니다.
칸반 모드는 하나의 리드 세션이 plan -> run -> sync 체인을
주도하고, 세 개의 컴패니언 세션이 같은 런에 합류해 작업을 병렬로
분산합니다. 검토 판정은 별도 단계가 아니라 sync 게이트가 흡수합니다.
런의 모든 세션(리드와 컴패니언 모두)은 상향된 Stop-hook
블록 캡을 받아 세션 중반에 설정한 골이 기본 연속 블록 한계를 넘어
계속 실행됩니다.
리드가 체인을 시드하고, 컴파니언은 그렇지 않습니다. 각 컴파니언은
칸반 멤버십 플래그(-k)와 역할 라벨(--name <role>)을
함께 전달하므로 디스패처가 올바르게 분류하고 SessionStart 훅이
멤버십을 안내합니다.
moai cc -k # Claude 백엔드 리드
moai cc -k SPEC-AUTH-001 # SPEC에 묶인 리드
moai glm -k # GLM 백엔드 리드리드 세션은:
MOAI_KANBAN + MOAI_KANBAN_ID 설정 (체인 시드).
SessionStart에서 런 id와 세 개의 컴패니언 실행 명령을 출력.
MOAI_KANBAN_LABEL은 설정하지 않음 (컴파니언 신호).
moai cc -k --name plan # plan 컴파니언
moai cc -k --name run # run 컴파니언
moai cc -k --name sync # sync 컴파니언
moai glm -k --name run # GLM 백엔드에서 동일컴파니언 이름은 역할만으로 붙으며 세 가지 역할은 plan, run,
sync 입니다. <run-id>는 리드 세션의 식별자로 컴파니언 이름에는
들어가지 않습니다 — 같은 역할 이름이 이미 살아 있으면 다음 번호가
붙습니다.
컴파니언 세션은:
MOAI_KANBAN_LABEL 설정 (멤버십 + 역할 라벨).
리드와 동일한 상향된 Stop-hook 블록 캡.
MOAI_KANBAN은 설정하지 않음 — 체인을 시드하지 않습니다.
moai cc --name mysession # -k 없음, 칸반 멤버십 없음
moai cc --name run # 컴파니언 역할 이름이나 -k 없음 → 무처리-k가 없으면 --name 형태와 무관하게 디스패처는 아무 작업도 하지
않습니다. --name 플래그는 그대로 Claude에 전달됩니다.
터미널 1 (리드) 터미널 2-4 (컴파니언)
───────────────── ────────────────────────
moai cc -k moai cc -k --name plan
moai cc -k --name run
moai cc -k --name sync부트스트랩은 수동입니다: 세션은 다른 세션을 실행할 수 없습니다. 리드
SessionStart 알림이 복사할 세 개의 명령을 정확히 출력합니다. 각
컴파니언을 GLM 백엔드로 실행하려면 moai cc를 moai glm으로 바꾸면
됩니다.
세션 간 통신은 Claude Code의 교차 세션 메시징(ListAgents /
SendMessage)을 사용합니다. crossSessionInbound 설정 필드가 인바운드
메시지를 수락할지, 보류할지, 거부할지를 제어합니다.
교차 세션 메시징은 모든 환경에서 쓸 수 있는 기능이 아닙니다. 칸반 모드는 리드와 컴파니언이 오직 이 채널로 이어지므로, 채널이 없으면 모드 자체가 성립하지 않습니다. 시작하기 전에 아래 제약을 확인하세요.
운영체제: macOS, Linux(WSL 2 안의 Linux 포함), Windows에서 사용할
수 있습니다. Windows 지원은 Claude Code v2.1.239부터 추가됐으므로
Windows에서는 v2.1.239 이상이 필요합니다.
제공업체: Amazon Bedrock, Claude Platform on AWS, Agent Platform
on Google Cloud, Microsoft Foundry에서는 사용할 수 없습니다.
버전: Claude Code v2.1.224 이상이 필요합니다. 기기 간 대화를
먼저 시작하는 것은 v2.1.225 이상, @멘션과 /config 행 표시는 v2.1.232
이상입니다.
플래그: CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC,
DISABLE_TELEMETRY, DO_NOT_TRACK, DISABLE_GROWTHBOOK 중 하나라도
기능 플래그 평가를 끄면 메시징이 조용히 비활성화됩니다.
빠른 진단: /list-agents 명령이 인식되면 이 기능이 있고, 인식되지
않으면 없습니다.
칸반 모드는 인바운드 메시지를 자동 수락합니다: 실행기가
{"crossSessionInbound": "accept"}를 담은 임시 설정 파일을 작성하고
--settings로 백엔드에 전달합니다. 파일은 세션 전용이며(종료 시
정리) 영구 설정을 변경하지 않습니다.
명령줄에 --settings <file>을 전달하면 실행기는 자체 설정 파일을
주입하지 않습니다. 파일에 다음 내용이 있는지 확인하세요:
{
"crossSessionInbound": "accept"
}리드 SessionStart 알림은 실행기가 주입하지 않았을 때 확인을 상기시키는 안내를 출력합니다.
리드 알림은 런 id, 세 개의 컴파니언 실행 명령, 리더 소켓 경로, 인바운드 자동화 상태를 안내합니다. 컴파니언 알림은 합류를 확인하는 역할 없는 한 줄입니다. 두 알림 모두 프롬프트하지 않으며 정보 제공용 stdout입니다.