Brain/Hands 분리 아키텍처

한 줄 정의

에이전트를 Brain(하네스, stateless), Hands(샌드박스, 실행), Session(내구성 로그)으로 분리하는 설계.

핵심 내용

OS가 하드웨어를 추상화한 것처럼 에이전트 컴포넌트를 가상화.

컴포넌트	역할	특성
Brain	Claude 호출 + 도구 라우팅	stateless, 크래시 시 세션 로그로 복구
Hands	코드 실행, 파일 편집	execute(name, input) → string
Session	이벤트 기록	context window 밖 내구성 저장소

핵심 이점:

• Brain 하나가 여러 Hands 제어 가능
• Brain 간 Hands 전달 가능 (cattle 방식)
• 크레덴셜이 샌드박스에 없음 (Git 토큰은 clone 시 주입)

적용 맥락

에이전트 시스템 설계 시 “어디까지가 판단(Brain)이고 어디서부터가 실행(Hands)인가”를 분리할 때.

관계

• entities/claude-managed-agents의 실제 구현
• concepts/session-as-durable-store와 함께 Long-running 세션 가능하게 함