BurningTimesAi/공유/조직공지/2026-04-21_BT_조직_출범_인계서.md

# 2026-04-21 BurningTimes 조직 출범·전환 완결 인계서

> **목적**: 2026-04-21 BurningTimes 신설 조직 전환 작업 전체 완결 상태를 다른 PC·다른 세션에서 인지·재현할 수 있도록 빠짐없이 공유하는 단일 인계서.
>
> **상태**: 🟢 **조직 전환 완결 (PD님 Discord 웹훅 실증 완료 · main push 전수 반영)**

---

## 0. 조직 전환 요약

| 항목 | 내용 |
|------|------|
| 이전 조직 | NerdNavis (레포: `E:/NerdNavisAi`, 원격: `NerdNavis/NerdNavisAi.git`) — **별도 병립 운영 유지** |
| **신 조직** | **BurningTimes** (레포: `E:/BurningTimes`, 원격: `NerdNavis_AiDev/BurningTimesAi.git`) |
| 첫 프로젝트 | **EerieVillage** (기묘한 고을: 조선퇴마뎐) · Unity 6000.3.13f1 LTS · 2D PlatformerMicrogame 템플릿 |
| 코어 프레임워크 | **BT.Framework** (구 NerdNavis.Framework Tier 1 16/16 계승) |
| 조직 노하우 | `공유/조직자산/시행착오_아카이브/` 14종 (전 에이전트 동원 추출) + `memory/org/` feedback 48종 |

## 1. 원격 저장소 상태 (최신 tag 체계)

| 태그 | 해시 | 의미 |
|------|------|------|
| `phase-2a-complete` | `5d5b1dd` | Skill/Framework rename + 조직명 치환 |
| `phase-2b-complete` | `44f7fb1` | 전 14개 에이전트 시행착오 아카이브 |
| `phase-2c-complete` | `616e3d3` | 삭제 + 추상화 + 재압축 |
| 잔존 정리 | `8ff5a1f` | asmdef rename + 코어 문서 추상화 |
| 세션 인계서 | `0bda9d3` | Phase 2-C 후속 + 인계서 1차 발행 |
| BT3 Unity MCP 셋업 | `aa61028` | A안 + setup 자동 clone + Claude Desktop HTTP 초안 |
| ToolSearch·Agent 자동 승인 | `6550dc7` | 권한 allow 추가 |
| **BT3 완결 + 조직 자산** | **`5a161fc`** | Unity MCP 연동 성공 실증 + 가이드 v2·조직공지·feedback·시행착오 아카이브 |

**롤백 경로**: 태그 기준 `git reset --hard phase-2X-complete` 또는 `git show <tag>:<path>` 역사 조회 가능.

**현재 main HEAD**: `5a161fc` (본 인계서 갱신 기준)

## 2. 다른 PC에서 이어 작업하는 절차 (필수 5단계)

### 2-1. BT 레포 clone·pull
```bash
# 신규 PC — clone
git clone https://burning.i234.me/NerdNavis_AiDev/BurningTimesAi.git "E:/BurningTimes"

# 기존 PC — pull
cd E:/BurningTimes && git pull origin main
```

### 2-2. `paths.local.json` 생성 (PC별 실값 — gitignore 대상이라 각 PC에서 개별 작성)
```bash
cp paths.local.json.template paths.local.json
```
**편집 필수 항목**:
- `UNITY_PROJECT_ROOT`: 해당 PC의 Unity 프로젝트 경로 (본 PC 예시: `E:/NerdNavis/EerieVillage`)
- `FRAMEWORK_PKG_ROOT`: BT.Framework 패키지 로컬 경로 (분리 레포 결정 시)
- `DISCORD_WEBHOOK`: BT 조직 공용 Discord 웹훅 URL (PD님 제공값, PC 공용)

