7.1 KiB
7.1 KiB
| name | description |
|---|---|
| bt-session-mgmt | BurningTimes 조직 세션 관리·갱신·공유·종결 규칙. 세션 갱신·세션 공유·sync·main merge·세션 종결·인수인계서·새 PC 이관·worktree 시 자동 로드. 키워드 — 세션·갱신·공유·sync·인수인계·종결·resume·시작·새 PC·이관·worktree·HEAD·동기화. C16 PC 독립 셋업 + C17 최신 세션 관리 + C21 작업 완료 즉시 공유 + C24 단일 세션 운용 + P21 세션 갱신 프로토콜 + P21-2 세션 공유 프로토콜. |
BurningTimes 세션 관리 규칙 (L2)
본 SKILL = 세션 갱신·공유·종결·새 PC 이관 작업 시 자동 로드.
C16. PC 독립 셋업·세션 시작 표준
C16-1. PC 독립성 보장
- 조직 공용 승인 = 루트
.claude/settings.json단일 파일·git 커밋 유지 - PC별 변동값(
paths.local.json) =.gitignore추적 제외 (template만 커밋) - 사용자 메모리(
memory/org/) = 레포 git 추적 SOT .live/= 레포 내 일반 디렉토리(.gitignore) — UserPromptSubmit hooklive_inject.sh이 변경분 증분 주입.claude/settings.local.json=.gitignore대상 (PC 이동 시 소실)
C16-2. 세션 시작 표준 절차 (단일 세션)
PM이 레포 루트(BurningTimesAi/)에서 단일 세션 1개만 실행. 개발팀·기획팀은 Agent 도구(Task)로 병렬 호출.
| 환경 | 진입 방법 |
|---|---|
| Claude Code Windows Store(MSIX) 앱 | 폴더 칩 UI 클릭해 레포 루트 선택 |
| CLI 버전 | cd "D:/BurningTimes/BurningTimesAi" && claude |
C16-4. 세션 시작 전 의무 (C10-1과 짝)
git pull1회로 최신 동기화- setup 스크립트 미실행 PC면 1회 실행
- C10-1 4단계 이행 (CLAUDE.md·공통 업무 규칙·HOLD 스캔·조직공지 전수)
C17. 최신 세션 관리 기준
C17-1. 세션 구조
- PM 세션 1개 (레포 루트에서 시작)
- 개발팀·기획팀은
TaskAgent 도구로 병렬 호출 - 부서별 별도 세션·워크트리 금지 (C24 단일 세션)
C17-2. 세션 시작 표준 절차
- git 최신 동기화 (
git fetch origin && git merge origin/main --no-edit) - setup 스크립트 실행 (신규 PC 최초 1회)
- SessionStart hook 자동 실행 (change_digest·inbox_scan·pm_context_restore·live_session_load)
- CLAUDE.md 자동 로드 → SKILL 자동 주입
- 최근 2일 대화로그 Read (P21-5B) — PM 맥락 복원
C17-3. 세션 전환 시나리오 4종 (C33 연계)
| 시나리오 | 복원 메커니즘 |
|---|---|
| A. 당일 재시작 | SessionStart hook |
| B. 새 PC clone | git pull + setup + hook |
| C. 1주일+ 공백 | P21 5-B 확장 + verify_log_paths.sh |
| D. PM 교체 | A·B·C 모두 + 활성 PD 지시 전수 + 최근 30일 커밋 스캔 |
C21. 작업 완료 즉시 공유·PM 능동 확인
C21-①. 내부 공유 상태 (작업 완료 즉시 공유)
정의: 세션 갱신 전에도 확인할 수 있도록 임시 파일과 로그.
채널:
.live/더미 파일 (P25 Live 증분 동기화 — 🏆 조직 핵심 자산)공유/대화로그/{프로젝트}/YYYY-MM-DD.md(C32)공유/PD_지시_트래킹/{부서}_PD_지시_로그.md(활성 지시 갱신)공유/소통/{from}→{to}/(부서 간 통신)
효과:
- 같은 PC 내 다른 세션이 다음 프롬프트에서 즉시 인지 (UserPromptSubmit hook
live_inject.sh) - git commit 없이도 세션 간 실시간 공유
C21-②. 공유 완료 상태 (C18)
정의: 어떤 PC에서도 동기화시켜 항상 일정한 조직 운영이 가능한 상태.
판정 기준 (C18):
- 원격
main브랜치에 push 완료 - 이전 단계는 공유 완료 아님 (C5 정직성 — 단계 혼동 금지)
C21-④. 2단계 전이 시점
| 시점 | 상태 | 트리거 |
|---|---|---|
| 작업 완료 즉시 | 내부 공유 상태 | .live/ 기록 + 대화로그 + 원본 수정 |
| 필요 시점 | 공유 완료 상태 | PD "세션 공유"·"push" 또는 다른 PC 이관 |
C24. 단일 세션 운용 원칙
PM이 총괄하는 단일 세션 1개만 유지. 개발팀·기획팀은 Agent 도구(Task)로 병렬 호출.
금지 행위
- 부서 업무를 위해 별도 "새 대화" 생성 — 단일 세션 위반
- 부서 업무를 Agent 호출 없이 PM 세션이 직접 수행 — 역할 경계 침범
- 부서별 워크트리 세션 신규 생성
매일 사용 절차
- Claude Code 앱 실행
- 레포 루트 PM 단일 세션 실행 (또는 resume)
- 부서 업무는 Agent 도구로 병렬 호출
- 세션 종료 시 대화 그대로 둠
P21. 세션 갱신 프로토콜
PD "세션 갱신" 지시 시 즉시·자동·무중단 수행:
| 단계 | 작업 |
|---|---|
| 1 | git 동기화 (git fetch && git merge origin/main) |
| 2 | HOLD·긴급 파일 스캔 (🛑·⚠️·🚨_*) |
| 3 | CLAUDE.md "최근 규칙 변경" 재읽기 |
| 4 | 조직공지 최신 확인 |
| 5 | PD 지시 로그 현황 |
| 5-A | 활성 지시 실측 검증 (산출물 경로 실존·상위 규칙 폐기 여부) |
| 5-B | PM 자기 업무 맥락 복원 (최근 2일 대화로그 Read + git log + 당일 부재 시 즉시 작성) |
| 6 | 간결 보고 |
보고 형식
## 세션 갱신 완료
- **동기화**: (성공/충돌)
- **신규 변경**: (커밋 요약)
- **HOLD/긴급**: (또는 "없음")
- **미완료 작업**: (N건)
- **즉시 착수 가능**: (차단 요인 없는 작업)
트리거 표현
"세션 갱신"·"갱신"·"동기화"·"sync" 모두 동일.
P21-2. 세션 공유 프로토콜
PD "세션 공유" 지시 시 즉시 git commit + push:
.live/더미 파일 내용을 원본에 반영.live/더미 비우기 (README.md 제외)git add -Agit commit(변경 내용 요약 자동 생성)git push origin main- 완료 보고 1줄
트리거
"세션 공유"·"공유"·"push"
연계
다른 세션에서 수신하려면 "세션 갱신"(P21) 실행.
C40. 세션 공유·종결 완결성
본 SKILL의 핵심 — 세션 공유 시점·세션 종결 시점 의무.
세션 공유 시점 5종 사전 점검
- Inbox 완료 이관 전수 처리
- 백업 파일 git ignore 확증
- PD 지시 로그 산출물 경로 감사 해소
- 활성 테이블 잔존 검증
- commit 메시지 표준 준수
세션 종결 자동 인수인계 프롬프트 제공 의무
PD 별도 지시 없이도:
- 인수인계서 (
공유/조직공지/YYYY-MM-DD_세션인수인계.md) 12 섹션 구조 - 다음 세션 첫 프롬프트 템플릿 (PD 복사용)
자동 제공 트리거
- 세션 자체 종결 판정 (컨텍스트 한도 근접·작업 자연 마무리)
- PD가 "세션 정리·종결" 류 지시
- 장시간 작업 자연 마무리 후 PM 판단
연관 규칙
- L1: C32 대화로그·C33 정보 동기화·C40·C41 (
bt-foundation) - C18: 조직 공유 완료 판정 (
bt-commit-rules) - C13·P28: PD 지시 트래킹·현황 보고 (
bt-pd-tracking) - 🏆 P25 Live 증분 동기화 체계: 내부 공유 상태 핵심 수단