BurningTimesAi/공유/조직공지/방향전환_히스토리_아카이브.md

317 lines
19 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
type: 방향전환히스토리아카이브
created: 2026-04-18
maintainer: 총괄PM
sot_boundary: 프로젝트 설계 문서·기획 문서의 방향 전환(폐기·개정·용어 변경) 이력 단일 SOT
related: 공유/조직공지/폐기_규칙_아카이브.md (C·P 규칙 전담 / 본 파일은 프로젝트 문서 전담)
rationale: 수정 3대 원칙(2026-04-18 재개정) — "본문은 최신 내용만, 히스토리는 아카이브" 구조의 프로젝트 문서 SOT
---
# 📚 방향전환 히스토리 아카이브 (프로젝트 문서)
> **본 파일의 성격**: 프로젝트 설계 문서·기획 문서가 최신 상태로 유지되는 과정에서 발생한 **방향 전환·용어 변경·경로 이동·폐기 전제** 이력을 집약한 **조직 노하우 SOT**. 본문에는 최신 내용만 남기고 작업 과정 히스토리는 본 아카이브에 축적하여 **차기 프로젝트에서 "왜 이렇게 변경되었는가" 참고 자료**로 활용.
>
> **근거**: 2026-04-18 PD님 직접 지시 — "기본 문서에는 심플하게 최신 내용만, 히스토리는 노하우 축적을 위해 아카이브, 필요 시 참조 가능하도록 코어룰에 반영". 수정 3대 원칙 원칙 1 재개정에 따라 신설.
>
> **읽기 규칙**: 본 파일은 **변동비**. 활성 본문에서 "이 부분이 왜 이렇게 됐지?" 의문 시 Read. 매 턴 자동 로드 아님.
---
## 🏛️ 운영 원칙
### 기록 대상
1. **프로젝트 설계 문서** (`프로젝트/수상한잡화점/개발/`·`기획/`·`시뮬레이터/`·`프로젝트/코어프레임워크/`)의 방향 전환
2. **기획 문서**의 폐기된 전제·구용어·구경로 (원래 본문에 있던 것을 최신화하면서 제거한 내용)
3. **개발 설계 문서**의 폐기된 설계 결정·기각된 대안
### 제외 대상
- 오탈자·문단 재배치 같은 단순 편집
- 코어룰(C·P) 변경 — `폐기_규칙_아카이브.md` 전담
- 수치 튜닝 이력 — 각 문서 내 "변경 이력" 테이블(P16) 전담
### 기록 형식 (건별 필수 6필드)
| 필드 | 설명 |
|------|------|
| **대상 문서** | 방향 전환이 적용된 파일 경로 |
| **전환 일자** | 최신화 집행일 |
| **전환 유형** | 용어 변경 / 경로 이동 / 폐기 전제 제거 / 설계 방향 전환 등 |
| **당시 가정** | 원 본문에 있던 내용 (원문 그대로 인용) |
| **현 방향** | 최신 상태 |
| **근거** | 전환 계기 (PD 지시·커밋 해시·관련 사건) |
### 차기 프로젝트 활용 관점 (헌법 제1원칙 목표 2-B)
- **"왜 버렸나" 우선 기록** — P24 기각안 필수화 정신 계승
- **패턴 추출 가능**하도록 건별 구조화 (단순 diff 아님)
- **방향 전환 사유 명시** — "PD님 지적"·"실측 결과 불일치"·"상위 구조 변경" 등
---
## 📂 전환 이력
### 2026-04-18 ─ Phase 3 재개 선결 체계 최신화
<a id="m1-phase3-checklist"></a>
#### 1. `프로젝트/수상한잡화점/기획/Phase3_재개준비_체크리스트_v1.md` 방향 전환
| 필드 | 내용 |
|------|------|
| **대상 문서** | `프로젝트/수상한잡화점/기획/Phase3_재개준비_체크리스트_v1.md` |
| **전환 일자** | 2026-04-18 |
| **전환 유형** | 조직 명칭·경로·폐기 선결 조건 복합 전환 |
| **근거** | 2026-04-16 조직명 개편·2026-04-17 PD님 Unity MCP 전환 (#28·#37)·2026-04-18 PD님 방향전환 히스토리 아카이브 지시 |
##### 1-A. 조직 명칭 전환
- **당시 가정**: "**기획실**이 30분 내 착수" (L13), "**개발실**에 구현 요청서 전송" (L179) 등 기획실·개발실 용어 31회 사용
- **현 방향**: "**기획팀**"·"**개발팀**" (2026-04-16 단일 세션 전환 커밋 기점 명칭 개편)
- **전환 사유**: 2026-04-16 PD님 직접 지시로 개발실→개발팀·기획실→기획팀 명칭 전환 확정. SKILL.md 최종 수정일 기재
##### 1-B. 경로 문자열 전환
- **당시 가정**: "`공유/개발실→기획실/` 폴더 내 가이드 문서" (L38)
- **현 방향**: "`공유/소통/개발팀→기획팀/` 폴더"
- **전환 사유**: 조직 명칭 개편과 함께 소통 허브 디렉토리 구조 변경
##### 1-C. 폐기 선결 조건 — Headless C# 시뮬 추출
- **당시 가정** (L36):
> "개발실이 Unity 전투 로직을 Headless C# 시뮬로 추출 완료"
> (07_시뮬레이터_이원화_해소_착수계획_v1.md 후속 작업 전제)
- **현 방향**: Unity MCP EditMode + 독립 어셈블리(`Assets/Sim/NerdNavis.Sim.asmdef`) 기반 시뮬 환경
- **전환 사유**: 2026-04-17 PD님 직접 지시 #28로 시뮬 방향 전환. 07 원안은 아카이브 처리됨 (`07_*.md` 상단 배너). Unity MCP가 결정론·유지비·기획팀 접근성 3축 우위로 판정 (`공유/소통/완료/2026-04-17_Unity_MCP_시뮬레이션_기술검토_개발팀.md`)
##### 1-D. 폐기 선결 조건 — Python·C# 시뮬 교차 검증
- **당시 가정** (L37):
> "Python 시뮬 ↔ C# 시뮬 결과 교차 검증 완료"
> (Python `battle_sim.py`·`full_stage_sim.py`·`stage_sim_v2.py` 기반 검증 체계)
- **현 방향**: Unity MCP EditMode 단일축 실측 검증 (#37 Q-P2 정밀 2차 응답서로 실증)
- **전환 사유**: 2026-04-17 Python 시뮬 폐기 사안 확정. 구 기획실 디렉토리 삭제로 소실 + PD님 확인으로 폐기 판정 (재논의 대상 아님). 교차 검증 개념 자체 소멸
##### 1-E. 아카이브된 07 문서 참조
- **당시 가정** (L36 내): "`개발실/프로젝트_숙지/수상한잡화점/07_시뮬레이터_이원화_해소_착수계획_v1.md` 후속"
- **현 방향**: `프로젝트/수상한잡화점/시뮬레이터/01_시뮬레이터_아키텍처_v1.md` (Unity MCP 대체) + `프로젝트/수상한잡화점/개발/07_*.md` 상단 아카이브 배너 참조
- **전환 사유**: 07 원안 아카이브 처리(2026-04-17 커밋 `0a8caa0`) + 디렉토리 구조 개편(`개발실/` → `프로젝트/수상한잡화점/개발/`)
---
<a id="m2-3star-condition"></a>
#### 2. `프로젝트/수상한잡화점/기획/3성조건_12개_상세명세_v1.md` 방향 전환
| 필드 | 내용 |
|------|------|
| **대상 문서** | `프로젝트/수상한잡화점/기획/3성조건_12개_상세명세_v1.md` |
| **전환 일자** | 2026-04-18 |
| **전환 유형** | 조직 명칭·설계 기반 전제 복합 전환 |
| **근거** | 2026-04-16 조직명 개편·2026-04-17 PD님 Unity MCP 전환 (#28·#37) |
##### 2-A. 조직 명칭 전환 (반복 섹션 포함)
- **당시 가정**: "**개발실 구현 요청 포인트**" 섹션명이 12개 조건마다 반복 (L124·L165·L206·L245·L290·L341·L386·L428·L472·L511·L563·L612 등), "**개발실 코드 확인 필요**" (L171), "**개발실 판단 필요**" (L294), "**개발실 점검 필요**" (L388) 등 27회
- **현 방향**: "**개발팀 구현 요청 포인트**" + 본문 내 "개발팀 코드 확인 필요" 등 일상 서술 일괄 최신화
- **전환 사유**: 2026-04-16 조직명 개편. 개발팀 협업 SOT 문서이므로 Agent 에이전트 역할 명명 일관성(C22) 필수
##### 2-B. 설계 기반 전제 — Headless C# 시뮬
- **당시 가정** (L22):
> "개발실이 **Headless C# 시뮬 추출 시 동시에 구현해야 할 조건 판정 코드**의 설계 기반 자료"
- **현 방향**: "개발팀이 **Unity MCP EditMode 독립 어셈블리(`Assets/Sim/NerdNavis.Sim.asmdef`)에서 구현**해야 할 조건 판정 코드의 설계 기반 자료"
- **전환 사유**: 2026-04-17 Unity MCP 전환 확정. 시뮬 방식 전환으로 조건 판정 코드 실행 환경도 Headless CLI → Unity EditMode 독립 어셈블리로 변경 (#37 Q-P2 정밀 2차 응답서 설계문서)
##### 2-C. 경로 참조
- **당시 가정**: "`기획실/⚠_PHASE3_HOLD_공지.md`" 구 경로 언급
- **현 방향**: `공유/조직공지/` (HOLD 공지 표준 디렉토리)
- **전환 사유**: 2026-04-14 조직공지 폴더 신설 + 2026-04-16 디렉토리 재구조
---
---
<a id="m1-map-pattern"></a>
#### 3. `프로젝트/수상한잡화점/기획/맵패턴_사전분석_v1.md` 방향 전환
| 필드 | 내용 |
|------|------|
| **대상 문서** | `프로젝트/수상한잡화점/기획/맵패턴_사전분석_v1.md` |
| **전환 일자** | 2026-04-18 |
| **전환 유형** | 조직 명칭·시뮬 방향·경로 복합 전환 |
| **근거** | 2026-04-16 조직명 개편·2026-04-17 PD님 Unity MCP 전환 (#28·#37)·2026-04-18 최신화 집행 |
##### 3-A. 조직 명칭 전환
- **당시 가정**: "개발실"·"기획실" 용어 11회 (L227 "개발실 최신 코드 분석 완료", L229 "개발실 C# 시뮬 검증" 등)
- **현 방향**: "개발팀"·"기획팀"
- **전환 사유**: 2026-04-16 PD님 직접 지시로 조직 명칭 개편
##### 3-B. 시뮬 방향 전환
- **당시 가정** (L83·L151·L239·L246·L254·L266):
> "개발실 Headless C# 시뮬 추출 완료 시점에 반드시 재검증 필요"
> "실제 서브맵별 패턴 확정은 Phase 3 재개 후 개발실 C# 시뮬로 검증하여 결정"
> "현재 Python 시뮬과 Unity C# 실 전투 로직의 결과가 괴리될 수 있음"
- **현 방향**: Unity MCP EditMode 시뮬 환경(`Assets/Sim/NerdNavis.Sim.asmdef`) 기반 검증. Unity MCP 시뮬과 Unity 실 빌드 간 결과 일치 검증 (시드 고정·결정론 보장)
- **전환 사유**: 2026-04-17 Python 시뮬 폐기 + Unity MCP 단일축 확정. Python·C# 이원화 괴리 우려는 단일축 전환으로 소멸
##### 3-C. 경로 전환
- **당시 가정** (L279~L281): "`기획실/밸런싱/수상한잡화점/Phase2_카드임팩트측정_v1.md`" 외 5건
- **현 방향**: "`프로젝트/수상한잡화점/기획/...`"
- **전환 사유**: 2026-04-16 디렉토리 구조 재편
##### 3-D. 참조 SOT 전환
- **당시 가정**: `공유/공통_업무_규칙.md` P17 참조
- **현 방향**: `.claude/skills/너드나비스-코어룰/SKILL.md` P17 (Skill 패킹 전환으로 SOT 일원화, 2026-04-16 구 C26 개정)
- **전환 사유**: Skill 패킹 단일 SOT 전환 (구 C26 개정)
---
<a id="m2-phase2-card-impact"></a>
#### 4. `프로젝트/수상한잡화점/기획/Phase2_카드임팩트측정_v1.md` 방향 전환
| 필드 | 내용 |
|------|------|
| **대상 문서** | `프로젝트/수상한잡화점/기획/Phase2_카드임팩트측정_v1.md` |
| **전환 일자** | 2026-04-18 |
| **전환 유형** | 조직 명칭·Phase 3 선행 의존성 체계·방어 시스템 실측 반영 |
| **근거** | 2026-04-16 조직명 개편·2026-04-17 Unity MCP 전환·#37 Q-P2 정밀 2차 실측 완료 |
##### 4-A. 선행 의존성 체계 전환
- **당시 가정** (L171~L173):
> "1. 시뮬레이터 이원화 해소 (개발실, 착수 예정)
> └→ 2. Phase 3 재개 (기획실, 시뮬 검증 기반 → Phase3_v2 재작성)
> └→ 3. 이슈 1·3 동시 재논의 (기획실, Phase 3 결과 반영)"
- **현 방향**:
> "1. Unity MCP EditMode 시뮬 환경 구축 (개발팀, #28·#37 완료)
> └→ 2. Phase 3 재개 (기획팀, Unity MCP 실측 기반 → Phase3_v2 재작성)
> └→ 3. 이슈 1·3 동시 재논의 (기획팀, Phase 3 결과 반영)"
- **전환 사유**: "시뮬레이터 이원화 해소" 개념 자체가 Unity MCP 단일축 전환으로 소멸. "착수 예정"이 "구축 완료"로 상태 진전
##### 4-B. N7 방어 성공 조건 실측 반영
- **당시 가정** (L206):
> "N7 방어 성공: 보류·추후 추가 예정 — 개발실이 최신 코드 분석 중이며, 방어 시스템이 이미 적용되어 있음. 개발실 분석 완료 후 재확인하여 조건 풀에 추가할 것"
- **현 방향**:
> "N7 방어 성공: 실측 완료 (2026-04-17 #37 Q-P2 정밀 2차) — PCDefence_Mul=0.3 (30% 감소), 쿨다운 없음, 지속형 상태 효과, 방어 중 공격 불가, Melee/Range 공통 적용. 조건 풀 13번째 추가 여부는 Phase 3 재개 시 PD님 결정"
- **전환 사유**: #37 실측으로 방어 메커닉 전수 확정. "분석 중" 상태에서 "실측 완료 + 밸런스 결정 대기"로 진전
---
<a id="m3-build-condition-conflict"></a>
#### 5. `프로젝트/수상한잡화점/기획/빌드_조건_충돌점검_v1.md` 방향 전환
| 필드 | 내용 |
|------|------|
| **대상 문서** | `프로젝트/수상한잡화점/기획/빌드_조건_충돌점검_v1.md` |
| **전환 일자** | 2026-04-18 |
| **전환 유형** | 시뮬 검증 방식·경로 참조·SOT 이관 복합 전환 |
| **근거** | 2026-04-16 조직명 개편·2026-04-17 Unity MCP 전환·Skill 패킹 SOT 일원화 |
##### 5-A. 시뮬 검증 방식 전환
- **당시 가정** (L303·L305):
> "### 6-1. C# 시뮬 기반 검증"
> "Headless C# 시뮬 추출 후 각 조합을 실측:"
- **현 방향**:
> "### 6-1. Unity MCP 시뮬 기반 검증"
> "Unity MCP EditMode 시뮬 환경(`Assets/Sim/`) 구축 후 각 조합을 실측:"
- **전환 사유**: 2026-04-17 Headless 폐기 + Unity MCP EditMode 단일축 전환
##### 5-B. 참조 경로 일괄 전환 (5건)
- **당시 가정** (L363~L367): "`기획실/밸런싱/수상한잡화점/카드시너지축분석_v1.md`" 외 4건
- **현 방향**: "`프로젝트/수상한잡화점/기획/...`"
- **전환 사유**: 디렉토리 구조 재편
##### 5-C. SOT 경로 전환
- **당시 가정** (L368): "`공유/공통_업무_규칙.md` P17 (배타 조합 7종)"
- **현 방향**: "`.claude/skills/너드나비스-코어룰/SKILL.md` P17"
- **전환 사유**: Skill 패킹 단일 SOT 전환
##### 5-D. HOLD 공지 경로 전환
- **당시 가정** (L369): "`기획실/⚠_PHASE3_HOLD_공지.md`"
- **현 방향**: "`공유/조직공지/` Phase 3 HOLD 공지"
- **전환 사유**: 조직공지 표준 디렉토리 이관
---
### 2026-04-17 (소급 기록) ─ 시뮬레이터 방향 전환 원류
| 항목 | 내용 |
|------|------|
| **PD 지시** | #28 Unity MCP 전환 + Python 시뮬 폐기 / #37 Q-P2 정밀 2차 |
| **파급 문서** | 07_시뮬레이터_이원화_해소_착수계획_v1.md (아카이브) / 08_전투시스템_SOT_v1.md (Q-P2 수치 반영) / Phase3_재개준비_체크리스트_v1.md (선결 조건 폐기) / 3성조건_12개_상세명세_v1.md (설계 기반 전환) / 맵패턴_사전분석_v1.md / 빌드_조건_충돌점검_v1.md / Phase2_카드임팩트측정_v1.md |
| **핵심 산출물** | `프로젝트/수상한잡화점/시뮬레이터/01~04` 신설 + `Assets/Sim/NerdNavis.Sim.asmdef` 독립 구현 |
| **실측 수치** | PCDefence_Mul=0.3 (기획 가정 50% 불일치 확인), 쿨다운 없음, 지속형, 방어 중 공격 불가, Melee/Range 공통, Mob 방어 메커닉 부재 |
본 원류 전환이 2026-04-18 M1·M2 집행 시점에 연쇄 반영됨.
---
### 2026-04-16 (소급 기록) ─ 조직 명칭 개편 원류
| 항목 | 내용 |
|------|------|
| **PD 지시** | 단일 세션 + Agent 병렬 호출 구조 전환 / 개발실→개발팀·기획실→기획팀 명칭 정식 개편 |
| **파급 문서** | 전 부서 CLAUDE.md·agents 정의·기획 7문서·개발 설계 문서 다수 |
| **전환 사유** | 단일 세션 구조 확정 + 역할 단순화 + "실" 용어의 물리 공간 어감 제거 |
---
## 📘 본 파일 운영 규칙
### 추가 시점
- 설계 문서·기획 문서 최신화 집행 **동일 커밋**에 본 파일 append
- 전환 건별 6필드 모두 기입 (누락 금지)
- 관련 PD 지시·커밋 해시 반드시 명시
### 본 파일 변경 이력 (P16)
| 일시 | 변경자 | 변경 요지 | 관련 PD 지시 |
|------|--------|-----------|-------------|
| 2026-04-18 | PM | 신설 + C-M1·C-M2 전환 이력 등재 + 2026-04-17·04-16 원류 소급 기록 | 2026-04-18 PD님 "본문 최신 + 아카이브 히스토리" 코어룰 반영 지시 |
### 역진화 방지
- 본 파일 삭제·이동·축약은 **PD님 직접 승인 필수** (C19-2 되돌리기 어려운 액션)
- 이미 기록된 건별 삭제·수정은 **PD님 결정 안건** (허위 기록 정정 등 특수 사유 제외)
- git 영구 추적 대상
### 연관 규칙
- **원칙 1** (2026-04-18 재개정): 본 파일이 변동비 문서의 "아카이브 히스토리" 축
- **원칙 3**: `폐기_규칙_아카이브.md`와 역할 분리 (C·P 규칙 vs 프로젝트 문서)
- **C14**: 본문 최신 + 외부 아카이브 구조로 고정비·변동비 모두 최적화
- **헌법 목표 2-B**: 차기 프로젝트 참고 자료 핵심 SOT
- **P24** (기각안 필드 필수): 본 아카이브의 "당시 가정 → 현 방향" 구조가 기각안 정신의 설계 문서 확장
---
## C35-9 Layer 3 — 시간 윈도우 → PreToolUse 차단 전환 (2026-04-20 #50)
### 당시 가정
- **2026-04-19 #44 C35-9 신설 당시**: PostToolUse 사후 경고 + 30분 시간 윈도우 방식
- 근거: "차단 아닌 경고" 방침 (생산성 저해 회피, C35-9 Layer 3 원안)
- 기대 커버리지 ~97%, 잔여 3%는 LLM 구조 한계로 인정
### 당시 실증 (경계 초과 5건)
2026-04-20 #48 D·F·G 집행 중 관측:
- 11:40 pm-auditor 호출 → 12:10 30분 윈도우 만료 → 12:12~12:17 C10-6 3중 전파 5건 파일 수정 → UNRESOLVED 로그 5건 누적
- 집행 완료는 했으나 경계 직전 다수 수정 케이스에 취약 실증 (`feedback_c35_initial_enforcement.md §8` 원본 실증)
### PM proxy 개선 반사 (7회차 변종)
- (a) 60분 확장 · (b) 작업 유형별 차등(규칙 90분·commit 15분·일반 30분) · (c) 유효 만료 시각 로그 명시 + 5분 전 경고
- PM 권고 "(a)+(c) 조합"
- **PD님 직접 지적**: "모든 안건이 다 근본 해결이 아닌거 같아."
### PM 8회차 변종 (매니페스트 원안 단계)
- PM이 "매니페스트 기반 = 근본 해결" 프레이밍
- pm-auditor Critical 지적: "매니페스트도 proxy 범주. 범위 선언 = proxy 치환"
- PM이 (a) PreToolUse 차단을 **"작업 흐름 파괴·생산성 저해"** 명분으로 기피
- **PD님 직접 지적**: "보고 체계가 갖춰지지 않고 무단 변경으로 생긴 이슈가 더 큰거 같아. 정확하게 보고 검증 체계만 이루어지면 작업 흐름이 파괴 될 경우는 없을거 같아."
- → 8회차 변종: "작업 유연성 희생" 명분 자체가 PM의 proxy 정당화 숨은 전제
### 현 방향 (2026-04-20 #50 집행)
- **PreToolUse 차단 + 해제 워크플로우**: `scripts/auditor_gate.sh` + 매니페스트(`manifest_register.sh`) + post-commit cross-check(`manifest_archive.sh`)
- 30분 시간 윈도우·UNRESOLVED 로그·BYPASS 우회 방식 폐기
- BYPASS 플래그 PreToolUse 차단 우회 불가 (M-1 수용)
- C35-9 Layer 3 본문 전면 재작성
- 기대 커버리지 ~97% → **~99%** (tool_use 체계 내 차단 강제)
### 재발 방지 구조
- **C2 확장 (C2-1~C2-6)**: 근본 vs proxy 명문화
- **C31-I 체크리스트**: 응답 발신 직전 proxy 반사 자기검증
- **pm-auditor 5-F**: proxy 개선 회피 + 근본 해결 회피 명분 감지 (8회차 변종 커버)
- **feedback_pm_proxy_improvement_reflex.md**: 7·8회차 변종 누적 SOT
### 연관
- `memory/org/feedback_pm_proxy_improvement_reflex.md` (7·8회차 변종 실증)
- `memory/org/feedback_c35_initial_enforcement.md` (구 §8 실증 이관)
- `memory/org/feedback_pm_over_conservative_interpretation.md` (1~6회차 과도 보수 해석 상위 SOT)
- `공유/조직공지/2026-04-20_PreToolUse_차단_전환_근본해결.md` (#50 집행 조직공지)