BurningTimesAi/프로젝트/수상한잡화점/기획/기획팀_데이터_실측_의무_v1.md

182 lines
8.3 KiB
Markdown
Raw Normal View History

feat(#41·재발방지): 테이블 데이터 구조 재확인 + 지역1 v2 + 기획팀 룰 PD 재발 방지 지시 5종 수용 — 기획팀장 Task 집행 완료. [PD 용어 정의 SOT 확정] - 월드맵: WorldMapConfig.n_StageID = 21개 구역 - 구역/지역: CreateMapConfig.n_StageType = 1~21 - 스테이지: CreateMapConfig.s_MapConfigID (각 맵) - 지역 1 = 4개 스테이지 (Stage1_1·1_2·1_3·1_4) 확정 [실측 확인] Unity Export CSV 직접 실측 — PD 정의와 100% 일치 21 지역 × 하위 3~9 스테이지 = 총 122 스테이지 [집행 산출물 4종] - 테이블_데이터_구조_재정비_v1.md (신설 · 게임 테이블 전수 구조) - 기획팀_데이터_실측_의무_v1.md (신설 · 기획팀 룰 5대 의무) - Phase4_지역1_노드구성_v2.md (신설 · Stage1_1~1_4 · JSON 초안 §5) - Phase4_지역1_노드구성_v1.md (아카이브 배너 추가 · 데이터 구조 오류 폐기) [기획팀 룰 5대 의무] 1. 데이터 구조 실측 의무 (Unity Export 선행 Read) 2. PD 용어 정의 엄격 준수 3. PD 의도 확인 절차 (팀→PM→PD 3단계) 4. 기존 SOT 맹신 금지 (데이터 소스 실측 일시 필드 필수) 5. 기획 문서 재사용 시 선행 검증 [오염 산출물 재정비 범위] - 즉시: Phase4_지역1_v1 아카이브 (완료) - 후속: 스테이지난이도곡선_v1 §1·Phase4 착수가이드·맵패턴 사전분석·재검증보고_맵패턴·Phase3_종결 등 (PD 재정비 방향 승인 후 순차) [PM 자진 반성] 본 사건은 C31-E 실측 응집성 실패 누적 패턴. PM이 기획팀장 주장을 CreateMapConfig 직접 실측 없이 수용. 의무 4종 발효 중 재발. PM 역할 재검토 강도 상향 필요. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 13:16:17 +00:00
---
type: 기획팀 내부 룰 (수상한잡화점 프로젝트 한정)
작성일: 2026-04-20
작성자: 기획팀장 (PM 경유 PD 재발 방지 지시 #43 수용)
관련PD지시: 기획팀 #43 · PD 2026-04-20 "기획팀 내 룰 신설 — PD 의도 벗어난 작업 재발 방지"
상태: **v1 초안 · PM 검토 → PD 승인 후 발효**
적용 범위: 기획팀 전원 (기획팀장 · 시스템 · 컨텐츠 · 레벨 · 시나리오 · 밸런스 · UX)
C36 분류: **구현·실무 수준 룰** (조직 코어룰 수정 아님)
---
# 기획팀 — 데이터 실측·PD 의도 준수 의무 v1
## §0. 본 룰의 존재 이유
2026-04-20 PD 재발 방지 지시 5종 중 #43 이행. 기획팀이 **"WorldMap 4그룹"** 같은 전제·추측을 데이터 실측 없이 장기간 SOT화하여 Phase 4 지역 1 노드 구성 전체를 **잘못된 구조(Stage 1~6 = 지역 1)** 로 진행한 사건을 구조적으로 차단.
**본 룰을 지키지 않으면 PD 의도를 벗어난 산출물이 대량 생성되고, 재작업 비용이 조직 전체에 전가된다.**
---
## §1. 5대 의무 조항
### §1-1. 데이터 구조 실측 의무
**기획팀 모든 에이전트는 데이터 테이블을 참조하는 기획 작업 착수 전, Unity Export CSV/JSON 실측을 선행한다.**
- 기존 기획 문서의 수치·구조를 **무비판 수용 금지** (전재 SOT 확립 선행 필수)
- 추측·전제·이름 기반 추정 금지 (예: "WorldMap이라는 이름이 있으니 4개 그룹이겠지")
- 실측 방법:
feat(BT·신설): 조직 전환 Phase 2-A — Skill/Framework rename + 조직명 치환 + 새 프로젝트 셋업 PD님 2026-04-21 지시 8개 중 ②③④⑤⑥⑦⑧ 구조 전환부 이행 (①③ 노하우 재정리는 Phase 2-B, 삭제는 Phase 2-C). ## 집행 내역 1. .claude/skills/너드나비스-코어룰/ → BurningTimes-코어룰/ (Move-Item, R096·R100) 2. 코어코드/NerdNavis.Framework/ → 코어코드/BT.Framework/ (Move-Item, R100·R073·R081) 3. sed 일괄 치환 201파일 (치환 순서: NerdNavis.Framework → BT.Framework **선행** → NerdNavis → BurningTimes → 너드나비스 → BurningTimes) - 제외: .git/·.live/·.bak_*·memory/org/audit_logs/ 4. paths.local.json.template: DISCORD_WEBHOOK 추가 + Unity/Framework __SET_PER_PC__ placeholder 5. paths.local.json 실파일 생성 (gitignore, 본 PC 실값: Unity E:/NerdNavis/EerieVillage + Discord 웹훅) 6. 프로젝트/EerieVillage/ 신설 (개발·기획·관리 + README: 기묘한 고을: 조선퇴마뎐, Unity 6000.3.13f1 LTS, 2D PlatformerMicrogame) 7. README.md clone URL NerdNavis_AiDev/BurningTimesAi.git 실 URL 정정 8. 대화로그 공유/대화로그/조직운영/2026-04-21.md 신설 9. PD 지시 로그 양팀 BT1·BT2 항목 등록 (진행중) ## NerdNavis 의도적 잔존 3종 (C5 정직성) - GIT_REMOTE URL: Gitea 조직 hierarchy NerdNavis_AiDev (PD 별도 결정 영역) - UNITY_PROJECT_ROOT 실값: E:/NerdNavis/EerieVillage (PD 지시 6번) - EerieVillage README "BT.Framework (구 NerdNavis.Framework 계승)" 이력 표기 ## 감사 pm-auditor 사전 감사 Critical 2건 (대화로그·PD 지시 로그 선등록) 정정 완료. 매니페스트: bt-phase2a. ## 보류 (Phase 2-B → 2-C 예정) - Phase 2-B: 전 에이전트 동원 수상한잡화점 시행착오 노하우 추출·조직 자산화 - Phase 2-C: 수상한잡화점 일괄 삭제 + memory/org feedback "수상한잡화점" → "이전 프로젝트" 추상화 + PD 지시 로그 초기화 + 조직공지 정리 + SKILL P17·P29 재해석 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 15:44:48 +00:00
1. **Unity Export 경로**: `D:/BurningTimes/FilGoodBandits/DeckBuilding/Assets/ResWork/Table/Export/` (PC별 상이 — `paths.local.json` 등록)
feat(#41·재발방지): 테이블 데이터 구조 재확인 + 지역1 v2 + 기획팀 룰 PD 재발 방지 지시 5종 수용 — 기획팀장 Task 집행 완료. [PD 용어 정의 SOT 확정] - 월드맵: WorldMapConfig.n_StageID = 21개 구역 - 구역/지역: CreateMapConfig.n_StageType = 1~21 - 스테이지: CreateMapConfig.s_MapConfigID (각 맵) - 지역 1 = 4개 스테이지 (Stage1_1·1_2·1_3·1_4) 확정 [실측 확인] Unity Export CSV 직접 실측 — PD 정의와 100% 일치 21 지역 × 하위 3~9 스테이지 = 총 122 스테이지 [집행 산출물 4종] - 테이블_데이터_구조_재정비_v1.md (신설 · 게임 테이블 전수 구조) - 기획팀_데이터_실측_의무_v1.md (신설 · 기획팀 룰 5대 의무) - Phase4_지역1_노드구성_v2.md (신설 · Stage1_1~1_4 · JSON 초안 §5) - Phase4_지역1_노드구성_v1.md (아카이브 배너 추가 · 데이터 구조 오류 폐기) [기획팀 룰 5대 의무] 1. 데이터 구조 실측 의무 (Unity Export 선행 Read) 2. PD 용어 정의 엄격 준수 3. PD 의도 확인 절차 (팀→PM→PD 3단계) 4. 기존 SOT 맹신 금지 (데이터 소스 실측 일시 필드 필수) 5. 기획 문서 재사용 시 선행 검증 [오염 산출물 재정비 범위] - 즉시: Phase4_지역1_v1 아카이브 (완료) - 후속: 스테이지난이도곡선_v1 §1·Phase4 착수가이드·맵패턴 사전분석·재검증보고_맵패턴·Phase3_종결 등 (PD 재정비 방향 승인 후 순차) [PM 자진 반성] 본 사건은 C31-E 실측 응집성 실패 누적 패턴. PM이 기획팀장 주장을 CreateMapConfig 직접 실측 없이 수용. 의무 4종 발효 중 재발. PM 역할 재검토 강도 상향 필요. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 13:16:17 +00:00
2. **Read 도구로 CSV/JSON 직접 읽기** (추측 금지, 눈으로 확인)
3. **레코드 수·필드 구조 명시적 기록** (기획 문서 "근거" 섹션에 기입)
- **위반 시**: 본 사건 같은 전면 재작업. 기획팀장 재량 판단 실패로 간주
### §1-2. PD 용어 정의 엄격 준수 의무
**PD가 확정한 용어는 기획팀 전원이 **일관 사용**한다 (C22 용어 일관 확장).**
- **본 프로젝트 확정 용어 (SOT)**:
- **월드맵**: 21개 구역 구성 (`WorldMapConfig.n_StageID`)
- **구역 / 지역**: WorldMap의 각 지역 (= Stage 1~21)
- **스테이지**: 지역 내 각 맵 (Stage1_1·1_2 등, `CreateMapConfig.s_MapConfigID`)
- **서브맵**: 스테이지 내 노드 (런타임 생성)
- **금지 용어** (본 사건 계기):
- "WorldMap_1·2·3·4 4개 그룹" → **데이터 구조 아님 · 사용 금지**
- "WM1~WM4" → 동일
- "입문/초반/중반/후반 구간" → **기획 레이블만 별도 명시** (데이터 구조 아님)
- **용어 혼선 발견 즉시 정정** + 다른 에이전트 대화로그에도 공유
### §1-3. PD 의도 확인 절차 의무
**확실하지 않은 것은 추측하지 않고 PD에게 확인한다.**
#### §1-3-1. 3단계 확인 절차
1. **기획팀 내부 논의** — 해당 영역 전문 에이전트 + 기획팀장 자체 논의로 결론 도출 시도
2. **PM 조율** — 팀 내 결론 안 나면 PM에게 조율 요청 (C29-1 단계 2)
3. **PD 에스컬레이션** — PM까지 불확실하면 PD 질의 (C29-1 단계 3의 예외)
#### §1-3-2. 금지 행위
- **추측으로 결정 진행** — "아마 이런 의미겠지" 금지
- **기존 문서에 쓰여있다는 이유로 무비판 수용** — §1-1 실측 의무 위반
- **"확인 안 해본 사항"을 가정하여 진행** — C10-5 위반
#### §1-3-3. PD 질의 시 포함 의무
- 현 기획팀 이해 요약 (1~2줄)
- 불확실 지점 명시 (A안 vs B안)
- 기획팀 권장안 + 사유
### §1-4. 기존 SOT 맹신 금지 의무
**이전 기획 문서의 수치·구조를 "SOT"로 부르더라도 항상 실측과 교차 검증한다.**
#### §1-4-1. 실증 사건 (본 룰 신설 근거)
- `스테이지난이도곡선_v1.md §1` "WorldMap_1~4 4개 그룹" → 다수 후속 문서가 무비판 인용
- `Phase3_종결_설계체계_v1.md`·`Phase4_노드구성_착수가이드_v1.md` → 같은 오해 계승
- `Phase4_지역1_노드구성_v1.md` → Stage 1~6 = 지역 1 = 6개로 전면 설계 (전면 폐기)
#### §1-4-2. 재발 방지 체크포인트
모든 기획 문서는 상단에 **"데이터 소스 실측 일시"** 필드 명기:
```
데이터 소스: CreateMapConfig.csv (실측 2026-04-20) · MonsterList.csv (실측 2026-04-20)
```
실측 일시 미기입 문서는 **참조 금지**. 참조 시 실측 재수행.
### §1-5. 기획 문서 재사용 시 선행 검증 의무
**기존 기획 문서를 인용·확장·발전시킬 때, §1-1 실측 + §1-4 교차 검증을 선행한다.**
- 이전 버전의 구조·수치·용어를 **100% 재확인** (§1-1 실측 결과와 대조)
- 불일치 발견 시 **해당 문서 정정 안건 PM 보고** (본 작업 완료 후 별도 후속 지시로 집행)
- 기존 문서 전제를 자기 산출물 근거로 삼았다가 해당 전제가 틀릴 경우 **자기 산출물도 전면 재작성** (본 사건 실증)
---
## §2. 처분 · 재발 방지
### §2-1. 1회 발견
- **즉시 자진 고지** + 본 룰 §N 재확인
- 관련 산출물 정정 또는 재작성
- 대화로그에 "데이터 실측 의무 위반" 엔트리 기록
### §2-2. 반복 발생 시
- **본 사건 같은 대규모 재작업 유발 위반** → 기획팀장 역할 재검토 자진 상정
- 3회차 재발 시 **기획팀 전체 프로세스 점검** PM 요청
### §2-3. 은폐 적발
- C3 이슈 은폐 금지 위반 + C23 허위 보고 결합
- 은폐 기간 내 모든 산출물 재검증
---
## §3. 타 규칙과의 관계
- **C22** 용어 일관 — §1-2는 C22의 기획팀 특화
- **C23** 허위 보고 금지 — §1-3·§1-4는 C23의 기획 실무 확장
- **C10-5** 선행 검증 — §1-1은 C10-5의 강화판 (Unity Export 실측 의무)
- **P30** 재미 우선 — 본 룰 준수 전제 위에서 P30 적용
- **P16** 산출물 추적성 — §1-4 "실측 일시" 기입으로 P16 강화
---
## §4. 실행 예시
### §4-1. 좋은 예시 (§1 준수)
```
## §N. 지역 1 노드 구성
데이터 소스: CreateMapConfig.csv (실측 2026-04-20 15:30)
지역 1 = Stage1_1·Stage1_2·Stage1_3·Stage1_4 = 4개 스테이지 (실측 확인).
- Stage1_1: n_AppearMonsterGroup=10101, n_AppearBossGroup=0 (보스 없음)
- Stage1_2: n_AppearMonsterGroup=10102, n_AppearBossGroup=10001 (놀아처1)
...
```
### §4-2. 나쁜 예시 (본 사건 실측 패턴)
```
## §N. 지역 1 노드 구성
WorldMap_1 = Stage 1~6 (이전 문서 참조)
- Stage 1: 서브맵 4개, 보스 2마리 (놀아처1, 놀강도2)
- Stage 2: 서브맵 6개, 보스 3마리 (...)
...
```
→ "WorldMap_1" 용어·6개 가정 모두 **실측 없이 전제** — §1-1·§1-2 위반
---
## §5. 기각안
### §5-1. 기각안 A: 조직 코어룰(C)로 신설
- **기각 사유**: C36 판정 기준 3종 미해당 (구현·실무 수준). 조직 전체가 아닌 **기획팀 특화 룰**
- **대체**: 기획팀 프로젝트 룰(본 문서)로 유지
### §5-2. 기각안 B: 기획팀 전체 공통 룰 (본 프로젝트 외에도 적용)
- **기각 사유**: Unity Export 경로는 본 프로젝트 전용. 차기 프로젝트에 다른 데이터 체계 도입 시 본 룰 재검토 필요
- **대체**: 본 프로젝트 전용으로 확정. 차기 프로젝트 착수 시 유사 룰 재작성
### §5-3. 기각안 C: 세부 체크리스트 형태 (예: "CSV 몇 줄 이상 읽어야 함" 등)
- **기각 사유**: 과도한 경직성. 기획 작업 유연성 훼손. "실측 의무"라는 원칙 수준이 충분
- **대체**: 원칙 + 실행 예시 (§4) 제공
---
## §6. 참고 문서
- 본 룰 신설 근거 사건 실측: `프로젝트/수상한잡화점/기획/테이블_데이터_구조_재정비_v1.md` §7
- PD 용어 정의 SOT: 위 문서 §1
- 조직 코어룰: SKILL.md C22 용어 일관 · C23 허위 보고 금지 · C10-5 선행 검증
- 프로젝트 룰: SKILL.md P16 산출물 추적성 · P30 재미 우선
---
## §7. 변경 이력 (P16 산출물 추적성)
| 일시 | 변경자 | 변경 필드 | 이전값 → 이후값 | 재미 근거 | 관련 PD 지시# |
|------|--------|----------|----------------|----------|--------------|
| 2026-04-20 | 기획팀장 | 전체 신설 | (없음) → v1 초안 | PD 의도 벗어난 기획으로 인한 재미 훼손 차단 | #43 |