하네스 개요

Belloga 하네스는 Belloga 터미널에서 켠 Claude Code 세션에 브랜치별 작업 계획과 사용자 규칙을 넣어 줍니다.

원칙

• Belloga 안에서만 적용합니다: 다른 터미널이나 다른 앱에서 켠 세션은 그대로 둡니다.
• 강제하지 않습니다: ~/.claude의 하네스를 고치지 않습니다. 지시가 부딪히면 사용자의 하네스를 따르거나 사용자에게 묻게 합니다. 작업 계획이 없거나 형식이 틀려도 막지 않습니다.
• 방식은 앱이 정하고, 내용은 사용자가 정합니다: 계획 위치와 앱이 읽는 골격은 Belloga가 정하고, 무엇을 쓸지는 사용자가 템플릿으로 정합니다.

네 부분

• 작업 계획: 브랜치마다 requirements.md, design.md, tasks.md를 저장소 밖에 둡니다.
• 템플릿과 규칙: 계획 문서의 틀과, 세션마다 넣을 규칙입니다.
• 하네스 모드: 사이드바에서 템플릿과 규칙을 고칩니다.
• 훅: 위 내용을 세션에 넣는 Claude Code 훅입니다.

훅 켜고 끄기

설정의 에이전트 탭 → Claude Code에 훅 스위치가 있습니다.

훅	하는 일
세션 상태 훅	세션 상태, 알림, 사용량을 받습니다. 기본으로 켜져 있습니다
plan 훅	세션이 시작될 때 이 브랜치의 작업 계획 위치와 쓰는 법을 안내합니다
규칙 훅	세션이 시작될 때와 컨텍스트를 압축하거나 /clear한 뒤에 규칙을 넣습니다
worktree 훅	worktree를 만들기 전에 위치를 묻게 하고, 앱의 기본 위치도 바꿉니다

plan 훅, 규칙 훅, worktree 훅은 켤 때만 설치됩니다. 전체 스위치로 한꺼번에 켜고 끌 수 있고, 각 훅이 등록하는 이벤트는 더보기에서 봅니다.