작업 계획

어디에 생기나

작업 계획은 저장소 안이 아니라 아래 위치에 브랜치마다 생깁니다.

~/.belloga/plans/{owner}/{repo}/{branch}/
├── requirements.md
├── design.md
└── tasks.md

{owner}/{repo}는 저장소의 원격 주소에서 얻습니다. 원격이 없는 저장소는 _local/{저장소 이름}을 씁니다.

어떻게 채워지나

1. worktree를 만들 때 작업 유형을 고르면, 그 유형의 템플릿으로 requirements.md를 미리 채웁니다. 이미 파일이 있으면 덮어쓰지 않습니다.
2. 그 worktree의 Belloga 터미널에서 Claude Code를 켜면, plan 훅이 계획 위치와 쓰는 법을 안내합니다.
3. Claude Code가 세 문서를 쓰고 사용자에게 확인을 받은 뒤 구현합니다.
4. 작업이 끝났다고 사용자가 확인하면 계획 폴더를 ~/.belloga/plans/done/ 아래로 옮기도록 안내합니다.

진행률 보기

worktree 카드에 작업 유형과 tasks.md의 진행률(“태스크 3/7개 완료” 같은 막대)이 보입니다. 진행률은 tasks.md의 맨 위 수준 체크박스(- [ ], - [x])만 셉니다.

카드의 계획 표시를 누르면 tasks.md를 엽니다. 없으면 design.md, requirements.md 순서로 엽니다.

plan 패널

파일 모드에서 저장소를 펼치면 파일 트리 위에 “plan · 저장소 이름” 패널이 보입니다.

• 진행 중인 계획을 브랜치마다 한 줄로, 작업 유형과 진행률과 함께 보여 줍니다. 펼치면 계획 문서가 나오고, 누르면 그 문서가 열립니다.
• ~/.belloga/plans/deferred/ 아래로 옮긴 계획은 접힌 보류 묶음에, ~/.belloga/plans/done/ 아래로 옮긴 계획은 접힌 완료 묶음에 완료 시각과 함께 보입니다.
• 진행 중인 계획이 없으면 “진행 중인 plan이 없습니다”라고 보입니다. 폴더가 바뀌면 목록을 바로 다시 읽습니다.

저장소마다 켜고 끄기

작업 계획 기능은 plan 훅이 켜져 있고 그 저장소에서 쓰기로 했을 때만 동작합니다. 설정의 에이전트 탭 → plan 훅 상세 설정 → 저장소별 사용에서 저장소마다 켜고 끕니다. 새로 연결한 저장소는 켜져 있습니다.

꺼진 저장소에서는 worktree를 만들 때 작업 유형을 묻지 않고, 세션에 계획 안내도 들어가지 않습니다.