---
name: bt-session-mgmt
description: 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 hook `live_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과 짝)
1. `git pull` 1회로 최신 동기화
2. setup 스크립트 미실행 PC면 1회 실행
3. C10-1 4단계 이행 (CLAUDE.md·공통 업무 규칙·HOLD 스캔·조직공지 전수)

---

## C17. 최신 세션 관리 기준

### C17-1. 세션 구조
- PM 세션 1개 (레포 루트에서 시작)
- 개발팀·기획팀은 `Task` Agent 도구로 병렬 호출
- 부서별 별도 세션·워크트리 금지 (C24 단일 세션)

### C17-2. 세션 시작 표준 절차
1. **git 최신 동기화** (`git fetch origin && git merge origin/main --no-edit`)
2. **setup 스크립트** 실행 (신규 PC 최초 1회)
3. **SessionStart hook 자동 실행** (change_digest·inbox_scan·pm_context_restore·live_session_load)
4. **CLAUDE.md 자동 로드** → SKILL 자동 주입
5. **최근 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`)로 병렬 호출.

### 금지 행위
1. 부서 업무를 위해 **별도 "새 대화" 생성** — 단일 세션 위반
2. 부서 업무를 Agent 호출 없이 **PM 세션이 직접 수행** — 역할 경계 침범
3. 부서별 워크트리 세션 신규 생성

### 매일 사용 절차
1. Claude Code 앱 실행
2. 레포 루트 PM 단일 세션 실행 (또는 resume)
3. 부서 업무는 Agent 도구로 병렬 호출
4. 세션 종료 시 대화 그대로 둠

---

## 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**:
1. `.live/` 더미 파일 내용을 원본에 반영
2. `.live/` 더미 비우기 (README.md 제외)
3. `git add -A`
4. `git commit` (변경 내용 요약 자동 생성)
5. `git push origin main`
6. 완료 보고 1줄

### 트리거
"세션 공유"·"공유"·"push"

### 연계
다른 세션에서 수신하려면 "**세션 갱신**"(P21) 실행.

---

## C40. 세션 공유·종결 완결성

본 SKILL의 핵심 — 세션 공유 시점·세션 종결 시점 의무.

### 세션 공유 시점 5종 사전 점검
1. Inbox 완료 이관 전수 처리
2. 백업 파일 git ignore 확증
3. PD 지시 로그 산출물 경로 감사 해소
4. 활성 테이블 잔존 검증
5. 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 증분 동기화 체계**: 내부 공유 상태 핵심 수단
