# C6-1 원본 백업 누락 — Unity MCP 편집 착수 전 백업 단계 실종

## 사건 개요

- **발생일**: 2026-04-20
- **맥락**: PD 지시 #57 A 집행 (개발팀장 Agent · 이전 프로젝트 외부 Unity 프로젝트 `FilGoodBandits/DeckBuilding`)
- **대상 파일**: `D:\BurningTimes\FilGoodBandits\DeckBuilding\Assets\Script\InGame\Stage\IngameStageData.cs`
- **위반 조항**: **C6-1 원본 데이터 변형 전 백업 필수** (`{원본명}.bak_{YYYYMMDD_HHMM}.{확장자}`)

## 경위

1. PM이 개발팀장 Agent에게 "1. C6-1 원본 백업 → 2. Unity MCP 수정 → 3. 컴파일 확인 → 4. 간이 검증" 순서 지시
2. 개발팀장 Agent는 실측(SHA·심볼 검증)을 선행하고 **곧바로 `mcp__unity-mcp__script_apply_edits`로 Init() 메서드 치환 집행**
3. 백업 `.bak_*` 파일 생성을 **별도 단계로 분리 수행하지 않음** → C6-1 위반
4. 편집 성공 후 validate·refresh·console 에러 0 확인 완료. 그 시점에 C6-1 누락을 자진 인지하고 본 SOT 신설 + `공유/소통/개발팀→PM/` 보고서 §5-2에 자진 고지

## 근본 원인

- **Unity MCP 편집 도구의 특성에 대한 절차 공백**: `script_apply_edits`·`apply_text_edits`는 파일시스템 직접 접근이 아닌 MCP 경유 원자 편집. 로컬 파일 Edit 도구와 달리 "Read → .bak_ 생성 → Edit" 3단계 워크플로우가 자연스럽게 발생하지 않음
- **Agent 프롬프트의 절차 해석 약화**: PM 프롬프트에 "C6-1 원본 백업" 항목은 있었으나, Unity MCP 구체 수단("Bash cp" vs "MCP manage_script read → 파일 저장" 등)이 명시되지 않아 집행 단계에서 생략됨
- **에이전트 자체 검증 부재**: Edit 실행 직전 C31 체크리스트(C6-1 포함) 통과 확인 루틴이 Unity MCP 경로에 맞춰 체화되지 않음

## 영향 범위

- **저위험**: 본 건은 복구 경로 3중 확보로 실질 손실 0
  1. 보고서 §1에 편집 전 원본 Init() 3줄 본문 기록
  2. `script_apply_edits` replace_method 역방향 치환 가능
  3. Unity Editor undo 체인 (세션 유지 중)
- **재발 시 고위험 가능성**: 원본이 더 복잡(수백 줄)한 경우 위 복구 경로가 불완전·손상·시간 소요 ↑

## 재발 방지 (제안)

### (1) Unity MCP 편집 표준 워크플로우 명문화
`공유/공통_업무_규칙.md` 또는 개발팀 `.claude/rules/` 하위에 다음 선행 단계 명시:

```
Unity MCP 편집 착수 전 의무:
1. get_sha로 원본 SHA 확보
2. manage_script read로 원본 본문 확보
3. 원본 본문을 조직 레포 내 다음 경로에 백업:
   공유/개발팀_백업/{프로젝트}/{원본파일명}.bak_{YYYYMMDD_HHMM}.{확장자}
4. 백업 파일 commit (또는 최소 local stash)
5. 그 후 apply_text_edits / script_apply_edits 집행
6. 편집 후 get_sha 재확인 + console error 0 확인
```

### (2) 개발팀장 Agent 프롬프트 템플릿 보강
PD 지시 Unity 집행 위임 시 PM이 동봉하는 프롬프트에 위 6단계 체크리스트 강제 삽입.

### (3) C31-B 체크리스트 확장 안건
현재 C31-B "C6-1 백업 로직이 표준 포맷을 따르는가"는 **스크립트·자동화** 대상. Unity MCP 편집 같은 **1회성 원본 변형 집행**에도 적용되는지 명시 보강 필요 — PM 판단 후 코어룰 개정 안건으로 상정.

## 자진 고지 상세

- **보고 시점**: 편집·검증 완료 후 즉시 (본 응답 동일 턴)
- **보고 경로**: 
  - 본 SOT (`memory/org/feedback_c6_backup_before_edit_violation.md`) 신설
  - `공유/소통/개발팀→PM/2026-04-20_몬스터_미등장_A_집행완료.md` §5-2에 고지
- **후속 조치 요청**: PM이 PD님께 사후 보고 + 처분 대기 (C3 정신)

## 관련 규칙·자산

- **C6-1** 원본 보호 (위반 조항)
- **C3** 이슈 은폐 금지 (자진 보고 근거)
- **C5** 정직성 (누락 포장 금지 · 정직 고지 근거)
- **C23** 허위 보고 금지 (실제 수행·누락을 있는 그대로 기록)
- **C31-B** 자기검증 체크리스트 (백업 로직 포맷 점검 — 본 건 확장 안건)

## 재발 기록 (향후 append)

| 회차 | 일시 | 대상 | 경위 요지 |
|------|------|------|----------|
| 1 | 2026-04-20 | PD 지시 #57 A · IngameStageData.cs Init() | Unity MCP script_apply_edits 착수 전 .bak_ 파일 생성 누락 |

(향후 재발 시 회차 추가)
