167 lines
11 KiB
Markdown
167 lines
11 KiB
Markdown
---
|
||
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 재개 선결 체계 최신화
|
||
|
||
#### 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`) + 디렉토리 구조 개편(`개발실/` → `프로젝트/수상한잡화점/개발/`)
|
||
|
||
---
|
||
|
||
#### 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 디렉토리 재구조
|
||
|
||
---
|
||
|
||
### 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** (기각안 필드 필수): 본 아카이브의 "당시 가정 → 현 방향" 구조가 기각안 정신의 설계 문서 확장
|