Claude Code의 숨겨진 '/buddy' 명령어로 구현된 'Bones and Soul' 아키텍처 정보

커뮤니티 반응

사용자들은 이 기능의 기술적 구현 방식에 대해 매우 흥미롭다는 반응을 보였으며, 특히 메인 어시스턴트와 분리된 페르소나 관리 방식에 주목했다.

주요 논점

01찬성다수

이러한 방식이 표준 코딩 워크플로에 재미를 더하면서도 주 기능을 방해하지 않는 영리한 UX 설계이다.

합의점 vs 논쟁점

합의점

메인 어시스턴트의 프롬프트를 오염시키지 않는 이중 레이어 구조가 효과적이다
사용자 ID 해싱을 통한 고유 스탯 부여가 AI 캐릭터의 일관성을 높인다

논쟁점

코딩 워크플로에 이러한 캐릭터 요소를 주입하는 것이 업무 집중도를 떨어뜨릴 가능성이 있다

실용적 조언

메인 시스템 프롬프트를 오염시키지 않고 보조 페르소나를 추가하려면 결정론적 스탯과 별도의 시스템 프롬프트 저장 방식을 결합하라
사용자 ID 해싱을 활용해 AI 페르소나의 고유성과 일관성을 동시에 확보할 수 있다

섹션별 상세

Claude Code의 `/buddy` 명령어는 'Bones and Soul'이라는 이중 구조 아키텍처를 채택했다. 'Bones'는 사용자 ID를 해싱하여 종과 스탯을 결정하는 고정된 로직이며, 'Soul'은 이 스탯을 바탕으로 LLM이 고유한 페르소나 프롬프트를 생성하는 방식이다. 이를 통해 메인 어시스턴트의 지침을 오염시키지 않으면서도 일관된 보조 캐릭터를 완성했다.

결정론적 레이어인 'Bones'는 사용자 ID 해시값을 기반으로 펫의 종, 희귀도, 5가지 기본 스탯(Debugging, Patience, Chaos, Wisdom, Snark)을 산출한다. 입력된 ID가 동일하면 항상 같은 스탯의 펫이 생성되도록 설계되어 사용자별 고유성을 보장한다. 이는 게임 디자인의 난수 생성 방식과 유사하게 AI 페르소나에 객관적 근거를 부여한다.

'Soul' 레이어는 산출된 스탯을 입력값으로 받아 Claude가 해당 펫만을 위한 고유 시스템 프롬프트를 생성하고 로컬에 저장하는 과정이다. 사용자가 펫의 이름을 부르면 메인 Claude 어시스턴트가 물러나고 해당 펫의 시스템 프롬프트가 응답을 주도하는 멀티 에이전트 구조로 작동한다. 스탯 수치에 따라 동일한 코드에 대해서도 'Snark'가 높은 펫은 조롱을, 'Wisdom'이 높은 펫은 조언을 제공하는 등 출력의 톤이 완전히 달라진다.

용어 해설

멀티 에이전트(Multi-Agent): — 여러 개의 독립적인 AI 에이전트가 특정 목적을 위해 협력하거나 역할을 교대하며 작동하는 시스템 구조이다. 이 아티클에서는 메인 어시스턴트와 펫 페르소나가 상황에 따라 역할을 전환하는 방식으로 구현되어 시스템의 유연성을 높인다.
시스템 프롬프트(System Prompt): — LLM에게 부여되는 최상위 지침으로, 모델의 역할, 대화 톤, 행동 규칙 등을 정의하는 텍스트이다. 본문에서는 펫의 스탯에 따라 동적으로 생성된 시스템 프롬프트가 메인 프롬프트와 분리되어 관리되는 핵심 요소로 쓰인다.
결정론적(Deterministic): — 동일한 입력에 대해 항상 동일한 결과가 나오는 성질을 의미하며, AI의 무작위성을 제어하는 데 사용된다. 여기서는 사용자 ID 해싱을 통해 펫의 고정된 능력치를 생성함으로써 사용자마다 고유하고 변하지 않는 경험을 제공하는 근거가 된다.

언급된 도구

Claude Code추천

CLI 기반 코딩 어시스턴트 도구

언급된 리소스

튜토리얼Claude Code Buddy Terminal Pet Guide