From 257733d228968f5fd26c878167e0df7d06554ca8 Mon Sep 17 00:00:00 2001 From: swrring Date: Mon, 20 Apr 2026 14:58:22 +0900 Subject: [PATCH] =?UTF-8?q?refactor(#52-3):=20C34-15=C2=B716=C2=B717=C2=B7?= =?UTF-8?q?18=20=EB=B2=88=ED=98=B8=20=EC=88=9C=20=EC=9E=AC=EB=B0=B0?= =?UTF-8?q?=EC=B9=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit C34-16·C34-15 블록을 C35 앞(C34-18 뒤)에서 삭제 후 C34-17 앞에 C34-15·C34-16 순서로 삽입. Before: C34-17(1788) → C34-18(1801) → C35(1805) → C34-16(1973) → C34-15(1987) After: C34-15(1788) → C34-16(1798) → C34-17(1812) → C34-18(1825) → C35(1829) 내용 수정 없음. 구분자 조정으로 2줄 감소 (2131→2129). C37-2 의미 보존·C37-5 순서 정렬 준수. #52 단계 3/5 완료. Co-Authored-By: Claude Opus 4.7 (1M context) --- .claude/skills/너드나비스-코어룰/SKILL.md | 50 +++--- 공유/PD_지시_트래킹/개발팀_PD_지시_로그.md | 2 +- .../2026-04-20_Phase3_재개_로드맵_병렬착수.md | 144 ++++++++++++++++++ 3 files changed, 169 insertions(+), 27 deletions(-) create mode 100644 공유/소통/개발팀→기획팀/2026-04-20_Phase3_재개_로드맵_병렬착수.md diff --git a/.claude/skills/너드나비스-코어룰/SKILL.md b/.claude/skills/너드나비스-코어룰/SKILL.md index c37781f..ee75abe 100644 --- a/.claude/skills/너드나비스-코어룰/SKILL.md +++ b/.claude/skills/너드나비스-코어룰/SKILL.md @@ -1785,6 +1785,30 @@ Junction 생성 실패 시 **작업을 차단하지 않고** 로컬 `.live/` 일 - **2026-04-19** memory junction 경계 이슈 재발 실증 — PM이 "권고" 수준으로 축소 보고 후 PD님 직접 지적: "근본 해결이 아닌 임시 방편은 코어 룰 위반. C34와 동급의 생존성 이슈는 '권고' 수준이 아니었어" → **옵션 A 집행 지시로 `memory/org/` 중앙화 C34 편입**. PM 과도 보수 해석 4회차 변종 재발. C31-E 체크리스트에 "동급 생존성 이슈 축소 보고 감지" 항목 추가 안건화. - 차기 프로젝트 착수 시 `setup_*` 스크립트 호출만으로 `.live/` + `memory/org/` 양체계 즉시 재사용 +### C34-15. 신규 조직 설정·저장소 설계 시 worktree 경계 체크 의무 (2026-04-18 PD님 "유사 사례 재발 방지" 지시 수용) + +조직에 **새로운 설정 파일·공유 저장소·hook·스크립트**를 도입할 때 반드시 `memory/org/feedback_worktree_isolation.md`의 **5개 질문 체크리스트**를 통과한다. + +- **5개 질문**: (1) PC 단위 vs worktree 단위 판정 · (2) 경계 안전성 · (3) 중앙화 필요성 · (4) 레포 루트 vs worktree 실행 차이 · (5) Agent 경계 보호 (C34-11) +- **미통과 시**: 근원 해결안 포함하여 재설계 후 재상정 +- **감사관 상시 점검**: pm-auditor·dev-auditor·plan-auditor 3종이 규칙·설정·스크립트·기획 자산 변경 시 본 체크리스트 수행 여부를 검증 +- **실증 이력 누적**: `feedback_worktree_isolation.md` 말미 "관련 사건 로그" 표에 신 사건 append하여 패턴 학습 +- **근거 사건**: 2026-04-18 단일 세션 내 4건 연속 실증 (`.live/` 격리 · Agent 절대 경로 유출 · memory junction 레포 루트 타깃 · paths.local.json worktree 누락) → PD님 "유사 사례 재발되지 않도록 교훈으로" 직접 지시 + +### C34-16. memory junction 특수 조항 (2026-04-19 신설) + +`.live/`와 달리 `memory/org/`는 **git 추적 SOT**이므로 다음 특수 의무를 가진다. + +1. **레포 `memory/org/` 실체 디렉토리 유지 의무** — 어떤 경우에도 junction/symlink로 전환 금지. PC clone 직후·setup 실행 전에도 `memory/org/` 접근 가능해야 함 (개발자·감사관 직접 Read 보장) +2. **sync 방향 규약** — 기본 SOT는 **레포 `memory/org/`**. 중앙 `$HOME/.claude/nerdnavis-memory/`는 Claude user memory 실시간 공유를 위한 **미러**이지 정본이 아님 +3. **Write 경로 선택 의무 (신규, C34-11 확장)** — Write 도구로 memory 파일 기록 시 다음 중 택1: + - (우선) **본 worktree 절대 경로 직접 지정** (예: `E:\NerdNavisAi\.claude\worktrees\\memory\org\...`) — junction 경유 회피, 본 worktree git status 즉시 반영 + - (대체) `$HOME/.claude/projects/*/memory/...` — junction 경유로 중앙에 기록, 이후 post-commit hook이 레포로 자동 sync + - **혼용 금지** — 같은 세션에서 두 경로 혼용 시 분기 리스크. PM은 전 세션 단일 경로 유지 +4. **마이그레이션 시 3층 백업 의무** — 레포 루트·worktree들·junction 타깃 3축 백업 후에만 중앙화 전환 (C6-1 원본 보호) +5. **정(正) 판정 규칙 A·B·C** — 초기 마이그레이션·충돌 시 (A) worktree에만 있는 파일은 worktree본 흡수, (B) 양쪽 내용 상이면 mtime 최신본, (C) junction 부재 해시 폴더의 일반 디렉토리 내용은 전수 스캔 후 중앙 흡수 +6. **sync 스크립트 덮어쓰기 보호 의무 (2026-04-19 D안 신설)** — `sync_memory_central_to_repo.sh`는 **레포 mtime이 중앙보다 최신이면 덮어쓰기 스킵 + 경고** 출력. 본 세션 12차 commit(`1b409a0`) 직후 Edit 내용이 post-commit sync로 덮어씌워진 실증(2026-04-19)으로 근거 확립. 반대 방향(`sync_memory_repo_to_central.sh`)은 레포 SOT 정책 유지 + unflushed 중앙 대피 로직 유지. 근거: `memory/org/feedback_memory_sync_overwrite.md` + ### C34-17. audit 자산 특수 조항 (2026-04-20 #48 G 집행 신설) C35 감사 로그 3종(`auditor_calls`·`warning_ignored`·`bypass_log`)은 본래 **PC별 로컬 상태**로 설계되었으나, PD님 2026-04-20 직접 지시 "어떤 PC에서 작업을 하든 항상 일관 된 상태로 업무를 진행할 수 있도록 철저하게 동시화되어야만 해"에 따라 **중앙 통합** 전환. 헌법 제1원칙 ⑤(세션·PC 연속성) 직결. @@ -1970,32 +1994,6 @@ PD님 직접 지시 2종 이행: --- -### C34-16. memory junction 특수 조항 (2026-04-19 신설) - -`.live/`와 달리 `memory/org/`는 **git 추적 SOT**이므로 다음 특수 의무를 가진다. - -1. **레포 `memory/org/` 실체 디렉토리 유지 의무** — 어떤 경우에도 junction/symlink로 전환 금지. PC clone 직후·setup 실행 전에도 `memory/org/` 접근 가능해야 함 (개발자·감사관 직접 Read 보장) -2. **sync 방향 규약** — 기본 SOT는 **레포 `memory/org/`**. 중앙 `$HOME/.claude/nerdnavis-memory/`는 Claude user memory 실시간 공유를 위한 **미러**이지 정본이 아님 -3. **Write 경로 선택 의무 (신규, C34-11 확장)** — Write 도구로 memory 파일 기록 시 다음 중 택1: - - (우선) **본 worktree 절대 경로 직접 지정** (예: `E:\NerdNavisAi\.claude\worktrees\\memory\org\...`) — junction 경유 회피, 본 worktree git status 즉시 반영 - - (대체) `$HOME/.claude/projects/*/memory/...` — junction 경유로 중앙에 기록, 이후 post-commit hook이 레포로 자동 sync - - **혼용 금지** — 같은 세션에서 두 경로 혼용 시 분기 리스크. PM은 전 세션 단일 경로 유지 -4. **마이그레이션 시 3층 백업 의무** — 레포 루트·worktree들·junction 타깃 3축 백업 후에만 중앙화 전환 (C6-1 원본 보호) -5. **정(正) 판정 규칙 A·B·C** — 초기 마이그레이션·충돌 시 (A) worktree에만 있는 파일은 worktree본 흡수, (B) 양쪽 내용 상이면 mtime 최신본, (C) junction 부재 해시 폴더의 일반 디렉토리 내용은 전수 스캔 후 중앙 흡수 -6. **sync 스크립트 덮어쓰기 보호 의무 (2026-04-19 D안 신설)** — `sync_memory_central_to_repo.sh`는 **레포 mtime이 중앙보다 최신이면 덮어쓰기 스킵 + 경고** 출력. 본 세션 12차 commit(`1b409a0`) 직후 Edit 내용이 post-commit sync로 덮어씌워진 실증(2026-04-19)으로 근거 확립. 반대 방향(`sync_memory_repo_to_central.sh`)은 레포 SOT 정책 유지 + unflushed 중앙 대피 로직 유지. 근거: `memory/org/feedback_memory_sync_overwrite.md` - -### C34-15. 신규 조직 설정·저장소 설계 시 worktree 경계 체크 의무 (2026-04-18 PD님 "유사 사례 재발 방지" 지시 수용) - -조직에 **새로운 설정 파일·공유 저장소·hook·스크립트**를 도입할 때 반드시 `memory/org/feedback_worktree_isolation.md`의 **5개 질문 체크리스트**를 통과한다. - -- **5개 질문**: (1) PC 단위 vs worktree 단위 판정 · (2) 경계 안전성 · (3) 중앙화 필요성 · (4) 레포 루트 vs worktree 실행 차이 · (5) Agent 경계 보호 (C34-11) -- **미통과 시**: 근원 해결안 포함하여 재설계 후 재상정 -- **감사관 상시 점검**: pm-auditor·dev-auditor·plan-auditor 3종이 규칙·설정·스크립트·기획 자산 변경 시 본 체크리스트 수행 여부를 검증 -- **실증 이력 누적**: `feedback_worktree_isolation.md` 말미 "관련 사건 로그" 표에 신 사건 append하여 패턴 학습 -- **근거 사건**: 2026-04-18 단일 세션 내 4건 연속 실증 (`.live/` 격리 · Agent 절대 경로 유출 · memory junction 레포 루트 타깃 · paths.local.json worktree 누락) → PD님 "유사 사례 재발되지 않도록 교훈으로" 직접 지시 - ---- - ## C36. PM 자율 판단 범위 상한 — 방향·원칙 수준 축소·희석 금지 (2026-04-20 PD님 직접 지시 신설 — 헌법급) > **PM 자율 판단(C29)은 구현·실무 수준에 한정**한다. 헌법 제1원칙·핵심 규칙(C)·프로젝트 규칙(P)의 방향과 충돌하거나 축소·희석하는 권고·제안·결정은 **PM 재량 금지**. 2026-04-20 #48 G 안건에서 PM이 "검토 착수 + 4문항 실질 필요성 검증 선행" 권고로 헌법 제1원칙 ⑤(세션·PC 연속성)에 역행 축소 해석 시도. PD님 직접 지시 "PM이 자율적 판단으로 코어룰이나 조직 룰에 영향을 주는 결정을 임의대로 변형하지 못하도록 코어룰 및 프로젝트 룰에도 보완점을 찾아서 반영" 수용. `feedback_pm_over_conservative_interpretation.md` 6회차 변종 구조 차단. diff --git a/공유/PD_지시_트래킹/개발팀_PD_지시_로그.md b/공유/PD_지시_트래킹/개발팀_PD_지시_로그.md index 272d9fa..b61381f 100644 --- a/공유/PD_지시_트래킹/개발팀_PD_지시_로그.md +++ b/공유/PD_지시_트래킹/개발팀_PD_지시_로그.md @@ -32,7 +32,7 @@ C3·C13 위반에 해당. **즉시 자진 보고 후 소급 등록**. | # | 일시 | 지시 요지 | 처리 상태 | 산출물 경로 | 중단 사유 | 사후 조치 | |---|------|----------|----------|-----------|----------|----------| | 2 | 2026-04-14 | 서버 Critical 보안 3건 보류 | 보류 | `프로젝트/수상한잡화점/개발/05_서버연동_현황_v1.md` | 서버 파트 정비 미완료 (PD님 지시) | 서버팀 가동 시점에 블로커급 재개. 담당: 서버팀장. 재개 트리거: 서버 파트 정비 완료 통보 | -| 38 | 2026-04-17 | (#28 후속 분리) Phase 3 재개 로드맵 결정 — Unity MCP 단일축 기반 밸런스 작업 재개 범위·선후관계·검증 축 확정 | 보류 | (로드맵 확정 시 기입) | PD님 별도 논의 예정 | 재개 트리거: PD님 Phase 3 재개 지시 수령. 기획팀 #3 동시 재개 | +| 38 | 2026-04-17 | (#28 후속 분리) Phase 3 재개 로드맵 결정 — Unity MCP 단일축 기반 밸런스 작업 재개 범위·선후관계·검증 축 확정 | **진행중** | `프로젝트/수상한잡화점/개발/13_Phase3_재개로드맵_확정_v1.md` + `공유/소통/개발팀→기획팀/2026-04-20_Phase3_재개_로드맵_병렬착수.md` (2026-04-20 로드맵 3요소 확정 + 기획팀 병렬 라인 C·D 착수 전달) | - | 2026-04-20 PD 재개 지시 수령. 과거 HOLD 트리거 사유(Python 시뮬 수치 괴리·Unity MCP 전환 필요)는 **#28·#37 완료로 종결**. 현 진행 블로커 없음. 잔여 선행 조건 2(Unity MCP 실측 검증 리포트)·3(기획팀용 실행 가이드)은 본 로드맵 §6 후속 집행 계획으로 수용 — Unity Editor + MCP 연결 환경 별도 집행 필요 | | 52 | 2026-04-20 | (후속 안건·조직 공통) **C37 집행 §15 후속 — SKILL.md 대규모 블록 이동** — C32·C21 섹션 이동·C34-15·16·17·18 재배치·C31-1 A~I 정렬·C·P 섹션 전수 번호 순 정렬 | 대기 | (집행 시 기입) | - | 재개 트리거: PD님 추가 지시 수령. 각 블록 이동 전 C37-3 참조 무결성 Grep 전수 수행 의무. 대규모라 단계 commit 권장 | > **2026-04-15 오후 추가 갱신 (C4·C13 위반 자진 정정 2차)**: diff --git a/공유/소통/개발팀→기획팀/2026-04-20_Phase3_재개_로드맵_병렬착수.md b/공유/소통/개발팀→기획팀/2026-04-20_Phase3_재개_로드맵_병렬착수.md new file mode 100644 index 0000000..b0b5395 --- /dev/null +++ b/공유/소통/개발팀→기획팀/2026-04-20_Phase3_재개_로드맵_병렬착수.md @@ -0,0 +1,144 @@ +--- +type: 소통 +from: 개발팀장 +to: 기획팀장 +date: 2026-04-20 +subject: Phase 3 재개 로드맵 확정 (#38) + 병렬 착수 가능 작업 전달 +status: 발행 +reference: + - 프로젝트/수상한잡화점/개발/13_Phase3_재개로드맵_확정_v1.md + - 프로젝트/수상한잡화점/기획/Phase3_재개준비_체크리스트_v1.md +--- + +# Phase 3 재개 로드맵 확정 + 병렬 착수 가능 작업 전달 + +## 0. 요지 + +**PD님 재개 지시 수령**(2026-04-20). 개발팀 #38 "Phase 3 재개 로드맵" 3요소(재개 범위·선후관계·검증 축) 확정 완료. **기획팀 #3 보류 해제**하고 **Unity MCP 실행이 불요한 병렬 작업 즉시 착수** 요청. + +> **본 공유에 포함된 병렬 착수 작업은 Unity MCP 실행 불요. 재개 선행 조건 2·3(실측 검증 리포트·실행 가이드) 완결과 무관하게 기획팀 독립 진행 가능.** + +--- + +## 1. 현 상태 (현재형) + +- 외부 블로커: **없음** (PD님 재개 지시 해제) +- 재개 선행 조건 4종 중 1·4 충족, **2·3 미충족** (개발팀 후속 집행 — 기획팀 Day 2~3 착수 전까지만 필요) +- 개발팀 SOT: `프로젝트/수상한잡화점/개발/13_Phase3_재개로드맵_확정_v1.md` + +**과거 HOLD 트리거 사유(Python 시뮬 수치 괴리·Unity MCP 전환 필요)는 #28·#37 완료로 종결**. 본 공유에서 재언급 없음. + +--- + +## 2. 기획팀 즉시 착수 요청 (병렬 라인 C·D) + +### 2-1. Day 1-1 — 재개 즉시 체크 3단계 + §1-1 체크리스트 전수 수행 + +`Phase3_재개준비_체크리스트_v1.md §1-2·§1-1` 그대로: + +1. `공유/조직공지/` 의 🛑·⚠️·🚨 파일 전수 재스캔 +2. CLAUDE.md "🔔 최근 규칙 변경" 섹션 재읽기 (캐시 의존 금지) +3. `.claude/skills/너드나비스-코어룰/SKILL.md` 최신 조항 확인 +4. §1-1 재개 트리거 체크리스트 4종 결과 기획팀 SOT에 기록 + +**산출물**: Day 1 완료 보고 (기획팀장 → 총괄PM) +**Unity MCP 실행**: 불요 +**선행 조건 2·3 의존**: 없음 + +### 2-2. Day 1-4 — 기존 3개 사전 산출물 재독 + 연동 지점 표 + +재독 대상 (기획팀 기존 자산): +- `맵패턴_사전분석_v1.md` +- `밸런싱문서_일관성점검_v1.md` +- `재논의대기_사전자료모음_v1.md` + +연동 지점 표 최종 점검 (`Phase3_재개준비_체크리스트_v1.md §3`). + +**산출물**: 연동 지점 표 최종본 (체크리스트 §3 그대로 반영) +**Unity MCP 실행**: 불요 +**선행 조건 2·3 의존**: 없음 + +### 2-3. 준비 작업 — 재검증 로그 템플릿·산출물 명명 규칙 확정 + +`Phase3_재개준비_체크리스트_v1.md §5` 명명 규칙 그대로: +- `Phase3_성장요소기여도_v2.md` (v1 부재 → v2 신설) +- `재검증보고_Phase0_1_2_v1.md` +- `이슈1_3_통합재논의_v1.md` +- `재검증보고_맵패턴_v1.md` + +재검증 로그 스켈레톤 템플릿 사전 작성 권고 (Day 2~3 착수 시 즉시 채워넣을 수 있도록). + +**산출물**: 로그 템플릿 1종 (기획팀 내부 자산) +**Unity MCP 실행**: 불요 +**선행 조건 2·3 의존**: 없음 + +### 2-4. 3성 조건 12개 상세 명세 v1 연동 (Day 1-4 후속) + +`Phase3_재개준비_체크리스트_v1.md §3-4` 기반으로 개발팀에 조건 판정 로직 구현 REQ 발행 준비. REQ 템플릿: `공유/소통/기획팀→개발팀/REQ-템플릿_밸런스수치.md`. + +**산출물**: REQ 초안 (발행은 개발팀 조건 2·3 완결 후 조율) +**Unity MCP 실행**: 불요 +**선행 조건 2·3 의존**: 없음 + +--- + +## 3. 기획팀 대기 작업 (선행 조건 2·3 완결 후 착수) + +Unity MCP 실행 필요 → 개발팀 조건 2·3 완결 후 순차 진행. + +| 체크리스트 Day | 작업 | 의존 | +|-------------|------|------| +| Day 2~3 | Phase 0~2 재검증 6건 (#1~#6) | 조건 2·3 완결 | +| Day 4~7 | 성장 요소 기여도 6건 (#16~#21) | Day 2~3 완결 | +| Day 8~10 | 이슈 1·3 통합 재논의 | Day 4~7 완결 | +| Day 11~14 | 스테이지 난이도·맵 패턴 재검증 9건 | Day 8~10 완결 | +| Day 15+ | v2 최종 확정 | Day 11~14 완결 | + +--- + +## 4. 개발팀 동시 집행 작업 (병렬 라인 A·B) + +| 라인 | 작업 | 산출물 | +|------|------|-------| +| A | 조건 2 Unity MCP EditMode 실측 검증 리포트 | `공유/소통/개발팀→기획팀/{YYYY-MM-DD}_Unity_MCP_실측검증_리포트_v1.md` | +| B | 조건 3 기획팀용 Unity MCP 시뮬 실행 가이드 | `공유/소통/개발팀→기획팀/{YYYY-MM-DD}_Unity_MCP_시뮬실행_가이드_v1.md` | + +**Unity MCP 접근 환경(Unity Editor + MCP 연결) 필요**. 본 세션 범위 밖 — 실 Unity Editor 가동 환경에서 별도 집행 예정 (C23 정직 고지). 개발팀장·기획팀장 공동 검증 수행 후 본 채널에 산출물 발행. + +--- + +## 5. 검증 축 (Phase 3 v2 수치 채택 기준) + +1. Unity MCP EditMode 실측 = **정본(正)** +2. 오차 허용: Unity 실 빌드 PlayMode vs MCP 시뮬 **10% 이내** +3. 오차 초과: 실 빌드 결과 우선, MCP 시뮬 모델 재조정 +4. 성장 요소 기여도 괴리 ±20% 초과: Day 8~10 이슈 1·3 통합 재논의로 이관 + PD님 판단 요청 + +상세: `13_Phase3_재개로드맵_확정_v1.md §5` + +--- + +## 6. 에스컬레이션 경로 + +| 상황 | 경로 | +|------|------| +| Unity MCP 시뮬 실행 이슈·가이드 불명확 | 기획팀 → 개발팀 클라이언트팀장 (본 채널 회신) | +| 조건 판정 로직 구현 필요 | 기획팀 → 개발팀 클라이언트팀 (REQ 발행) | +| 테이블 변경 요청 (PD 승인 전제) | 기획팀 → 총괄PM → PD님 | +| Phase 3 범위·선후관계·검증 축 재해석 필요 | 기획팀장 → 개발팀장 (본 로드맵 v2로 개정) | + +--- + +## 7. 회신 기대 + +본 공유 수령 후 기획팀장: +1. 기획팀 #3 상태 "보류 → 진행중" 전환 (본 공유에서는 개발팀 세션이 기획팀 로그 갱신 동시 집행) +2. 2-1~2-4 즉시 착수 여부 확인 회신 (`공유/소통/기획팀→개발팀/{YYYY-MM-DD}_Phase3_병렬착수_확인.md`) +3. 조건 2·3 완결 후 Day 2~3 착수 시 개발팀과 세부 조율 + +## 참조 + +- `프로젝트/수상한잡화점/개발/13_Phase3_재개로드맵_확정_v1.md` (개발팀 SOT) +- `프로젝트/수상한잡화점/기획/Phase3_재개준비_체크리스트_v1.md` (기획팀 SOT) +- `프로젝트/수상한잡화점/시뮬레이터/01~04_*.md` (시뮬 인프라) +- `공유/소통/기획팀→개발팀/REQ-템플릿_밸런스수치.md` (REQ 템플릿)