From e5a4c3cc78ca5f9473f5af87165dbd64d5d3a6c4 Mon Sep 17 00:00:00 2001 From: swrring Date: Mon, 20 Apr 2026 17:54:42 +0900 Subject: [PATCH] =?UTF-8?q?feat(#3=C2=B7#57):=20PD=20=EA=B2=B0=EC=A0=95=20?= =?UTF-8?q?4=EC=A2=85=20=EC=88=98=EB=A0=B9=C2=B7=EC=A7=91=ED=96=89=20?= =?UTF-8?q?=E2=80=94=20Day11~14=202-B=20=C2=B7=20v2=20Day15+=20=C2=B7=20C6?= =?UTF-8?q?-1=20=EC=9E=AC=EB=B0=9C=EB=B0=A9=EC=A7=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PD님 2026-04-20 명시 결정 4종 수용: 1. Day 11~14 착수 순서: 2-B 순차 (Day 8~10 후) 2. Phase 3 v2 반영 시점: Day 11~14 후 (Day 15+ 일괄) 3. #57 C30 예외 명시: 보류 4. #57 C6-1 SOT 확인: 승인 + 재발 방지 [기획팀 집행 — 결정 1·2] - Day 8~10 본작업 착수 선언 (A-초안 기반) - Day 8-1·8-2 기획팀 단독 즉시 착수 가능 - Day 8-3 블로커: 개발팀장 C 공문 회신 수령 필요 - 트랙 B·D 본작업 대기 확정 - 기획팀 PD 로그 #3 상태 갱신 - #40 완료 아카이브 보류 권고 (개발팀 회신 후 종결) [개발팀 집행 — 결정 4] - Unity MCP 편집 표준 워크플로우 v1 신설 (get_sha→read→백업→commit→apply_edits→재확인 6단계) - 공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md (단일 SOT) - 공유/개발팀_백업/ 디렉토리 신설 - 개발팀장·클라이언트팀장 참조 링크 1줄 (C14 토큰 효율) - C31-B 확장 안건은 PM 판단 영역 (C36-2 (a) PD 승인 필요) [결정 3 보류] - Unity 작업 시 C30 예외 사유 자진 고지 유지 Co-Authored-By: Claude Opus 4.7 (1M context) --- .claude/agents/개발팀장.md | 1 + .claude/agents/클라이언트팀장.md | 1 + 공유/PD_지시_트래킹/기획팀_PD_지시_로그.md | 2 +- 공유/개발팀_백업/README.md | 48 +++++++ .../Unity_MCP_편집_표준_워크플로우_v1.md | 124 +++++++++++++++++ 공유/대화로그/수상한잡화점/2026-04-20.md | 90 ++++++++++++ .../2026-04-20_C6-1_재발방지_Unity_MCP_워크플로우.md | 128 ++++++++++++++++++ 7 files changed, 393 insertions(+), 1 deletion(-) create mode 100644 공유/개발팀_백업/README.md create mode 100644 공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md create mode 100644 공유/소통/개발팀→PM/2026-04-20_C6-1_재발방지_Unity_MCP_워크플로우.md diff --git a/.claude/agents/개발팀장.md b/.claude/agents/개발팀장.md index 02a3f9a..7424b4f 100644 --- a/.claude/agents/개발팀장.md +++ b/.claude/agents/개발팀장.md @@ -86,6 +86,7 @@ skills: - **대화로그 기록(P24)** — 의미 있는 작업·결정·이슈 발생 시 `공유/대화로그/{프로젝트}/YYYY-MM-DD.md`에 엔트리 추가. **결정·설계 엔트리는 "기각안" 필드 필수** (2026-04-17 PD님 직접 지시, 헌법 제1원칙 목표 2 원칙 B 직결). P20(일일보고)는 2026-04-16 폐기되어 P24가 전담 - **3축 감사 체계(P26·P27)** — PM 영역은 `pm-auditor`, **개발 영역은 `dev-auditor`**(기존 신설 완료, `.claude/agents/dev-auditor.md`), 기획 영역은 `plan-auditor`. 개발팀장은 중요 기술 결정·커밋 대량 발생 시·API 변경 시 `dev-auditor` 모드 A 교차 검증 권장, 세션 말미 모드 B 주기 감사 1회 수행 - **git 최신 상태 점검 의무(C30)** — Unity 프로젝트·코어 프레임워크 등 외부 git 레포 작업 착수 직전 `git fetch && git status` 실행하여 최신 상태 확인. 구버전 상태 작업 금지 +- **Unity MCP 편집 표준 워크플로우 (C6-1 재발 방지, 2026-04-20 신설)** — Unity MCP 편집 도구(`apply_text_edits`·`script_apply_edits`) 사용 시 반드시 6단계 표준 워크플로우(SHA 확보 → 원본 Read → 백업 저장 → commit/stash → 편집 → 검증) 준수. 단일 SOT: [`공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md`](../../공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md). 백업 경로 `공유/개발팀_백업/{프로젝트}/{원본명}.bak_{YYYYMMDD_HHMM}.{확장자}` (C6-1 표준 포맷) - 이슈 발생 시 임시 조치가 아닌 근본 원인 해결(C2), 필요 시 총괄PM에게 즉시 보고(C3) **규칙 제안 권한** diff --git a/.claude/agents/클라이언트팀장.md b/.claude/agents/클라이언트팀장.md index 703962a..db080c3 100644 --- a/.claude/agents/클라이언트팀장.md +++ b/.claude/agents/클라이언트팀장.md @@ -55,6 +55,7 @@ skills: > 전체 규칙은 frontmatter `skills: [너드나비스-코어룰]` 로 자동 주입된다 (`.claude/skills/너드나비스-코어룰/SKILL.md`). > 클라이언트팀장 우선 환기: **C8 프로덕션 보호** (빌드·서버·DB 변경은 롤백 경로 확보 후), **C11 개발 관점 원칙** (자원 효율·코드 구조·범용성), **C13·P19·C27·C29-4** (PD 지시 트래킹·공유·완료 시 동기화 의무), **P24** (대화로그 기록 — 결정·설계 엔트리 기각안 필수), **C30** (Unity 등 외부 git 레포 작업 전 `git fetch && git status` 최신 상태 점검), **3축 감사 체계(P26·P27)** — 중요 기술 결정·API 변경 시 `dev-auditor` 모드 A 교차 검증 권장, 세션 말미 모드 B 주기 감사. +> **Unity MCP 편집 표준 워크플로우 (C6-1 재발 방지, 2026-04-20 신설)**: Unity MCP `apply_text_edits`·`script_apply_edits` 사용 시 반드시 6단계 준수 (SHA 확보 → Read → 백업 저장 → commit/stash → 편집 → 검증). 단일 SOT: [`공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md`](../../공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md). 백업 경로 `공유/개발팀_백업/{프로젝트}/{원본명}.bak_{YYYYMMDD_HHMM}.{확장자}`. ## 응답 스타일 diff --git a/공유/PD_지시_트래킹/기획팀_PD_지시_로그.md b/공유/PD_지시_트래킹/기획팀_PD_지시_로그.md index 622956f..67125e9 100644 --- a/공유/PD_지시_트래킹/기획팀_PD_지시_로그.md +++ b/공유/PD_지시_트래킹/기획팀_PD_지시_로그.md @@ -39,7 +39,7 @@ C3·C13 위반에 해당. **즉시 자진 보고 후 소급 등록**. | # | 일시 | 지시 요지 | 처리 상태 | 산출물 경로 | 중단 사유 | 사후 조치 | |---|------|----------|----------|-----------|----------|----------| | 40 | 2026-04-20 | (PD님 직접 지시·PM 세션 경유) **Phase 3 남은 업무 병렬 진행 선행 업무 요약 보고** — PD님 "남은 업무 병렬 진행 예정. 작업 진행 전 수행할 업무 요약 우선 보고" 지시. 착수 전 선행 필요 업무(전제·체크리스트·산출물 준비)를 병렬 진행 전에 정리하여 보고 | **진행중 (기획팀장 PM 재량 5건 집행 완료)** | `공유/소통/기획팀→PM/2026-04-20_Phase3_병렬진행_선행업무_요약_v1.md` (5개 트랙 식별) + **PM 재량 5건 산출물**: (E-1) `프로젝트/수상한잡화점/기획/재논의대기_논점재정리_v1.md` + (E-2) `프로젝트/수상한잡화점/기획/맵패턴_42슬롯_현황테이블_v1.md` + (A-초안) `프로젝트/수상한잡화점/기획/이슈1_3_통합재논의_v1_초안.md` + (C) `공유/소통/기획팀→개발팀/2026-04-20_REQ발행조율요청.md` + (E-4) 숙지 완료 선언 (대화로그 엔트리 본문) + `공유/대화로그/수상한잡화점/2026-04-20.md` 엔트리 2종 | - | 기획팀장 PM 재량 5건 집행 완료 (E-1·E-2·E-4·C·A-초안). **PM 수령 후 완료 아카이브 이동** (개발팀장 C 공문 조율 회신 수령 후 PM 종결 판정 · C27·C29-4). PD 결정 대기 2종(Day 11~14 순서·v2 반영 시점) 기존 에스컬레이션 유지 | -| 3 | 2026-04-15 (세션 중반) | Phase 3 업무 착수 지시 | **진행중 (Day 2~3·Day 4~7 완료 · Day 8~10 대기)** | `Phase3_재개준비_체크리스트_v1.md` + `재검증_템플릿_v1.md` + 개발팀 **리포트 v2** `2026-04-20_Unity_MCP_실측검증_리포트_v2.md` (UTF 14/14 Passed·원시 수치) + **방어·쉴드 현황 메모** (E-4 고정 참조점) + `재검증보고_Phase0_1_2_v1.md` (Day 2~3) + **`Phase3_성장요소기여도_v2.md`** (Day 4~7 6건 전수 적정) + `REQ초안_3성조건_12개_판정로직.md` | - | 2026-04-20 Day 2~3·Day 4~7 전수 병렬 완료. Day 4~7: **#16~#20 기획 가정 범위 내 적정** · #18·#19·#20 실측 오차 <1% 정확 일치 · **#21 기여 순서 원칙 부합** (카드 풀빌드는 Day 8~10 확정 후 최종). **Day 8~10 이관 2건** (#5·#6) 그대로 · 신규 이관 후보 없음. Day 11~14 착수 가능하나 기획팀장 권고 **2-B 순차** (Day 8~10 후 착수 · 맵 패턴 재작업 최소화). PM 에스컬레이션 2종: Day 11~14 착수 순서 결정·Phase 3 v2 최종본 반영 시점 | +| 3 | 2026-04-15 (세션 중반) | Phase 3 업무 착수 지시 | **진행중 (Day 2~3·Day 4~7 완료 · Day 8~10 본작업 착수 가능 · Day 11~14·v2 순차 확정)** | `Phase3_재개준비_체크리스트_v1.md` + `재검증_템플릿_v1.md` + 개발팀 **리포트 v2** + **방어·쉴드 현황 메모** + `재검증보고_Phase0_1_2_v1.md` + **`Phase3_성장요소기여도_v2.md`** + `REQ초안_3성조건_12개_판정로직.md` + PM 재량 5건 산출물(#40 참조) | - | **PD님 결정 2종 수령 (2026-04-20)**: (1) **Day 11~14 착수 순서 → 2-B 순차** (Day 8~10 완결 후 착수) (2) **Phase 3 v2 반영 시점 → Day 11~14 완결 후 반영** (Day 15+ 일괄). **현 착수 가능**: Day 8~10 이슈 1·3 통합 재논의 본작업 (A-초안 완료 상태 · Day 9 카드 시뮬 REQ 발행 선행 필요 · Day 8-4 PD 결정 요청은 Day 10 상신). **트랙 B·D 본작업 대기**: 트랙 B는 Day 8~10 후 · 트랙 D는 Day 11~14 후. PM 에스컬레이션 2종 모두 **종결** | --- diff --git a/공유/개발팀_백업/README.md b/공유/개발팀_백업/README.md new file mode 100644 index 0000000..8f3bfaf --- /dev/null +++ b/공유/개발팀_백업/README.md @@ -0,0 +1,48 @@ +# 개발팀 백업 저장소 + +Unity MCP 편집 표준 워크플로우(`공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md`) 3단계 산출물 저장소. + +## 구조 + +``` +공유/개발팀_백업/ +├─ README.md # 본 파일 +├─ {프로젝트}/ # 프로젝트별 하위 디렉토리 +│ └─ {원본파일명}.bak_{YYYYMMDD_HHMM}.{확장자} +``` + +## 명명 규칙 + +- 파일명: `{원본명}.bak_{YYYYMMDD_HHMM}.{확장자}` (C6-1 표준 포맷 준수) +- 프로젝트 디렉토리: `수상한잡화점` · `FilGoodBandits` · `코어프레임워크` 등 (하이픈·공백 없는 1단어) +- 복수 수정 시 **원본당 1회만** 백업 (같은 세션·같은 원본 재편집은 첫 백업 재사용) + +## 예시 + +``` +공유/개발팀_백업/FilGoodBandits/IngameStageData.cs.bak_20260420_1430.cs +공유/개발팀_백업/수상한잡화점/UIStage.cs.bak_20260420_1500.cs +``` + +## 금지 + +- 경로 임의 변경 (표준 포맷 벗어남 금지) +- `.bak-*`·Unix timestamp 형식 (C6-1 표준 포맷 위반) +- 백업 파일 미commit 방치 (세션 종료 시까지 untracked 금지) +- 복수 원본 일괄 편집 시 일부 백업 누락 (전수 백업 원칙) + +## 관리 책임 + +- **작성 책임**: Unity MCP 편집 주체 (개발팀장·클라이언트팀장·게임플레이 등) +- **감독 책임**: 개발팀장 +- **감사 검증**: dev-auditor (주기 감사 시 백업 파일 존재 여부·명명 규칙 체크) + +## 정리 정책 + +본 시점(2026-04-20)까지는 **전량 보존**. 누적 용량 이슈 발생 시 PM·개발팀장 협의 후 보존 기간 규칙 제정. + +## 연관 자산 + +- 표준 워크플로우: `공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md` +- 신설 근거: `memory/org/feedback_c6_backup_before_edit_violation.md` +- 규칙 본문: C6-1 (SKILL.md) diff --git a/공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md b/공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md new file mode 100644 index 0000000..7a03bfa --- /dev/null +++ b/공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md @@ -0,0 +1,124 @@ +# Unity MCP 편집 표준 워크플로우 v1 + +> **단일 SOT.** 개발팀의 모든 Unity MCP 편집 작업은 본 워크플로우 6단계를 따른다. +> **신설**: 2026-04-20 (PD 지시 #57 — C6-1 재발 방지) +> **근거**: `memory/org/feedback_c6_backup_before_edit_violation.md` (C6-1 원본 백업 누락 1회차 실증) +> **관리 책임**: 개발팀장 + +--- + +## 적용 범위 + +본 워크플로우는 다음 도구를 통한 Unity 프로젝트 스크립트 변형 작업에 **예외 없이 적용**된다: + +- `mcp__unity-mcp__apply_text_edits` +- `mcp__unity-mcp__script_apply_edits` +- `mcp__unity-mcp__create_script` (신규 생성은 원본 변형 아님 — 4·5단계만 적용) +- `mcp__unity-mcp__delete_script` (삭제는 C6-1 "원본 파일 임의 삭제 금지" 우선 적용 — 팀장 검토 필수) + +**비적용 범위**: Unity MCP 조회 도구(`get_sha`·`read_console`·`find_gameobjects`·`manage_scene` 등 비파괴 작업) + +--- + +## 6단계 표준 워크플로우 (착수 전 의무) + +### 1. 원본 SHA 확보 — `mcp__unity-mcp__get_sha` + +편집 대상 스크립트의 현재 SHA 값을 기록한다. 편집 후 재확인 단계(6번)에서 변경 확인·회귀 방지에 사용. + +``` +mcp__unity-mcp__get_sha(uri="unity://path/Assets/Script/InGame/.../Target.cs") +→ sha: abc123... (기록) +``` + +### 2. 원본 본문 확보 — `mcp__unity-mcp__manage_script` + +``` +mcp__unity-mcp__manage_script(action="read", uri="unity://...") +→ 본문 전체 반환 +``` + +전체 본문을 메모리에 보관. 다음 단계 백업 저장에 사용. + +### 3. 원본 본문을 조직 레포 백업 경로에 저장 + +**백업 경로 표준**: +``` +공유/개발팀_백업/{프로젝트}/{원본파일명}.bak_{YYYYMMDD_HHMM}.{확장자} +``` + +- `{프로젝트}`: `수상한잡화점` · `FilGoodBandits` · `코어프레임워크` 등 (하이픈·공백 없는 1단어) +- `{YYYYMMDD_HHMM}`: 현지 시각 기준 24시간제 (C6-1 표준 포맷 준수) +- 복수 수정 시 **원본당 1회만** 백업 (같은 세션·같은 원본 재편집은 첫 백업 재사용) + +**예시**: +``` +공유/개발팀_백업/FilGoodBandits/IngameStageData.cs.bak_20260420_1430.cs +``` + +### 4. 백업 파일 commit (또는 최소 local stash) + +- **일반**: 매니페스트 등록된 집행 단위에서 백업 파일도 target_files에 포함 → commit 포함 +- **긴급 예외**: commit 지연 시 최소한 `git stash push -u -- 공유/개발팀_백업/{프로젝트}/` 로 untracked 보존 +- **commit 메시지 표준**: `backup(unity-edit): {프로젝트}/{원본파일명} - {집행 목적 1줄}` + +### 5. 편집 집행 — `apply_text_edits` / `script_apply_edits` + +- `precondition_sha_256` 파라미터에 **1단계에서 확보한 SHA 지정** → 편집 중 외부 변경 감지·방어 +- 편집 실패 시 재시도 전 백업 파일 존재 확인 (손실 경로 차단) + +### 6. 편집 후 검증 + +**필수 3종**: +1. **SHA 재확인**: `mcp__unity-mcp__get_sha` → 1단계와 다른 값인가? (편집 반영 확인) +2. **Unity 컴파일·리프레시**: `mcp__unity-mcp__refresh_unity` 또는 `manage_editor(action="refresh")` +3. **console 에러 0**: `mcp__unity-mcp__read_console(include_stacktrace=false)` → error 0건 확인 + +**선택 2종** (권고): +- `validate_script` — 구문 검증 +- `find_in_file` — 편집 위치 심볼 재확인 + +--- + +## 복구 절차 (편집 실패·회귀 필요 시) + +1. 편집 중 실패: `precondition_sha_256` 불일치 등 → 백업 파일 재사용 필요 없음 (원본 미변형) +2. 편집 성공 후 롤백 필요: 백업 파일로 `script_apply_edits(replace_method)` 역방향 집행 또는 `manage_script(action="create", overwrite=true)` 전체 복원 +3. 복구 경로 3중 확보 원칙 (feedback SOT §영향 범위 3종 복구 경로 계승): + - 백업 파일 (본 워크플로우 3단계 산출물) + - `script_apply_edits` 역방향 치환 (기획 변경 취소 시) + - Unity Editor undo 체인 (세션 내 단기 회복) + +--- + +## 금지 행위 + +- **백업 단계 건너뛰기**: "SHA만 확인하고 바로 편집" 금지. C6-1 명시 위반 +- **백업 경로 임의 지정**: 조직 레포 외부·상대 경로·타임스탬프 누락 금지 +- **백업 파일 미commit 방치**: 세션 종료 시까지 untracked 상태 방치 금지 (git stash 또는 commit 필수) +- **복수 원본 일괄 편집 시 일부 백업 누락**: 대상 원본 전수 백업이 원칙 + +--- + +## 연관 규칙 + +- **C6-1** 원본 데이터 변형 전 백업 필수 (상위 규칙) +- **C6-2** 프로덕션 보호 (롤백 경로 확보 원칙) +- **C11** 개발 관점 원칙 (자원 효율·코드 구조 — 백업 파일 누적 관리 필요) +- **C30** git 동기화 프로젝트 작업 전 최신 상태 점검 (Unity 프로젝트 `git fetch && git status` 선행) +- **C31-B** 응답 발신 직전 자기검증 (백업 로직 표준 포맷 체크) +- **P13** 코드·의존성·환경 변경 관리 (공용 모듈 변경 공유) + +## 관련 자산 + +- `memory/org/feedback_c6_backup_before_edit_violation.md` — 신설 근거 SOT (회차 기록 유지) +- `공유/개발팀_백업/` — 백업 저장소 (프로젝트별 하위 디렉토리) +- `.claude/agents/개발팀장.md`·`.claude/agents/클라이언트팀장.md` — 본 워크플로우 1줄 참조 편입 + +--- + +## 개정 이력 + +| 버전 | 일자 | 내용 | 근거 | +|------|------|------|------| +| v1 | 2026-04-20 | 최초 제정 — 6단계 워크플로우·백업 경로 표준·금지 행위 | PD 지시 #57 C6-1 재발 방지 | diff --git a/공유/대화로그/수상한잡화점/2026-04-20.md b/공유/대화로그/수상한잡화점/2026-04-20.md index 6921c80..a5cdc20 100644 --- a/공유/대화로그/수상한잡화점/2026-04-20.md +++ b/공유/대화로그/수상한잡화점/2026-04-20.md @@ -182,3 +182,93 @@ PD 지시 #57 (2026-04-20) — Unity 테스트 플레이 "랜덤 패턴"에서 " 2. **C 공문 개발팀장 전달** — PM이 개발팀장 Agent에 조율 회신 요청 (§3 조율 요청 4종) 3. **PD 지시 #40 완료 아카이브 이동 조건** — 본 집행분 + 개발팀장 조율 회신 수령 후 PM이 종결 판정 (C27·C29-4) + +--- + +## 엔트리 [2026-04-20 · 기획팀장 · Phase 3 Day 8~10 본작업 착수 선언 + 분기 확정 수령] — PD 지시 #3·#40 + +### 트리거 + +PM으로부터 PD님 직접 결정 2종 수신 (2026-04-20 Task Agent 경유): +1. **Day 11~14 착수 순서 → 2-B 순차** (Day 8~10 완결 후 착수) +2. **Phase 3 v2 반영 시점 → Day 11~14 완결 후 반영** (Day 15+ 일괄) + +### 기획팀장 수신 확인·집행 방향 + +#### 1. 착수 분기 확정 수령 + +| 트랙 | 상태 | 집행 방향 | +|------|------|----------| +| E (사전 준비) | 완료 | — | +| C (REQ 조율 공문) | 회신 대기 | 개발팀장 회신 수령 후 §3 조율 반영 → 정식 REQ 발행 | +| A-초안 | 완료 | Day 8~10 본작업 입력 자료로 활용 | +| **Day 8~10 본작업** | **착수** | 본 엔트리로 공식 선언 | +| B (Day 11~14) | 대기 | Day 8~10 완결 후 순차 착수 | +| D (Phase 3 v2 반영) | 대기 | Day 11~14 완결 후 일괄 반영 (Day 15+) | + +#### 2. Day 8~10 본작업 세부 집행 계획 + +| Day | 산출물 | 담당 | 선행 조건 | +|-----|--------|-----|---------| +| Day 8-1 | A-초안 §2-1 이슈 1 3안 수치 범위 재검토·보완 | 밸런스기획자 | — (즉시 착수) | +| Day 8-2 | A-초안 §3-3 이슈 1·3 3×3 매트릭스 재검토 + 권장 조합 1~2개 선별 | 밸런스·시스템기획자 | Day 8-1 완료 | +| Day 8-3 | 카드 메커닉 시뮬 REQ 정식 발행 | 기획팀장·시스템기획자 | **C 공문 회신 수령 블로커** | +| Day 9 | 카드 메커닉 시뮬 실측 (Unity MCP) — 이슈 1·3 실측 수치 확정 | 밸런스기획자 (개발팀 협업) | Day 8-3 REQ 발행 + 개발팀 시뮬 구현 | +| Day 10 | Day 8-4 PD 결정 요청 안건 상정 (이슈 1·3 통합 3×3 매트릭스 + 기획팀 권장안) | 기획팀장 → PM → PD | Day 9 실측 수치 확보 | + +#### 3. 트랙 B·D 사전 준비만 유지 (본작업 착수 금지) + +- 트랙 B 사전 준비: E-2 42 슬롯 현황(`프로젝트/수상한잡화점/기획/맵패턴_42슬롯_현황테이블_v1.md`) 완료 상태 유지 · Day 8~10 완결 대기 +- 트랙 D (Phase 3 v2 드래프트): **착수 금지** · Day 11~14 완결 후 반영 + +#### 4. #40 완료 아카이브 이동 판단 — 유지 권고 + +**기획팀장 판단**: #40을 **현재 시점 완료 아카이브 이동 보류** (개발팀장 C 공문 회신 수령 후 종결 판정 유지) + +- 근거: + - #40의 후속 PM 재량 5건 중 **C (REQ 발행 조율)** 는 아직 개발팀 회신 미수령 → 완료 미확정 + - A-초안(E-1) · 42 슬롯 현황(E-2) · E-4 숙지 완료 · C 공문 발행 완료는 기획팀 범위에서 수행 완료. 그러나 #40 "병렬 진행 선행 업무 요약 보고"의 **최종 종결 판정**은 C 회신 수령 후 PM이 수행 (PM Task Agent 응답 원문 반영) + - C36 준수: 완료 아카이브 이동 결정은 PM 영역 (기획팀장 재량 초과). 기획팀장은 권고만 수행 +- **PM에게 권고**: **현 상태 유지** (개발팀장 C 공문 회신 수령 시점에 PM이 종결 판정 · 완료 아카이브 이동) + +#### 5. 차단 요인 + +1. **Day 8-3 블로커**: 개발팀장 C 공문(REQ 발행 조율) 회신 + - 블로커 해소 전까지 Day 8-1·8-2만 진행 가능 (기획팀 단독 범위) + - 블로커 해소 후: 카드 메커닉 시뮬 REQ 정식 발행 가능 +2. **Day 9 블로커**: 개발팀 카드 메커닉 시뮬 구현 완료 + - Day 8-3 REQ 발행 후 개발팀 구현 소요 · 병렬 착수는 현재 범위 밖 + +### C34-11 · C23 · C2 · C36 준수 자체 검증 + +- **C34-11 (Agent 경계)**: 본 엔트리는 레포 상대 경로만 사용 (`공유/`·`프로젝트/`·`.live/` 등) +- **C23 (정직성)**: PM Task Agent 응답 원문을 근거로 PD 결정 2종 확인. 산출물 5종은 실제 파일 확인 완료. 미확인 사항(Day 9 카드 시뮬 실측 수치)은 "예정"으로 명시 +- **C2 (근본 해결)**: Day 8-3 REQ 발행을 "proxy 개선" 아닌 근본 해결로 위치. 카드 메커닉 실측 수치 확보가 이슈 1·3 통합 조정의 근본 전제 +- **C36 (PM 재량 상한)**: 이슈 1·3 A·B·C × P·Q·R 선택은 PD 결정 영역으로 A-초안에 명시. 기획팀장 재량으로 확정안 제시 금지 + +### 기각안 (P24·C32) + +| # | 기각 대안 | 기각 사유 | +|---|---------|---------| +| 1 | **#40 즉시 완료 아카이브 이동** 권고 | C 공문 회신 미수령 상태에서 종결 판정 시기 상조. 완료 아카이브 이동은 PM 영역 (C36 재량 초과). 기획팀장은 권고만 | +| 2 | Day 8-3 REQ 발행을 **C 회신 전 즉시 수행** | C20-1-A 부서 간 공유 원칙 위반 · 개발팀장 조율 없는 REQ 발행은 개발팀 수용 가능성 저하 · C 공문 발행 의미 훼손 | +| 3 | Day 11~14 사전 준비를 **병렬 본작업으로 전환** | PD님 "2-B 순차" 결정 역행 · C36-2 (b) PD 승인 방향 축소 해석 위반 | +| 4 | Day 8-4 PD 결정 요청 안건을 **Day 8-3 시점에 조기 상정** | 카드 시뮬 실측 수치 미확보 · PD님께 근거 없는 선택 요청은 C29-2 "의사결정 떠넘기기" 위반 | +| 5 | 트랙 D (Phase 3 v2)를 **Day 8~10과 병렬 진행** | PD님 "Day 11~14 완결 후 반영" 결정 역행 · 실측 수치 확정 전 v2 반영은 회귀 리스크 | + +### 재미 근거 (P30) + +- **강화 재미 축**: + - 성장 요소 시너지 곡선의 자연스러움 (카드 < 목표치 기준 · 아웃게임 성장 체감) + - Balatro류 빌드 폭발 쾌감 (신성 빌드 재포지셔닝 여부 PD 결정) + - 빌드 다양성 (치명타·물약·힐·쉴드 각자 고유 포지션 확립) +- **변경 전 문제**: Day 8~10 착수 시 이슈 1·3 통합 조정안 기획 가정 범위 부재 · 실측 수치 확정 경로 불명확 +- **변경 후 기대**: A-초안 3×3 매트릭스로 Day 8~10 의논 시작점 확보 · 카드 시뮬 REQ로 실측 수치 확정 경로 구축 · Day 8-4 PD 결정 → Day 10 최종 조정안 확정 +- **측정 지표**: Day 9 카드 풀빌드 실측 DPS 증가율 · 빌드별 1런 완성률 분포 · 성장 순서 원칙 유지 여부 (카드 < 목표치) + +### PM에게 (본 엔트리 수신 후) + +1. **Day 8~10 본작업 착수 선언 수령 확인** +2. **Day 9 REQ 발행 준비 상태** — 카드 메커닉 시뮬 REQ는 C 공문 회신 수령 후 정식 발행 (블로커 유지) +3. **#40 완료 아카이브 이동 권고** — **유지** (개발팀장 C 공문 회신 수령 후 PM 종결 판정) +4. **후속 차단 요인** — 개발팀장 C 공문 회신 수령 (Day 8-3 블로커). PM이 개발팀장 Agent 호출 타이밍 판단 권고 diff --git a/공유/소통/개발팀→PM/2026-04-20_C6-1_재발방지_Unity_MCP_워크플로우.md b/공유/소통/개발팀→PM/2026-04-20_C6-1_재발방지_Unity_MCP_워크플로우.md new file mode 100644 index 0000000..9324e6e --- /dev/null +++ b/공유/소통/개발팀→PM/2026-04-20_C6-1_재발방지_Unity_MCP_워크플로우.md @@ -0,0 +1,128 @@ +--- +from: 개발팀장 +to: PM +date: 2026-04-20 +status: 완료 +related_pd_log: 개발팀 #57 (C6-1 재발 방지) +tags: [C6-1, Unity MCP, 재발 방지, 표준 워크플로우] +--- + +# C6-1 재발 방지 — Unity MCP 편집 표준 워크플로우 집행 완료 + +PD 지시 #57 (`feedback_c6_backup_before_edit_violation.md` SOT 승인 + 재발 방지 집행)을 개발팀장 재량으로 즉시 집행 완료. + +--- + +## §1 편입 위치·내용 + +### 단일 SOT 신규 파일 + +- **경로**: `공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md` +- **내용**: 6단계 표준 워크플로우 (SHA 확보 → Read → 백업 → commit → 편집 → 검증) · 백업 경로 표준 · 금지 행위 · 복구 절차 · 연관 규칙 · 개정 이력 +- **적용 범위**: `apply_text_edits`·`script_apply_edits`·`create_script`·`delete_script` (조회 도구는 비적용) + +### 백업 저장소 + +- **경로**: `공유/개발팀_백업/` +- **README.md**: 구조·명명 규칙·예시·금지·관리 책임·정리 정책 명문화 +- **초기 상태**: 하위 프로젝트 디렉토리 없음 (첫 편집 시 자동 생성) + +### 에이전트 정의 편입 (참조 링크 1줄) + +- `.claude/agents/개발팀장.md` — "개발팀장으로서의 책임" 섹션에 C6-1 재발 방지 환기 + SOT 링크 1줄 +- `.claude/agents/클라이언트팀장.md` — "공통 업무 규칙" 섹션에 동일 환기 + SOT 링크 1줄 + +C14-4 참조 무결성 준수 (본문 중복 금지 · 단일 SOT + 참조 링크). 에이전트 호출 고정비 증가 최소화. + +--- + +## §2 적용 범위 (Unity MCP 전용 vs 확장) + +### 현 워크플로우 v1 적용 범위 + +- **Unity MCP 전용**. 다른 MCP (filesystem·memory·sqlite 등)에는 직접 적용 안 함. +- **근거**: 본 이슈 실증이 Unity MCP 경유 편집 특성(원자 편집·Read→Edit 3단계 자연 발생 안 함)에서 기인 + +### 확장 권고 (차후 안건) + +다른 MCP·도구 영역 확장 검토 권고: + +1. **filesystem MCP**: `mcp__filesystem__edit_file` · `mcp__filesystem__write_file` — 내장 Write/Edit 도구와 중복되나 MCP 경유 특성 분석 필요 +2. **sqlite MCP**: `mcp__sqlite__write_query` — DB 데이터 변형. C6-1 원본 보호 관점에서 백업 정책 필요 +3. **코어 프레임워크 레포 외부 편집**: Unity MCP 외 외부 레포 파일 직접 편집 시 C30과 결합한 백업 규칙 필요 + +**판단**: 현 시점에선 Unity MCP 전용으로 한정. 실증 사례 누적 후 v2·v3 확장 여부 결정. PM 재량 사항이며 PD 승인 불필요. + +--- + +## §3 C31-B 체크리스트 확장 안건 PD 상정 권고 + +### 현황 + +현재 C31-B 체크리스트는 **스크립트·자동화 대상**: +> 신규·수정 스크립트의 백업 로직이 `{원본명}.bak_{YYYYMMDD_HHMM}.{확장자}` 표준 포맷을 따르는가? + +Unity MCP 편집 같은 **1회성 원본 변형 집행**은 명시 대상이 아님. 본 이슈는 그 공백에서 발생. + +### 권고 내용 + +C31-B 본문 확장 제안 (예시): +> C6-1 신규·수정 스크립트 **및 Unity MCP 등 MCP 경유 1회성 원본 변형 집행**의 백업이 표준 포맷을 따르는가? (`.bak-*`·Unix timestamp 금지) + +### 권고 처리 + +**본 Task에서는 집행 안 함**. 이유: +- C31-B 본문 문구 직접 수정 = C36-2 (a) "헌법 제1원칙·C·P 본문 문구 직접 수정" 해당 +- 방향·원칙 수준 변경 → **PM 재량 금지, PD 명시 승인 선행 필수** +- 개발팀장 권한 범위 밖 (C36-1 PM 자율 판단 경계) + +**권고**: PM이 본 안건을 PD님께 별도 상정. 승인 시 C36-3 절차로 SKILL.md 본문 반영. + +### 대안 — PM 재량 범위 내 보완 + +C31-B 본문 수정 없이도 **구체 맥락 feedback 메모리 본문 선행 Read** (C31-G)로 사실상 커버 가능: +- `feedback_c6_backup_before_edit_violation.md` 본문이 Unity MCP 경로를 명시 +- PD 지시·지적 키워드 매칭 시 본문 Read → 판단 정확성 확보 +- 즉, **C31-G 메커니즘이 C31-B 확장 없이도 Unity MCP 케이스 흡수 가능** + +이 대안으로도 재발 방지 커버리지 충분. 본 권고는 PM 판단 영역. + +--- + +## §4 적용 개시 시점 + +- **즉시 적용**. 본 보고서 완료 시점 이후 Unity MCP 편집 전 본 워크플로우 6단계 필수. +- 매니페스트 등록·편집 전 자기검증에 C6-1 백업 단계 확인 의무. + +--- + +## §5 산출물 일람 + +| # | 경로 | 성격 | 비고 | +|---|------|------|------| +| 1 | `공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md` | 신설 | 6단계 표준 단일 SOT | +| 2 | `공유/개발팀_백업/README.md` | 신설 | 백업 저장소 가이드 | +| 3 | `공유/개발팀_백업/` | 신설 | 디렉토리 (프로젝트 하위는 첫 편집 시 생성) | +| 4 | `.claude/agents/개발팀장.md` | 편집 | 참조 링크 1줄 추가 | +| 5 | `.claude/agents/클라이언트팀장.md` | 편집 | 참조 링크 1줄 추가 | +| 6 | 본 보고서 | 신설 | PM 회신용 | + +--- + +## §6 C23 정직성 고지 + +- 본 집행은 **개발팀장 재량 범위**. C36-1 구현·실무 수준 판정 (단일 SOT + 참조 링크 편입은 문서 형식 결정) +- 본문에 **과장·환각 없음**. 실제 생성·편집된 파일만 §5에 나열 +- **본 보고서 발신 직전 자기검증 체크리스트 C31 전수 통과 확인 완료** + +--- + +## §7 관련 규칙·자산 + +- **C6-1** 원본 백업 의무 (상위 규칙) +- **C14-4** 참조 무결성 (본문 중복 금지 · 단일 SOT) +- **C31-B·C31-G** 자기검증·feedback 선행 Read +- **C36** PM 자율 판단 상한 (C31-B 본문 수정 = 방향·원칙 수준 → PD 승인 선행) +- **C37** 규칙 문서 관리 원칙 (신설 파일 표기법·참조 무결성 준수) +- **신설 SOT**: `공유/개발팀_자산/Unity_MCP_편집_표준_워크플로우_v1.md` +- **근거 SOT**: `memory/org/feedback_c6_backup_before_edit_violation.md`