40 lines
3.0 KiB
Markdown
40 lines
3.0 KiB
Markdown
|
---
|
||
|
|
name: worktree 격리로 인한 조직 실시간 동기화 체계 실패 — 재발 방지
|
||
|
|
description: 2026-04-18 PD님 조직 생존급 선언. P25→C34 승격 + 중앙 Junction 근원 해결. worktree 경계는 실시간 공유 체계의 숨겨진 경계이므로 새 체계 설계 시 최우선 검토 대상
|
||
|
|
type: feedback
|
||
|
|
originSessionId: 0c3fc143-5c2a-4165-afb1-7becf72eaa0a
|
||
|
|
---
|
||
|
|
# worktree 격리로 인한 조직 실시간 동기화 체계 실패
|
||
|
|
|
||
|
|
## 실증 (2026-04-18)
|
||
|
|
세션 A(`tender-liskov-844a72` worktree)와 세션 B(`nifty-wing-4752bd` worktree)에서 P25 Live 증분 동기화 테스트 수행. 세션 B가 `.live/ping.md`에 PING 마커 작성 후 세션 A에서 hook 주입 확인 → **미수신**. 원인은 git worktree가 각 worktree에 독립 파일시스템 디렉토리를 부여하므로 `.live/`가 물리적으로 분리됨.
|
||
|
|
|
||
|
|
## 왜 중요한가 (조직 생존급)
|
||
|
|
PD님 직접 선언: **"이 문제가 해결되지 않으면 앞으로 우리 조직은 유지될 수 없어."**
|
||
|
|
헌법 제1원칙 ⑤ "세션·PC 연속성 보장"의 근본 위협. P25(조직 핵심 자산 선언)가 특정 조건(같은 worktree)에서만 작동한다는 사실이 조직 기반 전제를 훼손.
|
||
|
|
|
||
|
|
## 근본 원인
|
||
|
|
`live_inject.sh` hook이 `git rev-parse --show-toplevel`로 얻은 경로의 `.live/`를 스캔하는데, 이 명령은 **worktree별로 다른 경로를 반환**함. 따라서 worktree A와 B의 `.live/`가 서로 다른 디렉토리이며 hook이 상호 주입 불가.
|
||
|
|
|
||
|
|
## 해결 (C34 신설 + 중앙 Junction)
|
||
|
|
1. 실 저장 경로를 `$HOME/.claude/nerdnavis-live/`로 중앙화 (PC 로컬 단일)
|
||
|
|
2. 각 worktree의 `.live/`를 중앙 디렉토리로 Junction(Windows `mklink /J`) / Symlink(Unix `ln -s`) 연결
|
||
|
|
3. `scripts/live_junction_ensure.sh`가 SessionStart hook 체인에서 보장 (git fetch 직후 최우선 삽입)
|
||
|
|
4. `setup_*` 스크립트 3.5 섹션에서 자동 설치
|
||
|
|
5. Sentinel 파일 `.junction-marker`로 OS-agnostic 판정
|
||
|
|
|
||
|
|
## 재발 방지 체크 (세션 리더 의무)
|
||
|
|
- 신 PC·신 worktree 첫 세션 시 `verify_setup.ps1`의 2.5 "Live 중앙 저장소 실체·reparse·marker 경유 읽기" 3축 통과 확인
|
||
|
|
- `.live/`가 실체 디렉토리로 남아있으면 `setup_windows.ps1` 재실행
|
||
|
|
- 조직 전원 세션 1회 재시작 필수 안내 (C1 사전 고지)
|
||
|
|
- **새 조직 공유 체계 설계 시 worktree 경계 조건을 첫 검토 항목에 포함** (본 사건 재발 방지)
|
||
|
|
|
||
|
|
## 연관
|
||
|
|
- **C34** (헌법급 본 체계 — P25 승격)
|
||
|
|
- **C16-1** (`.live/` junction 자동 연결 편입)
|
||
|
|
- **feedback_agent_path_boundary.md** (Agent 경계 넘기 2차 사건)
|
||
|
|
- **조직공지**: `2026-04-18_C34_신설_worktree_격리_근원해결.md`
|
||
|
|
|
||
|
|
## 교훈
|
||
|
|
**worktree 기능은 편리하나 조직 공유 체계의 숨겨진 경계를 만든다.** "같은 PC = 같은 파일시스템"이라는 직관은 worktree 앞에서 성립하지 않음. 앞으로 공유 체계 설계 시 "실 저장 = 중앙 1곳, 접근 = junction/symlink"을 기본 패턴으로 채택 (C16-1 memory junction과 동일 원칙).
|