187 lines
7.1 KiB
Markdown
187 lines
7.1 KiB
Markdown
|
---
|
|||
|
|
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 증분 동기화 체계**: 내부 공유 상태 핵심 수단
|