BurningTimesAi/.claude/skills/bt-session-mgmt/SKILL.md

7.1 KiB
Raw Blame History

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