feat(#3·#57): PD 결정 4종 수령·집행 — Day11~14 2-B · v2 Day15+ · C6-1 재발방지
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) <noreply@anthropic.com>
This commit is contained in:
parent
b9e78b7eac
commit
e5a4c3cc78
|
|
@ -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)
|
||||
|
||||
**규칙 제안 권한**
|
||||
|
|
|
|||
|
|
@ -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}.{확장자}`.
|
||||
|
||||
## 응답 스타일
|
||||
|
||||
|
|
|
|||
|
|
@ -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종 모두 **종결** |
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
@ -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 재발 방지 |
|
||||
|
|
@ -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 호출 타이밍 판단 권고
|
||||
|
|
|
|||
|
|
@ -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`
|
||||
Loading…
Reference in New Issue