BUDDY와 KAIROS

미공개 기능이란?

BUDDY와 KAIROS는 Claude Code 소스 코드에 구현되어 있지만 아직 공개적으로 문서화되지 않은 기능입니다. 소스 코드 분석을 통해 존재가 확인되었으며, 향후 공식 출시될 가능성이 높은 기능들입니다.

현재 공개 상태:
  ✓ Claude Code CLI
  ✓ SDK
  ✓ MCP 통합
  ✗ BUDDY (소스에 존재, 미출시)
  ✗ KAIROS (소스에 존재, 미출시)

BUDDY 컴패니언

BUDDY는 소스 코드 분석에 의하면 가상 펫(Virtual Pet) 시스템 으로 구현되어 있습니다. 계정 ID에서 생성된 고유한 스프라이트 캐릭터가 500ms 틱 간격으로 애니메이션되며, 영속적 “soul” 저장소 에 상태를 유지합니다.

BUDDY 아키텍처 (소스 코드 분석 기반):
  ┌─────────────────────────┐
  │   계정 ID → 스프라이트 생성  │
  │   500ms 틱 애니메이션       │
  │   영속적 soul 저장소        │
  └─────────────────────────┘
        │
        ├── 작업 패턴 관찰
        ├── 맥락적 제안 제공
        ├── 선제적 도움 제공
        └── 학습 및 적응

단순한 UI 장식이 아니라, 사용자와의 장기적 관계를 형성하는 동반 에이전트 로 설계되었습니다.

소스 코드 분석 결과	설명
스프라이트 시스템	계정 ID 기반 고유 캐릭터 생성, 500ms 애니메이션
Soul 저장소	영속적 상태 관리, 세션 간 컨텍스트 유지
선제적 제안	반복 작업 감지 시 자동화 제안
워크플로우 최적화	자주 사용하는 패턴을 스킬로 자동 생성 제안

KAIROS Always-On

KAIROS는 소스 코드에서 확인된 상시 실행 백그라운드 에이전트 입니다. 일일 로그를 ~/.claude/.../logs/YYYY/MM/DD.md 경로에 append-only 모드 로 기록하며, Dream 통합 단계 를 통해 축적된 관찰을 정리합니다.

KAIROS 데이터 흐름 (소스 코드 분석 기반):

  모니터링 → 이벤트 감지 → 일일 로그 기록 (append-only)
      │                              │
      └──── Dream 통합 단계 ←────────┘
             (24시간 또는 5+ 세션 후 트리거)
             (출력 제한: <25KB)

로그 경로: ~/.claude/.../logs/YYYY/MM/DD.md

Auto-Dream 은 KAIROS와 연동되는 메모리 통합 시스템입니다. 24시간 경과 또는 5개 이상 세션 축적 시 자동 트리거되어 25KB 이내로 통합 결과를 생성합니다.

소스 코드 분석 결과	설명
일일 로그	YYYY/MM/DD.md 경로, append-only 모드
Dream 통합	24시간/5세션 트리거, 25KB 출력 제한
자동 코드 리뷰	커밋 시 백그라운드에서 리뷰 수행
취약점 스캔	새 의존성 추가 시 즉시 보안 분석

설계 철학 비교

두 시스템은 서로 보완적인 역할을 합니다.

항목	BUDDY	KAIROS
실행 방식	사용자와 함께 실행	독립적 상시 실행
상호작용	대화형, 맥락적	이벤트 기반, 자율적
주요 역할	작업 중 보조	백그라운드 감시/자동화
사용자 인식	명시적 (채팅처럼)	암묵적 (알림으로)

이 두 시스템이 출시되면 Claude Code는 단순한 코딩 어시스턴트를 넘어 지속적으로 프로젝트를 돌보는 개발 파트너로 진화할 것으로 예상됩니다.