19 KiB
19 KiB
| type | created | maintainer | sot_boundary | related | rationale |
|---|---|---|---|---|---|
| 방향전환히스토리아카이브 | 2026-04-18 | 총괄PM | 프로젝트 설계 문서·기획 문서의 방향 전환(폐기·개정·용어 변경) 이력 단일 SOT | 공유/조직공지/폐기_규칙_아카이브.md (C·P 규칙 전담 / 본 파일은 프로젝트 문서 전담) | 수정 3대 원칙(2026-04-18 재개정) — "본문은 최신 내용만, 히스토리는 아카이브" 구조의 프로젝트 문서 SOT |
📚 방향전환 히스토리 아카이브 (프로젝트 문서)
본 파일의 성격: 프로젝트 설계 문서·기획 문서가 최신 상태로 유지되는 과정에서 발생한 방향 전환·용어 변경·경로 이동·폐기 전제 이력을 집약한 조직 노하우 SOT. 본문에는 최신 내용만 남기고 작업 과정 히스토리는 본 아카이브에 축적하여 차기 프로젝트에서 "왜 이렇게 변경되었는가" 참고 자료로 활용.
근거: 2026-04-18 PD님 직접 지시 — "기본 문서에는 심플하게 최신 내용만, 히스토리는 노하우 축적을 위해 아카이브, 필요 시 참조 가능하도록 코어룰에 반영". 수정 3대 원칙 원칙 1 재개정에 따라 신설.
읽기 규칙: 본 파일은 변동비. 활성 본문에서 "이 부분이 왜 이렇게 됐지?" 의문 시 Read. 매 턴 자동 로드 아님.
🏛️ 운영 원칙
기록 대상
- 프로젝트 설계 문서 (
프로젝트/수상한잡화점/개발/·기획/·시뮬레이터/·프로젝트/코어프레임워크/)의 방향 전환 - 기획 문서의 폐기된 전제·구용어·구경로 (원래 본문에 있던 것을 최신화하면서 제거한 내용)
- 개발 설계 문서의 폐기된 설계 결정·기각된 대안
제외 대상
- 오탈자·문단 재배치 같은 단순 편집
- 코어룰(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/BurningTimes.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/BurningTimes.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 디렉토리 재구조
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/BurningTimes.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 전환
- 당시 가정:
공유/공통_업무_규칙.mdP17 참조 - 현 방향:
.claude/skills/BurningTimes-코어룰/SKILL.mdP17 (Skill 패킹 전환으로 SOT 일원화, 2026-04-16 구 C26 개정) - 전환 사유: Skill 패킹 단일 SOT 전환 (구 C26 개정)
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 실측으로 방어 메커닉 전수 확정. "분석 중" 상태에서 "실측 완료 + 밸런스 결정 대기"로 진전
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): "
공유/공통_업무_규칙.mdP17 (배타 조합 7종)" - 현 방향: "
.claude/skills/BurningTimes-코어룰/SKILL.mdP17" - 전환 사유: 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/BurningTimes.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 집행 조직공지)