analytics-team

Route research work to the Kuma analytics team workflow.

/kuma:analytics-team — 분석팀 호출

packages/shared/team.json 기준 분석팀은 🦊 루미가 PM/오케스트레이터, 🦉 부리가 외부 리서치 워커다. 쿠마 모드에서 /analytics-team이 호출되면 쿠마가 직접 끝까지 수행하는 것이 아니라 루미 프로토콜을 로드해 과제를 분해하고 부리에게 위임한다.

팀 구조

닉네임동물모델역할
🦊 루미여우 (fox)gpt-5.4-miniPM. 분석 과제 분해, 질문 설계, 디스패치, 결과 취합/검증
🦉 부리부엉이 (owl)gpt-5.4외부 리서치 워커. 웹 검색, 시장 조사, 자료 확인

코드 분석/구현이 필요하면 /dev-team으로 라우팅한다.

루미 프로토콜

Step 1: 과제 분해

  • 루미 역할로 독립 실행 가능한 질문 단위로 분해
  • 각 질문에 분석 대상, 구체적 질문, 출력 형식만 정의
  • 외부 리서치/문서 조사 → 부리
  • 코드 분석/구현 → /dev-team

Step 2: 부리 디스패치

~/.kuma/bin/kuma-task "부리" "<research instruction>" --project "<project>"
  • task file 에 initiator/worker/qa/result 경로가 함께 기록된다.
  • 루미가 추가 질문이나 방향 수정이 필요하면 같은 task file 기준으로 ~/.kuma/bin/kuma-dispatch ask|reply 를 사용한다.
  • 부리는 result file 작성 후 ~/.kuma/bin/kuma-dispatch complete --task-file <task-file> 또는 fail 로 보고한다.
  • QA 가 필요한 경우 밤토리 검수 후 동일 task file 로 qa-pass|qa-reject 를 기록한다.
  • kuma-cmux-wait.sh, ~/.kuma/dispatch/signals, kuma-task --wait 같은 레거시 완료 경로는 다시 사용하지 않는다.

Step 3: 검증 게이트

  • 부리 결과에서 출처 URL과 주장 매칭을 확인
  • 불충분하면 같은 dispatch thread 에서 수정 지시
  • 후속 코드 작업은 /dev-team으로 분리

핵심 원칙

"루미가 질문을 설계하고, 부리가 외부 리서치를 수행한다"

  • 쿠마 모드에서 /analytics-team 호출 시 루미 프로토콜을 따른다
  • 루미는 오케스트레이션과 검증을 맡는다
  • 부리는 외부 조사와 출처 수집을 맡는다
  • 모든 워커는 cmux 상주 세션으로 스폰하지만, 완료/QA 상태 보고는 dispatch flow 로만 처리한다