### 2-3. setup 스크립트 실행 (burningtimes-* 중앙 저장소 junction 재연결)
```powershell
# Windows
.\setup\setup_windows.ps1
```
```bash
# macOS / Linux
bash setup/setup_macos.sh
```
자동 수행 항목:
- `$HOME/.claude/burningtimes-live/` · `burningtimes-memory/` · `burningtimes-audit/` 3종 중앙 디렉토리 생성
- `E:/BurningTimes/.live/` → `burningtimes-live/` junction
- `$HOME/.claude/.burningtimes_auditor_calls·warning_ignored·bypass_log` audit junction 3종
- Claude user memory junction → `burningtimes-memory/`
- `git config core.hooksPath scripts/git-hooks` (post-commit hook 자동 활성)

### 2-4. 검증 스크립트
```powershell
.\scripts\verify_setup.ps1
```
**모든 항목 ✅** 확인 후 Claude Code 세션 시작.

### 2-5. Claude Code 세션 시작
- 레포 루트(`E:/BurningTimes`)에서 단일 PM 세션 시작 (C24 단일 세션 운용 원칙)
- SessionStart hook 체인 자동 실행:
  - git 최신 동기화 상태 확인
  - 매니페스트 상태 표시
  - 최근 feedback 요지 주입
  - inbox·PD 지시 로그 경로 감사
  - Live 세션 로드 (burningtimes-live 경유 C34 증분)

### 2-6. Unity MCP 환경 셋업 (**BT3 2026-04-22 완결 · 필수 추가**)

BT는 Unity MCP (CoplayDev MCP for Unity) 기반으로 Unity Editor 조작을 수행한다. **신규 PC에서 Unity MCP 사용 전 필수 설치**:

1. **uv 설치**: `winget install --id=astral-sh.uv -e` → 터미널 재시작
2. **uvx 수동 사전 워밍업** (필수 — pywin32 캐시 락 회피):
   ```powershell
   & "<uvx.exe 경로>" --from mcpforunityserver mcp-for-unity --help
   ```
   3~5분 소요. uvx 경로는 `Get-Command uvx | Select-Object Source`
3. **Unity Editor + MCP for Unity Package 설치**:
   - Unity Hub → EerieVillage 프로젝트 열기
   - Package Manager → + → "Install package from git URL..." → `https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main`
4. **MCP for Unity 창 설정** (Unity 상단 메뉴 → Window → MCP for Unity):
   - Transport: **stdio** (HTTP Local 아님)
   - "Start Server" 클릭
   - Client: **Claude Desktop** 선택
   - "Configure" 클릭 → `claude_desktop_config.json` 자동 생성
5. **Claude Desktop 완전 재시작** (트레이 아이콘 우클릭 → Quit → 재실행)
6. 검증: Claude에게 "Unity Console 로그 읽어줘" 요청 → `mcp__unityMCP__read_console` 실수신 확인

**상세 가이드**: `공유/개발팀_자산/Unity_MCP_연동_가이드_v1.md` (v2 개정본)
**조직공지 표준**: `공유/조직공지/2026-04-22_Unity_MCP_연동_표준_워크플로우_v2.md`
**트러블슈팅**: `memory/org/feedback_mcp_setup_pitfalls.md` (함정 5종 재발 방지 SOT)
**시행착오 근거**: `공유/조직자산/시행착오_아카이브/개발_MCP연동_v1.md` (7단계 타임라인)

## 3. Discord 웹훅 (PC 독립 · Gitea 서버측)

- **등록 위치**: Gitea UI `https://burning.i234.me/NerdNavis_AiDev/BurningTimesAi/settings/hooks`
- **이벤트**: Push
- **실증**: 2026-04-21 `8ff5a1f` push로 알림 수신 확인 (PD님 직접 검증)
- **PC 독립성**: 서버측 설정이라 어느 PC에서 push해도 동일 Discord 채널로 알림

## 4. 보류 안건 (Phase 3 — EerieVillage 착수 시점)

