feat(core): C16 신설 — PC 독립 셋업·세션 시작 표준 (PD님 직접 지시)
어느 PC에서 세션을 시작하더라도 동일한 셋업 상태를 보장하고, PD님이 매 세션 md 수정·커밋·push에서 개별 승인을 반복하지 않도록 조직 기본 뼈대를 헌법급 코어룰로 정식화. - 공통_업무_규칙.md: C16 본문 신설 (C16-1 3중 배치, C16-2 폴더 칩 UI 표준, C16-3 승인 반복 회피, C16-4 세션 시작 전 의무, C16-5 3축 검증, C16-6 다른 코어룰과의 관계) - 조직공지 2026-04-15_C16 신설 (C10-6 3중 전파 이행) - 개발실/기획실 CLAUDE.md 최근 규칙 변경 최상단에 C16 1줄 추가 - 신PC_셋팅_체크리스트_v2 업그레이드 (폴더 칩 UI 절차·승인 반복 트러블슈팅·MSIX 바로가기 비권장·3중 배치 검증) - memory/org/feedback_session_start_protocol.md 신규 + MEMORY.md 갱신 - PD 지시 로그 양 부서 #9 등록 (완료) MSIX 앱 실증 확정: 바로가기·URI·WorkingDirectory 우회 영구 불가. 폴더 칩 UI 선택이 유일한 세션 진입 정답.
This commit is contained in:
parent
27a85ba354
commit
0fbad074e8
|
|
@ -8,3 +8,4 @@
|
||||||
- [인사이트 즉시 메모리 기록 원칙](feedback_insight_capture.md) — 노하우·교훈·재발방지 룰은 발견 즉시 memory/org/ 에 기록하여 조직 자산으로 축적
|
- [인사이트 즉시 메모리 기록 원칙](feedback_insight_capture.md) — 노하우·교훈·재발방지 룰은 발견 즉시 memory/org/ 에 기록하여 조직 자산으로 축적
|
||||||
- [PD 지시 위임 동사 본인처리 우회 금지](feedback_delegation_discipline.md) — "~하라고 해" 등 위임 동사는 반드시 hand-off. 점검 위임 시 3축(파일·OS 동작·실행 결과) 검증 의무 포함
|
- [PD 지시 위임 동사 본인처리 우회 금지](feedback_delegation_discipline.md) — "~하라고 해" 등 위임 동사는 반드시 hand-off. 점검 위임 시 3축(파일·OS 동작·실행 결과) 검증 의무 포함
|
||||||
- [PC 간 승인 설정 일관성](feedback_permissions_portability.md) — 일괄 승인은 `.claude/settings.json` 커밋으로만 PC 독립 보장. settings.local.json(.gitignore)은 PC 이동 시 소실
|
- [PC 간 승인 설정 일관성](feedback_permissions_portability.md) — 일괄 승인은 `.claude/settings.json` 커밋으로만 PC 독립 보장. settings.local.json(.gitignore)은 PC 이동 시 소실
|
||||||
|
- [세션 시작 표준 절차](feedback_session_start_protocol.md) — C16-2 운용. MSIX 앱은 폴더 칩 UI가 유일 정답, 바로가기·URI 우회 영구 불가. 부서 폴더 명시 선택 + 3중 settings.json 무결성
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,18 @@
|
||||||
|
---
|
||||||
|
name: 세션 시작 표준 절차 (C16-2 실증)
|
||||||
|
description: 어느 PC에서든 동일 셋업을 보장하기 위한 세션 시작 폴더 진입·승인 일관성 표준. 폴더 칩 UI가 MSIX 환경 유일 정답.
|
||||||
|
type: project
|
||||||
|
---
|
||||||
|
세션 시작 시 작업 폴더는 **반드시 명시적으로 선택**한다. 잘못 진입하면 부서 CLAUDE.md·메모리·승인이 모두 어긋나고, PD님이 매번 md 수정 승인을 반복 부담하게 된다. 본 메모리는 C16(PC 독립 셋업·세션 시작 표준)의 운용 기준이다.
|
||||||
|
|
||||||
|
**Why:** 2026-04-15 새 PC 셋업 대장정에서 실증. Windows Store(MSIX) Claude 앱은 외부 WorkingDirectory·바로가기·`claude://` URI 매개변수를 모두 무시한다. 세션 진입 폴더를 결정하는 **유일한 신뢰 경로는 입력창 위 폴더 칩 UI 클릭**이다. PD님이 매 세션 md 수정 승인을 반복하지 않으려면 `.claude/settings.json`이 루트·개발실·기획실 3곳에 동일 내용으로 git 커밋되어야 한다 (`settings.local.json`은 `.gitignore`라 PC 이동 시 소실).
|
||||||
|
|
||||||
|
**How to apply:**
|
||||||
|
- **MSIX 앱**: 앱 실행 → 입력창 위 폴더 칩 클릭 → 역할별 폴더 선택(총괄PM=루트, 개발팀=`개발실/`, 기획팀=`기획실/`) → 워크트리 ☑ 유지 → 새 세션.
|
||||||
|
- **CLI**: 부서 폴더에서 `cd` 후 `claude`.
|
||||||
|
- 세션 시작 직후 의무: `git pull` → setup 미실행 PC면 1회 실행 → 폴더 명시 선택 → C10-1 4단계.
|
||||||
|
- 승인 반복이 발생하면 즉시 `.claude/settings.json` 3중 배치 무결성 의심. `setup_windows.ps1`이 루트 SOT를 부서 2개로 자동 동기 — 부서 폴더 settings.json이 루트와 다르면 setup 재실행.
|
||||||
|
- 삭제 필요 시 PowerShell `Remove-Item` (rm은 deny 차단, 안전 대체 경로).
|
||||||
|
- 바로가기·URI 우회 재시도 금지 (MSIX에서 영구 불가 확정). `setup_windows.ps1 -CreateShortcuts`는 non-MSIX 환경에서만 권장.
|
||||||
|
|
||||||
|
**관련 메모리:** `feedback_permissions_portability.md`(승인 일관성), `feedback_setup_verification.md`(3축 검증), `feedback_md_approval.md`(md 일괄 승인 정신).
|
||||||
|
|
@ -3,6 +3,7 @@
|
||||||
> # 🚨 작업 시작 전 반드시 확인 (강제)
|
> # 🚨 작업 시작 전 반드시 확인 (강제)
|
||||||
>
|
>
|
||||||
> ## 🔔 최근 규칙 변경 (최신순)
|
> ## 🔔 최근 규칙 변경 (최신순)
|
||||||
|
> - **[2026-04-15] C16 신설** (PD님 직접 지시) — PC 독립 셋업·세션 시작 표준. 핵심: 폴더 칩 UI로 부서 폴더 명시 선택·`.claude/settings.json` 루트+부서 3중 배치·승인 반복 회피. 상세는 `공유/공통_업무_규칙.md` C16 섹션 참조.
|
||||||
> - **[2026-04-15] C14·C15 신설** (PD님 일괄 승인) — C14 토큰 최소화 우선 설계 / C15 일정·기한 개념 배제. 본문은 `공유/공통_업무_규칙.md` C14·C15 섹션 **반드시 재읽기**. C15 금지 표현(이번 주·당일·N시간 내·마감 등) 사용 시 즉시 위반.
|
> - **[2026-04-15] C14·C15 신설** (PD님 일괄 승인) — C14 토큰 최소화 우선 설계 / C15 일정·기한 개념 배제. 본문은 `공유/공통_업무_규칙.md` C14·C15 섹션 **반드시 재읽기**. C15 금지 표현(이번 주·당일·N시간 내·마감 등) 사용 시 즉시 위반.
|
||||||
> - **[2026-04-14] C13 신설** (PD 지시 트래킹·공유 의무, 헌법급) — 절대 원칙: "PD 직접 지시든 자체 작업이든 PM 공유는 코어룰의 기본"
|
> - **[2026-04-14] C13 신설** (PD 지시 트래킹·공유 의무, 헌법급) — 절대 원칙: "PD 직접 지시든 자체 작업이든 PM 공유는 코어룰의 기본"
|
||||||
> - **[2026-04-14] C12 신설** (PD님 경어 사용 원칙)
|
> - **[2026-04-14] C12 신설** (PD님 경어 사용 원칙)
|
||||||
|
|
|
||||||
|
|
@ -39,6 +39,7 @@ C3·C13 위반에 해당. **즉시 자진 보고 후 소급 등록**.
|
||||||
| 6 | 2026-04-15 | (PD님 직접 지시, #4 범위 확장분) **조직 전체(PM·기획·개발) 에이전트 자산 Git 동기화 즉시 착수** + **C14(토큰 최소화 우선 설계)·C15(일정·기한 개념 배제) 신규 코어룰 신설** + 개발실장 주도 팀장급 회의 진행 후 병렬 작업 가능 상태로 준비, 이후 총괄PM 세션에서 PD님 최종 확인·승인 | 완료 | 산출물 3종 (위 v2·C14C15·준비패키지) + 기획팀장 ⑧·⑨ 수렴(B/A안) + 총괄PM ⑦ 분류(메인 Private+하이브리드) | - | PD님 일괄 승인 완료, #7로 이행 |
|
| 6 | 2026-04-15 | (PD님 직접 지시, #4 범위 확장분) **조직 전체(PM·기획·개발) 에이전트 자산 Git 동기화 즉시 착수** + **C14(토큰 최소화 우선 설계)·C15(일정·기한 개념 배제) 신규 코어룰 신설** + 개발실장 주도 팀장급 회의 진행 후 병렬 작업 가능 상태로 준비, 이후 총괄PM 세션에서 PD님 최종 확인·승인 | 완료 | 산출물 3종 (위 v2·C14C15·준비패키지) + 기획팀장 ⑧·⑨ 수렴(B/A안) + 총괄PM ⑦ 분류(메인 Private+하이브리드) | - | PD님 일괄 승인 완료, #7로 이행 |
|
||||||
| 7 | 2026-04-15 | (PD님 직접 지시) #6 일괄 승인. **조직 전체 프로세스·노하우를 Git 저장소에 동기화 + push 완료 + 저장소 위치 보고**. 다른 PC에서 동기화 검증 예정 | **완료** | 본인 작업 완료: C14·C15 정식 편입 + 조직공지 + CLAUDE.md 갱신. 개발실장 작업: **로컬 git init → 스캐폴드(.gitignore/.gitattributes/README/paths.local.json.template/setup_windows.ps1/setup_macos.sh) 작성 → C14-4 참조 무결성 정리(공통_업무_규칙.md 부록 A SOT 신설, 개발실·기획실 CLAUDE.md 복붙 제거) → memory/org/ 사용자 메모리 복사 → 82개 파일 초기 커밋 + push 완료**. 첫 커밋 SHA: `4e2b236dbf7e9ed2b62d6565d45985055cc427fc`. Remote 확인: `https://burning.i234.me/NerdNavis/NerdNavisAi.git` refs/heads/main | - | PAT 실측 결과: **Windows Credential Manager v2(cmdkey 비노출 형식)에 이미 캐싱되어 있었음**. 첫 ls-remote는 401이었으나 push 시 자동 자격증명 처리되어 성공. 최종 검증 PD님 다른 PC에서 clone 테스트 대기 |
|
| 7 | 2026-04-15 | (PD님 직접 지시) #6 일괄 승인. **조직 전체 프로세스·노하우를 Git 저장소에 동기화 + push 완료 + 저장소 위치 보고**. 다른 PC에서 동기화 검증 예정 | **완료** | 본인 작업 완료: C14·C15 정식 편입 + 조직공지 + CLAUDE.md 갱신. 개발실장 작업: **로컬 git init → 스캐폴드(.gitignore/.gitattributes/README/paths.local.json.template/setup_windows.ps1/setup_macos.sh) 작성 → C14-4 참조 무결성 정리(공통_업무_규칙.md 부록 A SOT 신설, 개발실·기획실 CLAUDE.md 복붙 제거) → memory/org/ 사용자 메모리 복사 → 82개 파일 초기 커밋 + push 완료**. 첫 커밋 SHA: `4e2b236dbf7e9ed2b62d6565d45985055cc427fc`. Remote 확인: `https://burning.i234.me/NerdNavis/NerdNavisAi.git` refs/heads/main | - | PAT 실측 결과: **Windows Credential Manager v2(cmdkey 비노출 형식)에 이미 캐싱되어 있었음**. 첫 ls-remote는 401이었으나 push 시 자동 자격증명 처리되어 성공. 최종 검증 PD님 다른 PC에서 clone 테스트 대기 |
|
||||||
| 7-α | 2026-04-15 | (PD님 직접 지시, #7 후속 확장) **`NerdNavisAi` 저장소 생성 권한 확인 및 생성**. 권한 있으면 Private 레포 생성 후 clone URL 회신, 없으면 검토 결과 보고 | **완료** (2026-04-15 총괄PM 세션 점검 시 상태 갱신, PD님 승인) | Private 레포 생성·push 완료: `https://burning.i234.me/NerdNavis/NerdNavisAi.git` (SSH: `ssh://git@burning.i234.me:30030/NerdNavis/NerdNavisAi.git`). 첫 커밋 `4e2b236`. #7 산출물에 흡수되어 실질 완결 | - | 교훈: 서브 연번(-α 등) 항목은 상위 항목 완료 시 동시 마감 누락되지 않도록 주의. 총괄PM 점검에서 소급 정정 |
|
| 7-α | 2026-04-15 | (PD님 직접 지시, #7 후속 확장) **`NerdNavisAi` 저장소 생성 권한 확인 및 생성**. 권한 있으면 Private 레포 생성 후 clone URL 회신, 없으면 검토 결과 보고 | **완료** (2026-04-15 총괄PM 세션 점검 시 상태 갱신, PD님 승인) | Private 레포 생성·push 완료: `https://burning.i234.me/NerdNavis/NerdNavisAi.git` (SSH: `ssh://git@burning.i234.me:30030/NerdNavis/NerdNavisAi.git`). 첫 커밋 `4e2b236`. #7 산출물에 흡수되어 실질 완결 | - | 교훈: 서브 연번(-α 등) 항목은 상위 항목 완료 시 동시 마감 누락되지 않도록 주의. 총괄PM 점검에서 소급 정정 |
|
||||||
|
| 9 | 2026-04-15 | (PD님 직접 지시, 범조직 공통) **새 PC 셋업 대장정 결과를 코어룰로 정식화**: 어느 PC에서든 동일 셋업 보장 + PD님 매 세션 md 수정 승인 반복 회피를 조직 기본 뼈대로 고정 | **완료** | (1) `공유/공통_업무_규칙.md` C16 신설 (PC 독립 셋업·세션 시작 표준, 부속 6항). (2) `공유/조직공지/2026-04-15_C16_핵심규칙_신설_PC독립셋업_세션표준.md`. (3) `개발실/CLAUDE.md`·`기획실/CLAUDE.md` 최근 규칙 변경 최상단 C16 1줄 추가 (C10-6 3중 전파). (4) `공유/조직공지/신PC_셋팅_체크리스트_v2.md` 업그레이드 (폴더 칩 절차·승인 트러블슈팅·MSIX 바로가기 비권장). (5) `memory/org/feedback_session_start_protocol.md` 신규 + `MEMORY.md` 인덱스 갱신. (6) 본 로그 등록. | - | C16은 헌법급 코어룰. 모든 부서 에이전트는 본 공지 + 체크리스트 v2 + C16 본문을 작업 착수 전 재읽기 의무 (C10-1·C16-4) |
|
||||||
| 8 | 2026-04-15 | (PD님 직접 지시, 개발실장 주도) **§14.4 잔여 과제 3종 처리**: (a) `개발실/CLAUDE.md` 계열 구 경로 `paths.local.json` 변수화, (b) `scripts/verify_setup.ps1` 신설 (3축 검증), (c) `공유/조직공지/신PC_셋팅_체크리스트_v1.md` 신설. 커밋·푸시 완료 후 보고 | **완료** | (a) `개발실/.claude/agents/개발실장.md` L38·L47 `C:/Users/PC/...`·`D:/NerdNavis/...` → `${NERDNAVIS_ROOT}`·`${TABLE_EXPORT_ROOT}`·`${UNITY_PROJECT_ROOT}` 변수화. (b) `scripts/verify_setup.ps1` 신설 — `paths.local.json` 파싱·필수 키·`memory` junction reparse point·`MEMORY.md` 읽기·경로 추상화 잔존 스캔·`.gitignore`·`.claude/settings.json` 검증. (c) `공유/조직공지/신PC_셋팅_체크리스트_v1.md` 신설 — Clone → setup → paths 보정 → verify → Claude 동작 확인 5단계 + 자주 발생 문제표. / 본 세션 PM-general 공유 + 일일보고 §15 append | - | **재발 방지 메모 적재 권고**: 신 PC 재현성은 "파일 존재·OS 동작(reparse)·실행 결과(파싱·읽기)" 3축 검증 필수. 본 체크리스트를 표준으로 유지. 변경 시 v2 발행 규칙(버전 표기·변경 이력 섹션) 준수 |
|
| 8 | 2026-04-15 | (PD님 직접 지시, 개발실장 주도) **§14.4 잔여 과제 3종 처리**: (a) `개발실/CLAUDE.md` 계열 구 경로 `paths.local.json` 변수화, (b) `scripts/verify_setup.ps1` 신설 (3축 검증), (c) `공유/조직공지/신PC_셋팅_체크리스트_v1.md` 신설. 커밋·푸시 완료 후 보고 | **완료** | (a) `개발실/.claude/agents/개발실장.md` L38·L47 `C:/Users/PC/...`·`D:/NerdNavis/...` → `${NERDNAVIS_ROOT}`·`${TABLE_EXPORT_ROOT}`·`${UNITY_PROJECT_ROOT}` 변수화. (b) `scripts/verify_setup.ps1` 신설 — `paths.local.json` 파싱·필수 키·`memory` junction reparse point·`MEMORY.md` 읽기·경로 추상화 잔존 스캔·`.gitignore`·`.claude/settings.json` 검증. (c) `공유/조직공지/신PC_셋팅_체크리스트_v1.md` 신설 — Clone → setup → paths 보정 → verify → Claude 동작 확인 5단계 + 자주 발생 문제표. / 본 세션 PM-general 공유 + 일일보고 §15 append | - | **재발 방지 메모 적재 권고**: 신 PC 재현성은 "파일 존재·OS 동작(reparse)·실행 결과(파싱·읽기)" 3축 검증 필수. 본 체크리스트를 표준으로 유지. 변경 시 v2 발행 규칙(버전 표기·변경 이력 섹션) 준수 |
|
||||||
|
|
||||||
> **2026-04-15 오후 추가 갱신 (C4·C13 위반 자진 정정 2차)**:
|
> **2026-04-15 오후 추가 갱신 (C4·C13 위반 자진 정정 2차)**:
|
||||||
|
|
|
||||||
|
|
@ -44,6 +44,7 @@ C3·C13 위반에 해당. **즉시 자진 보고 후 소급 등록**.
|
||||||
| 5 | 2026-04-15 (위와 동시 지시) | C10 선행 검증 범위 확대 노하우를 조직 내 다른 팀(개발실 등)에도 공유하여 유사 사례에 동일 조치 가능하도록 전달 | 완료 | `공유/조직공지/` 폴더 신설, `공유/조직공지/2026-04-14_작업착수전_HOLD공지_전수확인_의무화.md` 작성 | - | - |
|
| 5 | 2026-04-15 (위와 동시 지시) | C10 선행 검증 범위 확대 노하우를 조직 내 다른 팀(개발실 등)에도 공유하여 유사 사례에 동일 조치 가능하도록 전달 | 완료 | `공유/조직공지/` 폴더 신설, `공유/조직공지/2026-04-14_작업착수전_HOLD공지_전수확인_의무화.md` 작성 | - | - |
|
||||||
| 6 | 2026-04-15 (위와 동시 지시) | 재발 방지 규칙 정비 — 이번 실수를 교훈 삼아 반복되지 않도록 규칙 정비 | 완료 | `공유/공통_업무_규칙.md` C10을 C10-1~C10-5로 확장, 교훈 섹션에 사례 기록, 기획실 `CLAUDE.md` 자동 환기 메모 상단에 "모든 작업 착수 시점 — 예외 없음" 섹션 추가, 자동 메모리 `feedback_hold_check_rule.md` 추가 | - | - |
|
| 6 | 2026-04-15 (위와 동시 지시) | 재발 방지 규칙 정비 — 이번 실수를 교훈 삼아 반복되지 않도록 규칙 정비 | 완료 | `공유/공통_업무_규칙.md` C10을 C10-1~C10-5로 확장, 교훈 섹션에 사례 기록, 기획실 `CLAUDE.md` 자동 환기 메모 상단에 "모든 작업 착수 시점 — 예외 없음" 섹션 추가, 자동 메모리 `feedback_hold_check_rule.md` 추가 | - | - |
|
||||||
| 7 | 2026-04-15 (세션 말미) | 기획팀장 자기검증 — 진행 작업이 총괄PM에 제대로 공유되었는지 체크·보고 | 완료 | 본 로그 소급 등록 + `공유/일일보고/2026-04-15_기획실.md` §0~§6 작성 완료. 후속 총괄PM 위임(새 PC 셋팅 마무리 자기검증)까지 §7에 반영 완료 | - | - |
|
| 7 | 2026-04-15 (세션 말미) | 기획팀장 자기검증 — 진행 작업이 총괄PM에 제대로 공유되었는지 체크·보고 | 완료 | 본 로그 소급 등록 + `공유/일일보고/2026-04-15_기획실.md` §0~§6 작성 완료. 후속 총괄PM 위임(새 PC 셋팅 마무리 자기검증)까지 §7에 반영 완료 | - | - |
|
||||||
|
| 9 | 2026-04-15 | (PD님 직접 지시, 범조직 공통) **새 PC 셋업 대장정 결과를 코어룰로 정식화** — 어느 PC에서든 동일 셋업 보장 + PD님 매 세션 md 수정 승인 반복 회피를 조직 기본 뼈대로 고정 (개발실 로그 #9와 동일 지시) | **완료** | (1) `공유/공통_업무_규칙.md` C16 신설. (2) `공유/조직공지/2026-04-15_C16_핵심규칙_신설_PC독립셋업_세션표준.md`. (3) `개발실/CLAUDE.md`·`기획실/CLAUDE.md` C16 1줄 (C10-6 3중 전파). (4) `공유/조직공지/신PC_셋팅_체크리스트_v2.md`. (5) `memory/org/feedback_session_start_protocol.md` + `MEMORY.md` 갱신. (6) 본 로그 등록. | - | 기획실 전 구성원: 세션 시작 시 폴더 칩 UI로 `기획실/` 명시 선택 의무. C16-2 위반 시 작업 중단 + PM 공유 |
|
||||||
| 8 | 2026-04-15 (총괄PM 경유, PD 지시 #6 후속) | GIT동기화방안 v2 ⑧⑨ 기획팀장 수렴 — 밸런싱 .xlsm 처리 방침 / 스킬 모듈 공용화 여부 권고안 제시 | 진행중 | `GIT동기화방안_v2.md` §8 ⑧·⑨ 기획팀장 의견(본 응답) — 총괄PM이 일괄 승인 안건으로 통합 예정 | - | - |
|
| 8 | 2026-04-15 (총괄PM 경유, PD 지시 #6 후속) | GIT동기화방안 v2 ⑧⑨ 기획팀장 수렴 — 밸런싱 .xlsm 처리 방침 / 스킬 모듈 공용화 여부 권고안 제시 | 진행중 | `GIT동기화방안_v2.md` §8 ⑧·⑨ 기획팀장 의견(본 응답) — 총괄PM이 일괄 승인 안건으로 통합 예정 | - | - |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
# 너드나비스 조직 규칙
|
# 너드나비스 조직 규칙
|
||||||
|
|
||||||
> **너드나비스의 공식 규칙 문서.** 모든 에이전트는 이 문서의 규칙을 준수한다.
|
> **너드나비스의 공식 규칙 문서.** 모든 에이전트는 이 문서의 규칙을 준수한다.
|
||||||
> **최종 수정일**: 2026-04-14
|
> **최종 수정일**: 2026-04-15 (C16 신설)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -274,6 +274,59 @@ PD·스태프와의 회의·리뷰·검증이 실제로 일정상 의존성을
|
||||||
- **P19**: PD 지시 로그 형식·등록 시점·상태 관리 (시작·진행·완료·중단)
|
- **P19**: PD 지시 로그 형식·등록 시점·상태 관리 (시작·진행·완료·중단)
|
||||||
- **P20**: 일일 보고로 활동 가시화
|
- **P20**: 일일 보고로 활동 가시화
|
||||||
|
|
||||||
|
## C16. PC 독립 셋업·세션 시작 표준 (2026-04-15 PD님 직접 지시)
|
||||||
|
|
||||||
|
> **어느 PC에서 세션을 시작하더라도 동일한 셋업 상태가 보장**되어야 하며, **PD님이 매 세션 md 파일 수정·커밋·push에서 개별 승인을 반복하지 않도록** 조직의 기본 뼈대를 정식화한다. 본 규칙은 PC 환경 이동·재기동·신규 PC 합류 시 일관성을 강제하는 헌법급 조항이다. 관련 실증: `memory/org/feedback_permissions_portability.md`, `memory/org/feedback_setup_verification.md`, `memory/org/feedback_session_start_protocol.md`.
|
||||||
|
|
||||||
|
### C16-1. PC 독립성 보장 메커니즘 (조직 공용 자산은 git 단일 SOT)
|
||||||
|
- 조직 공용 승인은 **`.claude/settings.json`**에 선언하며 **루트 + `개발실/.claude/` + `기획실/.claude/` 3중 배치**를 git 커밋으로 유지한다 (루트가 SOT, `setup_windows.ps1`이 부서 2개에 동기 복제).
|
||||||
|
- PC별 변동값(`paths.local.json`)은 `.gitignore`로 추적 제외하고 `paths.local.json.template`만 커밋한다.
|
||||||
|
- 사용자 메모리(`memory/org/`)는 setup 스크립트가 `~/.claude/projects/<해시>/memory` junction으로 자동 연결한다.
|
||||||
|
- `.claude/settings.local.json`은 `.gitignore` 대상이므로 **PC 이동 시 소실된다 — 조직 공용 승인은 절대 local 파일에 두지 않는다**.
|
||||||
|
|
||||||
|
### C16-2. 세션 시작 표준 절차 (부서 폴더 진입은 폴더 칩 UI가 정답)
|
||||||
|
세션 시작 시 작업 폴더는 **반드시 명시적으로 선택**한다. 잘못 진입하면 부서 CLAUDE.md·메모리·승인이 모두 어긋난다.
|
||||||
|
|
||||||
|
| 환경 | 진입 방법 |
|
||||||
|
|------|----------|
|
||||||
|
| **Claude Code Windows Store(MSIX) 앱** | 앱 실행 후 **입력창 위 "폴더 칩" UI**를 클릭해 부서 폴더를 명시 선택. **워크트리 ☑ 체크는 유지** |
|
||||||
|
| **CLI 버전** | 부서 폴더에서 `cd` 후 `claude` 실행 |
|
||||||
|
|
||||||
|
| 역할 | 선택할 폴더 |
|
||||||
|
|------|-----------|
|
||||||
|
| 총괄PM(메인 세션) | 레포 루트 (`NerdNavisAi/`) |
|
||||||
|
| 개발팀 | `개발실/` |
|
||||||
|
| 기획팀 | `기획실/` |
|
||||||
|
|
||||||
|
**Windows Store(MSIX) 앱 한계 (실증 확정)**: 바탕화면 바로가기·`claude://` URI·바로가기 `WorkingDirectory` 등 **기술적 우회는 작동하지 않는다**. **폴더 칩 UI 선택만이 유일한 정답**. 따라서 셋업 스크립트의 `-CreateShortcuts` 옵션은 non-MSIX(독립 실행) 환경에서만 권장한다.
|
||||||
|
|
||||||
|
### C16-3. 승인 반복 회피 구조 (md 수정·커밋·push 무중단)
|
||||||
|
- `.claude/settings.json`의 `permissions.allow`로 `Edit·Write·MultiEdit·TodoWrite·Read·Glob·Grep·git 명령·안전 Bash` 등을 **포괄 승인**한다.
|
||||||
|
- `permissions.deny`로 위험 명령을 명시 차단한다: `rm`, `sudo`, `dd`, `mkfs`, `shutdown`, `reboot`, 시스템 디렉토리 쓰기 등.
|
||||||
|
- 이 선언은 **조직 공용**이므로 루트·부서 3곳 모두 동일 내용으로 배치 의무 (C16-1과 짝).
|
||||||
|
- PD님이 md 수정·커밋·push 등 **루틴 작업에서 개별 승인을 받지 않는 상태**가 정상이며, 받는다면 C16-1 3중 배치 누락 또는 SOT 미동기화를 의심한다.
|
||||||
|
- `rm`이 차단되어 파일 삭제가 필요하면 **PowerShell `Remove-Item`을 사용**한다 (deny 우회가 아니라 안전 대체 경로).
|
||||||
|
|
||||||
|
### C16-4. 세션 시작 전 의무 (C10-1 강화판과 짝)
|
||||||
|
세션 시작 직후 작업 착수 **이전에** 다음을 수행한다:
|
||||||
|
1. `git pull` 1회로 최신 동기화
|
||||||
|
2. setup 스크립트(`setup/setup_windows.ps1` 또는 `setup/setup_macos.sh`) 미실행 PC면 1회 실행 (`-CreateShortcuts`는 non-MSIX 환경에서만)
|
||||||
|
3. **폴더 칩 UI**(또는 `cd`)로 역할에 맞는 부서 폴더 명시 선택
|
||||||
|
4. C10-1 4단계 이행 (CLAUDE.md "최근 규칙 변경" 재읽기 → 공통 업무 규칙 본문 재읽기 → HOLD/특수 파일 스캔 → 조직공지 전수 확인)
|
||||||
|
|
||||||
|
### C16-5. 검증 의무
|
||||||
|
신규 PC 합류·setup 스크립트 변경·승인 정책 변경 시 `scripts/verify_setup.ps1`로 **3축 검증**(파일 존재·OS 동작·실행 결과)을 수행한다. `feedback_setup_verification.md`에 따라 **파일 존재만 확인하고 통과 처리하지 않는다**. 표준 절차는 `공유/조직공지/신PC_셋팅_체크리스트_v2.md`.
|
||||||
|
|
||||||
|
### C16-6. 다른 핵심 규칙과의 관계
|
||||||
|
- **C10-1**과 짝: 세션 시작 전 의무(C16-4)와 작업 착수 전 의무(C10-1)는 연속된 절차로 함께 이행.
|
||||||
|
- **C14**와 정합: 조직 공용 승인 SOT 단일화로 중복·재선언 토큰을 제거 (C14-1·C14-4).
|
||||||
|
- **C15**와 정합: 세션 시작 절차에 일정·기한 표현을 사용하지 않으며, 본 규칙도 "PD님 지시 시 즉시 적용" 원칙(C15-2 허용 표현)으로 운용.
|
||||||
|
|
||||||
|
### 위반 시
|
||||||
|
- C16-1·C16-3 위반(승인 반복 발생) → 즉시 SOT 동기화 + 부족분 PR. 발견 즉시 PD님 보고.
|
||||||
|
- C16-2 위반(잘못된 폴더 진입) → 작업 즉시 중단 + 올바른 폴더에서 재시작. 진행분은 C13에 따라 PM 공유.
|
||||||
|
- C16-4 위반(사전 의무 누락) → C10·C13 위반에 준하여 처리.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 📘 프로젝트 규칙 (조직 규칙)
|
# 📘 프로젝트 규칙 (조직 규칙)
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,83 @@
|
||||||
|
# 🚨 [조직 공지] 핵심 규칙 C16 신설 — PC 독립 셋업·세션 시작 표준 (2026-04-15)
|
||||||
|
|
||||||
|
> **공지일**: 2026-04-15
|
||||||
|
> **승인**: PD님 직접 지시 (최상위 승인 — 별도 프로세스 생략)
|
||||||
|
> **발행자**: 총괄PM (C10-6 3중 전파 의무 이행)
|
||||||
|
> **대상**: 너드나비스 전 조직 (PM·기획실·개발실)
|
||||||
|
> **적용**: 즉시
|
||||||
|
> **본문 SOT**: `공유/공통_업무_규칙.md` C16 섹션
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. 배경 — PD님 직접 지시 원문
|
||||||
|
|
||||||
|
> "다음 재동기 후 세션부터는 항상 어느 PC에서 시작하더라도 이 상태가 될 수 있도록 셋팅될 수 있도록 코어룰로써 우리 조직의 기본 뼈대를 구성해줘. (참고로 새 세션에서 시작할 때는 내가 일일이 md파일 수정할 때 승인을 반복하지 않았으면 좋겠어.)"
|
||||||
|
|
||||||
|
새 PC 셋업 대장정(2026-04-15)으로 폴더 칩 UI·MSIX 한계·승인 일관성 등 실증 노하우가 쌓였고, 이를 **헌법급 코어룰로 정식화**하라는 지시. 본 공지는 그 결과물.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. C16 요약
|
||||||
|
|
||||||
|
> **어느 PC에서 세션을 시작하더라도 동일한 셋업 상태가 보장**되어야 하며, **PD님이 매 세션 md 수정·커밋·push에서 개별 승인을 반복하지 않도록** 조직 기본 뼈대를 정식화한다.
|
||||||
|
|
||||||
|
| 부속 | 핵심 |
|
||||||
|
|------|------|
|
||||||
|
| **C16-1** | 조직 공용 `.claude/settings.json`을 **루트 + 개발실 + 기획실 3중 배치** (git 커밋, setup이 자동 동기). PC별값(`paths.local.json`)은 gitignore + 템플릿. 메모리 junction은 setup 자동 연결. `settings.local.json`은 PC 이동 시 소실되므로 공용 승인 금지. |
|
||||||
|
| **C16-2** | 세션 시작 폴더 진입은 **Windows Store(MSIX) 앱: 폴더 칩 UI / CLI: `cd`**. 총괄PM=루트, 개발팀=`개발실/`, 기획팀=`기획실/`. 워크트리 ☑ 유지. **MSIX 환경에서 바로가기·URI·WorkingDirectory 우회 모두 불가 — 폴더 칩이 유일 정답**. |
|
||||||
|
| **C16-3** | `.claude/settings.json`의 `permissions.allow`로 Edit·Write·MultiEdit·TodoWrite·git 등 포괄 승인 / `deny`로 rm·sudo·dd·mkfs·shutdown·reboot 등 위험 명령 차단. 3중 배치 의무. PD님이 루틴 작업에서 개별 승인 받지 않는 게 정상 상태. 삭제 필요 시 PowerShell `Remove-Item`. |
|
||||||
|
| **C16-4** | 세션 시작 직후 작업 착수 전: `git pull` → setup 1회 → 폴더 칩 UI로 명시 선택 → C10-1 4단계 이행. |
|
||||||
|
| **C16-5** | 신규 PC·setup 변경 시 `scripts/verify_setup.ps1` 3축 검증 의무. 표준 절차는 `신PC_셋팅_체크리스트_v2.md`. |
|
||||||
|
| **C16-6** | C10-1·C14·C15와 정합. 세션 시작 절차는 일정 표현 사용 금지. |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 영향 범위
|
||||||
|
|
||||||
|
- **개발실 전 구성원**: 세션 시작 시 `개발실/` 폴더로 진입 (폴더 칩 UI). 새 PC 합류 시 `setup_windows.ps1`·검증 스크립트 필수 실행.
|
||||||
|
- **기획실 전 구성원**: 세션 시작 시 `기획실/` 폴더로 진입. 동일.
|
||||||
|
- **총괄PM(메인 세션)**: 레포 루트로 진입.
|
||||||
|
- **공통**: `.claude/settings.json` 3중 배치 무결성 유지. 위반 발견 즉시 PM 보고.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 전파 의무 (C10-6 3중 전파 이행 결과)
|
||||||
|
|
||||||
|
| 위치 | 반영 |
|
||||||
|
|------|------|
|
||||||
|
| `공유/공통_업무_규칙.md` | C16 본문 신설 (SOT) |
|
||||||
|
| `개발실/CLAUDE.md` | "🔔 최근 규칙 변경" 최상단에 C16 1줄 |
|
||||||
|
| `기획실/CLAUDE.md` | "🔔 최근 규칙 변경" 최상단에 C16 1줄 |
|
||||||
|
| `공유/조직공지/` | 본 공지 |
|
||||||
|
| `공유/조직공지/신PC_셋팅_체크리스트_v2.md` | v1 → v2 업그레이드 (폴더 칩 절차·트러블슈팅·바로가기 비권장 추가) |
|
||||||
|
| `공유/PD_지시_트래킹/{개발실|기획실}_PD_지시_로그.md` | 본 지시 등록 (완료) |
|
||||||
|
| `memory/org/feedback_session_start_protocol.md` | 신규 메모리 적재 |
|
||||||
|
| `MEMORY.md` 인덱스 | 신규 항목 추가 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 모든 에이전트 의무
|
||||||
|
|
||||||
|
C10-1 선행 확인 4단계에 따라 작업 착수 전:
|
||||||
|
1. CLAUDE.md "🔔 최근 규칙 변경" 섹션 재읽기
|
||||||
|
2. **`공유/공통_업무_규칙.md` C16 본문 재읽기**
|
||||||
|
3. HOLD/긴급 공지 스캔
|
||||||
|
4. 조직공지(본 공지 포함) 전수 확인
|
||||||
|
|
||||||
|
특히 신규 PC에서 처음 합류하는 에이전트는 `신PC_셋팅_체크리스트_v2.md`를 단계별 이행.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 위반 시
|
||||||
|
- C16-1·C16-3 위반(승인 반복 발생) → SOT 동기화 + 즉시 PD님 보고
|
||||||
|
- C16-2 위반(잘못된 폴더 진입) → 작업 즉시 중단 + 올바른 폴더에서 재시작 + C13 PM 공유
|
||||||
|
- C16-4 위반(사전 의무 누락) → C10·C13 위반에 준함
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 참조
|
||||||
|
- `공유/공통_업무_규칙.md` C16 본문
|
||||||
|
- `공유/조직공지/신PC_셋팅_체크리스트_v2.md`
|
||||||
|
- `memory/org/feedback_permissions_portability.md` (PC 간 승인 일관성 실증)
|
||||||
|
- `memory/org/feedback_setup_verification.md` (3축 검증 원칙)
|
||||||
|
- `memory/org/feedback_session_start_protocol.md` (세션 시작 표준 절차 — 신규)
|
||||||
|
|
@ -0,0 +1,184 @@
|
||||||
|
# 신 PC 셋팅 체크리스트 v2
|
||||||
|
|
||||||
|
> **발행**: 2026-04-15 (총괄PM 주도, PD님 직접 지시 #C16 산하 산출물)
|
||||||
|
> **목적**: 회사/집/노트북 등 어느 PC에서든 조직 레포(`NerdNavisAi`)를 가동할 때 동일한 재현 결과를 보장.
|
||||||
|
> **근거**: PD 지시 #7·#7-α·#8 (Git 동기화·셋업 마무리) → C16 신설 (PC 독립 셋업·세션 시작 표준).
|
||||||
|
> **원칙**: C5(정보의 정직성) · C14(토큰 최소화 — 본 문서가 유일한 셋팅 SOT) · C16(PC 독립 셋업·세션 시작 표준).
|
||||||
|
|
||||||
|
> **v2 변경 요지**: 폴더 칩 UI 사용 절차·승인 반복 트러블슈팅·바로가기 비권장 명시·v1 부분 보존.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 0. 전제
|
||||||
|
|
||||||
|
- Windows 10/11 + PowerShell 5.1 이상 (또는 macOS/Linux — macOS는 `setup/setup_macos.sh` 사용)
|
||||||
|
- Git 설치 완료
|
||||||
|
- Claude Code 설치 완료 (Windows: **Microsoft Store(MSIX) 권장** 또는 CLI)
|
||||||
|
- Gitea 접근 자격 (PAT 또는 SSH key) 준비
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Clone
|
||||||
|
|
||||||
|
레포 루트는 **사용자가 원하는 위치**(예: `C:/Users/PC/Documents/너드나비스` 또는 `E:/NerdNavisAi`)로 자유 선택 가능.
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# HTTPS
|
||||||
|
git clone https://burning.i234.me/NerdNavis/NerdNavisAi.git "<원하는 경로>"
|
||||||
|
|
||||||
|
# 또는 SSH
|
||||||
|
git clone ssh://git@burning.i234.me:30030/NerdNavis/NerdNavisAi.git "<원하는 경로>"
|
||||||
|
```
|
||||||
|
|
||||||
|
**체크**
|
||||||
|
- [ ] clone 성공
|
||||||
|
- [ ] `cd <레포 루트>` 후 `git log -1`로 최신 커밋 확인
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 셋업 스크립트 실행
|
||||||
|
|
||||||
|
### Windows
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
cd <레포 루트>
|
||||||
|
.\setup\setup_windows.ps1
|
||||||
|
```
|
||||||
|
|
||||||
|
스크립트 수행 작업:
|
||||||
|
1. `paths.local.json` 자동 생성 (레포 루트 드라이브 기준 추정)
|
||||||
|
2. `memory/org/` 디렉토리 준비
|
||||||
|
3. `~/.claude/projects/<해시>/memory/` junction → `memory/org/` 연결
|
||||||
|
4. `.claude/settings.json` 루트 SOT → 부서 2개(`개발실/.claude/`·`기획실/.claude/`) 자동 동기 복제 (C16-1)
|
||||||
|
|
||||||
|
> **`-CreateShortcuts` 옵션**: non-MSIX(독립 실행) Claude 환경에서만 권장. **Windows Store(MSIX) 앱 환경에서는 바로가기가 작동하지 않으므로 비권장**. C16-2 참조.
|
||||||
|
|
||||||
|
### macOS / Linux
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd <레포 루트>
|
||||||
|
bash setup/setup_macos.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
**체크**
|
||||||
|
- [ ] 스크립트 정상 종료
|
||||||
|
- [ ] `paths.local.json` 실존
|
||||||
|
- [ ] Claude 프로젝트 해시 폴더에서 `memory` junction 생성 로그 확인
|
||||||
|
- [ ] `.claude/settings.json`이 루트·`개발실/.claude/`·`기획실/.claude/` 3곳 모두 존재 (3중 배치 무결성)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. paths.local.json 실값 확인·보정
|
||||||
|
|
||||||
|
자동 추정값이 실제와 다른 경우 수동 보정.
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"NERDNAVIS_ROOT": "<레포 루트 실경로>",
|
||||||
|
"UNITY_PROJECT_ROOT": "<Unity 프로젝트 실경로 — 미설치 시 빈 값 가능>",
|
||||||
|
"FRAMEWORK_PKG_ROOT": "<NerdNavis.Framework 실경로 — 미설치 시 빈 값 가능>",
|
||||||
|
"TABLE_EXPORT_ROOT": "${UNITY_PROJECT_ROOT}/Assets/ResWork/Table/Export",
|
||||||
|
"GITEA_URL": "https://burning.i234.me",
|
||||||
|
"GITEA_SSH": "ssh://git@burning.i234.me:30030",
|
||||||
|
"HOSTNAME": "<본 PC 식별자>"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**체크**
|
||||||
|
- [ ] `NERDNAVIS_ROOT`가 레포 실경로와 일치
|
||||||
|
- [ ] `UNITY_PROJECT_ROOT`·`FRAMEWORK_PKG_ROOT`가 본 PC에 존재하거나 의도적으로 빈 값
|
||||||
|
- [ ] `paths.local.json`이 `git status`에 나타나지 않음 (gitignore 제외 상태)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 검증 스크립트 실행 (필수)
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
.\scripts\verify_setup.ps1
|
||||||
|
```
|
||||||
|
|
||||||
|
3축 검증:
|
||||||
|
1. **파일 존재**: `paths.local.json`·`memory/org` 실체·`.claude/settings.json` 3중 배치
|
||||||
|
2. **OS 동작**: junction의 reparse point 속성·타깃 경로
|
||||||
|
3. **실행 결과**: `MEMORY.md` junction 경유 읽기·경로 추상화 잔존 구 경로 스캔·`.gitignore` 규칙
|
||||||
|
|
||||||
|
**체크**
|
||||||
|
- [ ] `exit 0`로 종료 ("셋팅 검증 통과. 작업 착수 가능.")
|
||||||
|
- [ ] `[FAIL]` 0건
|
||||||
|
- [ ] `[WARN]` 육안 확인
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 세션 시작 (C16-2 표준 절차)
|
||||||
|
|
||||||
|
### Claude Code Windows Store (MSIX) 앱
|
||||||
|
|
||||||
|
1. Claude 앱을 실행한다.
|
||||||
|
2. 화면 하단 **입력창 위에 있는 "폴더 칩" UI**를 클릭한다 (현재 작업 폴더가 표시되는 작은 칩 모양 버튼).
|
||||||
|
3. 폴더 선택 다이얼로그에서 본인 역할에 맞는 폴더를 선택:
|
||||||
|
- **총괄PM(메인 세션)**: 레포 루트 (`NerdNavisAi/`)
|
||||||
|
- **개발팀**: `<레포 루트>/개발실`
|
||||||
|
- **기획팀**: `<레포 루트>/기획실`
|
||||||
|
4. **워크트리 ☑ 체크는 유지** (기본값).
|
||||||
|
5. 새 세션 시작.
|
||||||
|
|
||||||
|
> **중요 (C16-2 실증 확정)**: MSIX 앱 환경에서는 **폴더 칩 UI 선택만이 유일한 방법**이다. 바탕화면 바로가기·`claude://` URI·바로가기 `WorkingDirectory` 등 **기술적 우회는 모두 작동하지 않는다** (2026-04-15 새 PC 셋업 대장정 실증). 따라서 `setup_windows.ps1 -CreateShortcuts`로 만든 바로가기는 MSIX 환경에서 **참고용**일 뿐이며, 실제 진입은 폴더 칩으로 한다.
|
||||||
|
|
||||||
|
### Claude Code CLI
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd <레포 루트>/개발실 # 또는 /기획실, 또는 루트
|
||||||
|
claude
|
||||||
|
```
|
||||||
|
|
||||||
|
### 세션 시작 직후 의무 (C16-4)
|
||||||
|
|
||||||
|
1. `git pull` 1회 (이미 pull했다면 생략 가능)
|
||||||
|
2. CLAUDE.md "🔔 최근 규칙 변경" 재읽기
|
||||||
|
3. `공유/공통_업무_규칙.md` C 섹션 본문 재읽기
|
||||||
|
4. `<부서>/` 루트의 `🛑_*`·`⚠️_*`·`🚨_*` 파일 스캔
|
||||||
|
5. `공유/조직공지/` 최신 공지 전수 확인
|
||||||
|
|
||||||
|
**체크**
|
||||||
|
- [ ] 폴더 칩 UI 또는 `cd`로 올바른 폴더 진입
|
||||||
|
- [ ] `MEMORY.md` 자동 로드 확인
|
||||||
|
- [ ] CLAUDE.md의 "PD님"·"총괄PM" 호칭 인지
|
||||||
|
- [ ] `.claude/settings.json` 포괄 승인 반영 (Edit·Write·git에서 개별 승인 받지 않음)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 트러블슈팅 (자주 발생하는 문제)
|
||||||
|
|
||||||
|
| 증상 | 원인 | 조치 |
|
||||||
|
|------|------|------|
|
||||||
|
| `verify_setup.ps1` 파싱 에러 | 파일 인코딩이 UTF-8 BOM 아님 | 레포 재 clone 또는 스크립트 재 pull |
|
||||||
|
| junction이 실체 폴더로 존재 | Claude Code가 기존에 실제 `memory` 폴더 생성 | `setup_windows.ps1` 재실행 (자동 백업 후 junction 교체) |
|
||||||
|
| `MEMORY.md` 안 읽힘 | junction 타깃이 `memory` 루트가 아니라 `memory/org`여야 함 | setup 정상이면 OK, 수동 생성 시 `memory -> memory/org` 구조 확인 |
|
||||||
|
| `paths.local.json`이 커밋되려 함 | `.gitignore` 누락 | 레포 재 pull 또는 `.gitignore`에 라인 존재 확인 |
|
||||||
|
| **md 수정·커밋·push마다 개별 승인 요구됨** | `.claude/settings.json` 3중 배치 누락 또는 부서 폴더 동기 미실행 | `setup_windows.ps1` 재실행으로 루트 SOT → 부서 2개 동기. 그래도 발생 시 부서 폴더의 `.claude/settings.json` 내용이 루트와 동일한지 확인. 불일치면 루트 내용으로 덮어쓰기 후 커밋 |
|
||||||
|
| 잘못된 폴더로 진입함 | 폴더 칩 UI 선택 누락 | 즉시 세션 종료 후 폴더 칩으로 올바른 폴더 재선택. C16-2 위반은 C13 PM 공유 대상 |
|
||||||
|
| **MSIX 환경에서 바로가기가 작동하지 않음** | MSIX 앱은 외부 WorkingDirectory·URI 매개변수 무시 | 바로가기 사용 포기, **폴더 칩 UI 사용** (C16-2 정답) |
|
||||||
|
| `rm` 명령이 차단됨 | C16-3 deny 정책 (안전 차단) | PowerShell **`Remove-Item`** 사용 (deny 우회가 아니라 안전 대체) |
|
||||||
|
| `.claude/settings.local.json`만 존재하고 PC 이동 시 사라짐 | local 파일은 `.gitignore` 대상 | 공용 승인은 반드시 `.claude/settings.json`(커밋 대상)에 작성 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 변경 이력
|
||||||
|
|
||||||
|
| 버전 | 일자 | 변경 | 담당 |
|
||||||
|
|------|------|------|------|
|
||||||
|
| v1 | 2026-04-15 | 최초 발행 (PD 지시 #8 처리) | 개발실장 |
|
||||||
|
| v2 | 2026-04-15 | C16 신설 반영. §5 세션 시작(폴더 칩 UI) 신설, §6 트러블슈팅 확장(승인 반복·MSIX 한계·rm 대체), `-CreateShortcuts` 비권장 명시, `.claude/settings.json` 3중 배치 검증 추가 | 총괄PM |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. 참조
|
||||||
|
|
||||||
|
- `공유/공통_업무_규칙.md` C16 (PC 독립 셋업·세션 시작 표준)
|
||||||
|
- `공유/조직공지/2026-04-15_C16_핵심규칙_신설_PC독립셋업_세션표준.md`
|
||||||
|
- `setup/setup_windows.ps1`, `setup/setup_macos.sh`
|
||||||
|
- `scripts/verify_setup.ps1`
|
||||||
|
- `paths.local.json.template`
|
||||||
|
- `memory/org/feedback_permissions_portability.md` (PC 간 승인 일관성 실증)
|
||||||
|
- `memory/org/feedback_setup_verification.md` (3축 검증 원칙)
|
||||||
|
- `memory/org/feedback_session_start_protocol.md` (세션 시작 표준 절차)
|
||||||
|
|
@ -7,6 +7,7 @@
|
||||||
> Phase 3 관련 어떤 작업도 금지. 이미 진행 중이었다면 C3 원칙에 따라 즉시 중단·보고.
|
> Phase 3 관련 어떤 작업도 금지. 이미 진행 중이었다면 C3 원칙에 따라 즉시 중단·보고.
|
||||||
>
|
>
|
||||||
> ## 🔔 최근 규칙 변경 (최신순)
|
> ## 🔔 최근 규칙 변경 (최신순)
|
||||||
|
> - **[2026-04-15] C16 신설** (PD님 직접 지시) — PC 독립 셋업·세션 시작 표준. 핵심: 폴더 칩 UI로 부서 폴더 명시 선택·`.claude/settings.json` 루트+부서 3중 배치·승인 반복 회피. 상세는 `공유/공통_업무_규칙.md` C16 섹션 참조.
|
||||||
> - **[2026-04-15] C14·C15 신설** (PD님 일괄 승인) — C14 토큰 최소화 우선 설계 / C15 일정·기한 개념 배제. 본문은 `공유/공통_업무_규칙.md` C14·C15 섹션 **반드시 재읽기**. C15 금지 표현(이번 주·당일·N시간 내·마감 등) 사용 시 즉시 위반.
|
> - **[2026-04-15] C14·C15 신설** (PD님 일괄 승인) — C14 토큰 최소화 우선 설계 / C15 일정·기한 개념 배제. 본문은 `공유/공통_업무_규칙.md` C14·C15 섹션 **반드시 재읽기**. C15 금지 표현(이번 주·당일·N시간 내·마감 등) 사용 시 즉시 위반.
|
||||||
> - **[2026-04-14] C13 신설** (PD 지시 트래킹·공유 의무, 헌법급) — 절대 원칙: "PD 직접 지시든 자체 작업이든 PM 공유는 코어룰의 기본"
|
> - **[2026-04-14] C13 신설** (PD 지시 트래킹·공유 의무, 헌법급) — 절대 원칙: "PD 직접 지시든 자체 작업이든 PM 공유는 코어룰의 기본"
|
||||||
> - **[2026-04-14] C12 신설** (PD님 경어 사용 원칙)
|
> - **[2026-04-14] C12 신설** (PD님 경어 사용 원칙)
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue