worktree-setuplisted

# Nova Worktree Setup git worktree는 기본적으로 **gitignored 파일**(`.env`, `.secret/`, `.npmrc` 등)을 새 작업 디렉토리로 복사하지 않는다. 그래서 worktree를 만들면 환경변수·시크릿·레지스트리 토큰이 통째로 사라진 채 세션이 시작된다. 이 스킬은 그 갭을 닫는다 — 병렬 에이전트가 같은 환경으로 바로 일할 수 있게. ## 동작 1. **SessionStart 훅이 자동 실행**한다 (`hooks/worktree-setup.sh`). 설치만 하면 끝. opt-in 불필요. 2. 메인 레포를 감지한다: `CONDUCTOR_ROOT_PATH` → `git worktree list` 첫 항목 순서. 3. 메인 레포에서 다음 항목을 worktree 루트로 **심볼릭 링크**한다 (존재하면 skip, 멱등): | 기본 대상 | 타입 | 용도 | |----------|------|------| | `.env` | 파일 | 기본 환경변수 | | `.env.local` | 파일 | 로컬 오버라이드 | | `.env.development` | 파일 | 개발 환경 | | `.secret` | 디렉토리 | 시크릿 디렉토리 (SWK 컨벤션) | | `.npmrc` | 파일 | 프라이빗 레지스트리 토큰 | > `.env.production`은 **기본 대상에서 제외**한다. 운영 시크릿을 worktree에 노출하는 사고를 막기 위해 — 필요 시 `worktree-sync.json`에 명시. 4. 이미 존재하는 파일·심링크는 **절대 덮어쓰지 않는다**. 재실행도 안전. 5. **깨진 심링크 감지**: worktree에 이미 심링크가 있지만 대상이 사���진 경우(예: 메인 레포에서 `.env` 삭제 후 worktree 심링크만 남음), 자동 교체는 하지 않고 stderr에 경고를 출력한다. 사용자가 `readlink`로 대상을 확인하고 수동 대응한다. ## 프로젝트별 오버라이드 프로젝트 루트에 `.claude/worktree-sync.json`을 두면 기본 대상을 교체한다: ```json { "links": [".env", ".env.local", "config/secrets.json", ".npmrc", ".envrc"] } ``` - 절대 경로(`/...`)는 무시된다. - 경로 세그먼트 `..`(상위 디렉토리 이동)이 포함되면 무시된다. 단 파일명 안의 `..` 문자열(예: `.env..backup`)은 허용된다. - 경로는 메인 레포 루트 기준의 상대 경로다. - `links`가 있으면 기본 5종 대신 이 목록만 사용한다 (교체 방식). ## 트리거 조건 - **자동**: SessionStart 훅이 매번 실행 (멱등) - **수동**: 사용자가 `/nova:worktree-setup` 호출 시 즉시 재시도 - **장애**: 사용자가 "env 못 찾음", "시크릿 안 읽힘", ".env가 비었다"를 보고하면 workt