PD님 결정 6번에 따라 별도 세션·별도 Phase로 진입:

1. 서버 아키텍처·보안 체계 선택 (이전 Critical 3건 해소 방안)
2. BT.Framework Tier 2·3 진입 경계
3. Unity MCP 편집 표준 워크플로우 v2
4. 조선·퇴마 세계관 SOT·glossary·톤앤매너 기준선
5. 2D 플랫포머 모바일 UX 초기 설계
6. Prove-2-of-3·덱빌딩 메카닉 이식 가능성 검토
7. 어뷰징 판정 경계값 재평가

## 5. 조직 자산 참조 경로

### 필독 자산 (세션 시작 시 자동 로드)
- `CLAUDE.md` — 조직 최상위 지침
- `.claude/skills/BurningTimes-코어룰/SKILL.md` — 헌법 제1원칙·C1~C37·P1~P31 단일 SOT
- `memory/org/MEMORY.md` — feedback 인덱스

### 시행착오 아카이브 (이전 프로젝트 교훈, 14종)
`공유/조직자산/시행착오_아카이브/`
- `총괄_pm_general_v1.md` · `개발_팀장·서버팀장·클라이언트팀장_v1.md` · `기획_팀장·system·content·level·narrative·balance·ux_designer_v1.md` · `감사_pm·dev·plan_auditor_v1.md`

### 폐기·방향전환 아카이브
- `공유/조직공지/폐기_규칙_아카이브.md` — C·P 폐기 이력 (P17 2026-04-21 폐기 포함)
- `공유/조직공지/방향전환_히스토리_아카이브.md` — 설계 방향 전환 이력

## 6. PD님 지시 로그 상태

| 로그 | 활성 | 완료 아카이브 |
|------|------|-------------|
| 개발팀 | **없음** (BT1·BT2·BT3 전수 완료 이동) | BT1·BT2·BT3 |
| 기획팀 | **없음** (BT1·BT2 전수 완료 이동) | BT1·BT2 |

**Phase 3 EerieVillage 착수 지시 수령 시 신규 항목 등록 예정.**

## 7. 세션 인계 체크리스트 (다른 PC PM 세션 시작 시)

- [ ] `git pull origin main` 실행 → `5a161fc` 이상 HEAD 확인
- [ ] `paths.local.json` 생성 (template 복사 + 실값 입력 · `UNITY_PROJECT_ROOT`·`DISCORD_WEBHOOK` 필수)
- [ ] setup 스크립트 실행 (`setup_windows.ps1` 또는 `setup_macos.sh`) → unity-mcp 자동 clone 포함
- [ ] `verify_setup.ps1` 통과
- [ ] **Unity MCP 셋업 (§2-6)** — uv 설치·수동 워밍업·Unity Package·Configure·Claude Desktop 재시작
- [ ] 본 인계서 Read → 조직 현 상태 인지
- [ ] `CLAUDE.md` + `.claude/skills/BurningTimes-코어룰/SKILL.md` + `MEMORY.md` 로드 확인
- [ ] `공유/조직자산/시행착오_아카이브/` 관련 영역 Read (BT 착수 시점 필수)
- [ ] `공유/조직공지/2026-04-22_Unity_MCP_연동_표준_워크플로우_v2.md` Read (MCP 표준 7규범)
- [ ] `memory/org/feedback_mcp_setup_pitfalls.md` Read (재발 방지 함정 5종)
- [ ] PD 지시 로그 활성 항목 확인 (현재 0건)
- [ ] Phase 3 착수 시 PD님 지시 수령 후 신규 PD 지시 로그 항목 등록

---

## 인계서 상태

- **최종 수정**: 2026-04-21
- **생성 근거**: PD님 2026-04-21 "다른 PC에서 이어할 수 있도록 빠짐없이 공유" 지시
- **영구 보존**: 본 인계서는 조직 역사 기록 성격. 차기 조직 전환·분리 시 참고 템플릿