---
name: 셋팅 점검은 동작·실체까지 검증
description: 파일 존재만으로 "셋팅 OK" 판정하지 말고 paths.local.json 실파일·junction reparse point 실체·setup 스크립트 실행 이력까지 검증할 것
type: feedback
---

셋팅·환경 점검 보고 시 **파일/디렉토리 존재 여부**만으로 "정상"이라 판정하면 안 된다. 실제 동작에 필요한 다음 3축을 모두 확인할 것:

1. **로컬 환경 파일 실파일 존재** — template만 있고 실파일이 없으면 변수 참조 해석 불가. `paths.local.json`·`settings.local.json` 등.
2. **OS 레벨 연결 실체** — junction/symlink가 단순 폴더 존재가 아니라 reparse point 속성을 갖고 있고 Target이 의도한 경로를 가리키는지. PowerShell `(Get-Item -Force).Attributes` / `fsutil reparsepoint query` 로 검증.
3. **셋업 스크립트 실행 이력 + 결과 메시지** — `setup_windows.ps1` 같은 init 스크립트가 실행되었는지, 실행됐다면 warning 없이 의도 작업을 완료했는지(특히 "Junction 생성:" 로그 라인 확인).

**Why:** 2026-04-15 총괄PM 셋팅 점검 시 Explore 서브에이전트로 파일 존재만 체크해 "정상" 보고했으나, PD님이 개발팀 세션의 셋팅 미완 보고를 받고 재점검 지시. 실제로는 paths.local.json 실파일 미생성 + memory junction 미연결 + setup 스크립트 필터 버그(매칭 실패)의 3중 미완 상태였음. PD님께 잘못된 안심을 드린 것은 C5(정직성)·C3(이슈 은폐 금지) 위반에 준함.

**How to apply:**
- 환경 셋팅·신규 PC 셋업·세션 재시작 후 점검 시 본 3축 검증을 의무 적용.
- 서브에이전트 위임 시 "파일 존재" 대신 "동작 가능 여부 + 실행 검증"을 명시적으로 지시.
- 의심되면 setup 스크립트를 실제 실행해 결과 메시지를 직접 확인할 것.

## UI 탐색 우선 원칙 (2026-04-15 추가 교훈)

문제 진단 시 **앱·도구의 내장 UI 가능성을 먼저 탐색**한 후 기술적 우회를 시도할 것. 우회부터 달려들면 본질 해결이 아닌 임시방편의 누적이 된다.

**Why:** 2026-04-15 Windows Store Claude 앱의 세션별 프로젝트 폴더 전환 문제 해결 과정에서, 총괄PM이 `.claude/settings.json` 전파·MSIX `shell:AppsFolder` URI·바탕화면 바로가기·git worktree 등 **기술적 우회를 연쇄 시도**하며 수차례 실패했으나, 정답은 앱 입력창 바로 위의 **"폴더 칩" UI 한 번의 클릭**이었음. PD님이 직접 스크린샷을 공유해 주셔서 발견. 만약 UI 탐색을 먼저 했다면 수 시간의 시행착오가 회피되었을 것.

**How to apply:**
- "X를 어떻게 할 수 있나?" 질문을 받으면 **앱 UI 내 해당 기능 존재 여부**를 먼저 확인.
- UI 스크린샷을 사용자에게 요청하는 것을 주저하지 말 것. 1장으로 몇 시간을 아낄 수 있다.
- 기술적 우회(바로가기·URI·환경변수·심볼릭 링크 등)는 **UI 가능성을 확실히 배제한 후** 수단이다.
