docs(memory): 폴더 칩 UI 실증 교훈 + setup 헤더 주석 보강

feedback_permissions_portability.md §4·§5 추가:
- 세션별 프로젝트 전환은 앱 입력창 위 "폴더 칩" UI가 정답
- 워크트리 체크박스로 single-instance 제약 우회
- 바탕화면 바로가기 방식 MSIX 앱에서 불가 (실증 확정)

feedback_setup_verification.md 확장:
- "UI 탐색 우선 원칙" 섹션 신설
- 앱 UI 가능성 먼저 확인 후 기술적 우회 검토

setup_windows.ps1 헤더 주석:
- 바로가기 옵션의 MSIX 환경 한계 명시
- 폴더 칩 UI 우선 사용 안내

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
깃 관리자 2026-04-15 13:40:43 +09:00
parent 4b0fe7277e
commit 27a85ba354
3 changed files with 33 additions and 1 deletions

View File

@ -72,6 +72,20 @@ PD님의 주 PC는 Windows Store에서 설치한 MSIX 버전 Claude 앱(`Package
- MSIX 버전 Claude 앱은 슬래시 커맨드를 **스킬 시스템**으로 처리 → `/permissions` 는 "Unknown skill" 반환
- 권한 확인은 앱 Settings UI 메뉴에서 수행
### 4. 세션별 프로젝트 폴더 전환은 **앱 입력창 위의 "폴더 칩" UI**가 정답 (2026-04-15 실증)
- 신규 세션 화면 입력창 바로 위에 칩 3종(로컬 · **폴더명** · 브랜치/워크트리)이 있음
- **폴더명 칩(🗂️ 아이콘)을 클릭**하면 프로젝트 폴더를 변경할 수 있음 (드롭다운 또는 폴더 선택창)
- git 루트 auto-fallback 우회·바로가기·URI·WorkingDirectory 등 **기술적 우회는 모두 불필요**
- 워크트리 체크박스(☑) 유지 시 Claude Code가 자동으로 `.claude/worktrees/<이름>/`에 격리 워크트리 생성 → Windows Store 앱의 single-instance 제약 속에서도 독립 세션 운용 가능
- **실수 교훈**: UI 가능성을 먼저 탐색하지 않고 바탕화면 바로가기·`claude://` URI·MSIX `shell:AppsFolder` 등 기술적 우회만 시도했던 과잉 대응. 앱 UI 탐색을 1순위로 둘 것
### 5. 바탕화면 바로가기 접근법은 Windows Store 앱에서 **불가** (확정)
- `TargetPath=explorer.exe` + `Arguments=shell:AppsFolder\Claude_pzs8sxrjxfjjc!Claude` + `WorkingDirectory=<부서 폴더>` 방식 시도했으나:
- 앱이 single-instance로 동작 → 이미 열려 있으면 바로가기는 **기존 창 포커스만** 수행
- 앱을 완전 종료 후 바로가기 클릭해도 WorkingDirectory는 **무시됨**
- 앱은 "마지막 열었던 프로젝트"를 자동 복원
- `setup_windows.ps1 -CreateShortcuts` 옵션은 non-MSIX 환경(CLI·VSCode 확장 등)에서만 유효 — Windows Store 앱 사용자는 폴더 칩 UI 사용
## Why
2026-04-15 PD님이 새 PC에서 "md 파일 수정 시 매번 승인 요구" 이슈 지적. 이전 PC에선 일괄 승인 상태였으나 새 PC에선 `.claude/settings.local.json`이 비어있어 개별 승인 요구 발생. 조직 레포에 `.claude/settings.json`이 커밋되어 있지 않아 PC 간 승인 설정이 독립적으로 관리되는 구조였음. 근본 해결을 위해 조직 공용 settings.json 신설·커밋.

View File

@ -16,3 +16,14 @@ type: feedback
- 환경 셋팅·신규 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 가능성을 확실히 배제한 후** 수단이다.

View File

@ -1,10 +1,17 @@
# 너드나비스 조직 레포 - Windows PC 셋업
# 사용: PowerShell에서 실행
# .\setup_windows.ps1 ← 기본 셋업만
# .\setup_windows.ps1 -CreateShortcuts ← 기본 셋업 + 바탕화면 바로가기 3종 생성
# .\setup_windows.ps1 -CreateShortcuts ← 기본 셋업 + 바탕화면 바로가기 3종 생성 (주의 아래)
# .\setup_windows.ps1 -NerdNavisRoot "C:\..." ← 레포 경로 지정
# .\setup_windows.ps1 -CreateShortcuts -ClaudeExePath "C:\Tools\claude\claude.exe"
# ← claude.exe 자동 탐지 실패 시 경로 수동 지정
#
# ⚠️ 바로가기 관련 주의 (2026-04-15 실증)
# Windows Store(MSIX) 버전 Claude 앱은 single-instance + WorkingDirectory 무시 특성이 있어
# 바로가기로 부서 세션을 분리할 수 없다. MSIX 앱 사용자는 앱 실행 후 **입력창 위 "폴더 칩"**
# 을 클릭해 부서 폴더를 선택하는 것이 정답이다. 바로가기 옵션은 non-MSIX 환경(CLI 등)에서만
# 유의미하므로 필요한 사람만 -CreateShortcuts 로 명시 선택할 것.
# 상세: memory/org/feedback_permissions_portability.md
param(
[string]$NerdNavisRoot = $(Resolve-Path (Join-Path $PSScriptRoot "..")).Path,