46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
|
# `.live/` 실시간 공유 체계 — 실무 사용 안내
|
||
|
|
|
||
|
|
> **역할 분담**: 본 README는 **실무 사용 쿡북**이며, 규칙·헌법급 정의는 [`.claude/skills/너드나비스-코어룰/SKILL.md`](../../.claude/skills/너드나비스-코어룰/SKILL.md) **C34** 단일 SOT. 본 파일은 레포 `.live/` 경로에서 junction 경유로 접근하며, 중앙 저장소는 `$HOME/.claude/nerdnavis-live/`.
|
||
|
|
|
||
|
|
## 1. `.live/` 용도
|
||
|
|
|
||
|
|
세션 중 변경된 설정·규칙·에이전트 정의·조직 기억을 **세션 갱신 없이 즉시 반영**하기 위한 PC 로컬 실시간 공유 채널. 같은 PC 내 모든 세션(worktree 경계 무관)이 자동 주입받는다.
|
||
|
|
|
||
|
|
## 2. 더미 파일 패턴
|
||
|
|
|
||
|
|
- 파일명: `{변경 대상 파일명 또는 주제}.md`
|
||
|
|
- 예: `CLAUDE.md.live`·`C34_memory_확장.md`·`pd_지시_50.md`
|
||
|
|
- 본문: 변경 요지 append-only. 최대 8,000자
|
||
|
|
|
||
|
|
## 3. 생명주기
|
||
|
|
|
||
|
|
| 시점 | 상태 | 처리 |
|
||
|
|
|------|------|------|
|
||
|
|
| 변경 발생 | PM이 `.live/{파일명}` append | 원본 수정과 동시 수행 |
|
||
|
|
| 같은 PC 다른 세션 | UserPromptSubmit hook 자동 주입 | 증분만 읽기 (토큰 비용 최소) |
|
||
|
|
| "세션 공유"·push 시점 | P21-2 트리거 | 원본 반영 확인 후 `.live/` 비움(README.md·.junction-marker 제외) + commit + push |
|
||
|
|
|
||
|
|
## 4. 세션 간 공유 시나리오
|
||
|
|
|
||
|
|
### 같은 PC 내
|
||
|
|
1. 세션 A에서 원본 수정 + `.live/` append
|
||
|
|
2. 세션 B 다음 프롬프트 → UserPromptSubmit hook `live_inject.sh` 증분 주입
|
||
|
|
3. 즉시 인지 (git 개입 없음)
|
||
|
|
|
||
|
|
### 다른 PC 간
|
||
|
|
1. 세션 A "세션 공유" (P21-2) → `.live/` 비움 + commit + push
|
||
|
|
2. 세션 B (다른 PC) "세션 갱신" (P21) → git pull → SessionStart hook 자동 복원
|
||
|
|
|
||
|
|
## 5. 참조
|
||
|
|
|
||
|
|
- **SKILL.md C34** — PC 로컬 실시간 공유 중앙화 체계 (단일 SOT, 헌법급)
|
||
|
|
- **SKILL.md C21** — 작업 완료 즉시 공유·PM 능동 확인 (내부 공유/공유 완료 2단계)
|
||
|
|
- **scripts/live_junction_ensure.sh** — junction 자동 보장 (SessionStart + UserPromptSubmit hook)
|
||
|
|
- **scripts/live_inject.sh** — UserPromptSubmit hook 증분 주입
|
||
|
|
- **scripts/live_session_load.sh** — SessionStart 전량 1회 로드
|
||
|
|
|
||
|
|
## 변경 이력
|
||
|
|
|
||
|
|
- 2026-04-19: 전 세션 초기 sentinel 손실 시 원본 소실
|
||
|
|
- 2026-04-20: #48 D 집행으로 복구. 중앙 저장소에 신규 작성 (모든 PC 자동 동기화)
|