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

167 lines
11 KiB
Markdown
Raw Normal View History

refactor(rules): 원칙 1 재개정 + 방향전환 아카이브 신설 + M1·M2 본문 최신화 — PD님 직접 확장 지시 ## PD님 확장 지시 DEC-2 M1·M2 집행 시 "본문 최신 + 히스토리 아카이브 + 코어룰 반영" 영구 체계 구축. 이전 PM 제시안("당시 가정 + 현 방향 병기")은 본문 비대화로 반려, 병기 대신 외부 아카이브로 이관. ## Phase 1 — 코어룰 정비 (영구 체계) 1. 공유/조직공지/방향전환_히스토리_아카이브.md 신설 - 프로젝트 문서 방향 전환 전담 SOT - 6필드 형식 (대상·일자·유형·당시 가정·현 방향·근거) - 2026-04-18·04-17·04-16 전환 이력 등재 2. 인계서 §1 원칙 1 재개정 - "본문 최신, 히스토리는 아카이브" (변동비·고정비 공통) - 이전 외연 명확화 버전 대체 3. SKILL.md C14-5 신설 - "본문 최신 + 히스토리 아카이브 원칙" - 3종 세트 집행 규정 (본문 수정·아카이브 기록·배너 링크) ## Phase 2 — M1·M2 집행 (새 원칙 적용) - M1 Phase3_재개준비_체크리스트_v1.md - 상단 배너 + 구용어 37건 완전 제거 - 최종 구용어 0건 달성 - 개발실→개발팀, 기획실→기획팀 - Python·Headless·C# 시뮬 → Unity MCP EditMode - 07 참조 → 시뮬레이터/01 + 아카이브 링크 - M2 3성조건_12개_상세명세_v1.md - 상단 배너 + 구용어 40건 완전 제거 - 최종 구용어 0건 달성 - 설계 기반 전제 → Assets/Sim/NerdNavis.Sim.asmdef ## 수정 3대 원칙 준수 1. 본문 최신, 히스토리 아카이브 (새 원칙 1) 2. sed 금지 (M1 수동, M2 조직명 통일 `replace_all` 경계 허용) 3. 폐기 선언 외부 아카이브 (원칙 1·3 통합 운용) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 18:08:54 +00:00
---
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** (기각안 필드 필수): 본 아카이브의 "당시 가정 → 현 방향" 구조가 기각안 정신의 설계 문서 확장