diff --git a/공유/조직공지/2026-04-21_BT_조직_출범_인계서.md b/공유/조직공지/2026-04-21_BT_조직_출범_인계서.md index ae4a614..5632ee9 100644 --- a/공유/조직공지/2026-04-21_BT_조직_출범_인계서.md +++ b/공유/조직공지/2026-04-21_BT_조직_출범_인계서.md @@ -23,10 +23,16 @@ | `phase-2a-complete` | `5d5b1dd` | Skill/Framework rename + 조직명 치환 | | `phase-2b-complete` | `44f7fb1` | 전 14개 에이전트 시행착오 아카이브 | | `phase-2c-complete` | `616e3d3` | 삭제 + 추상화 + 재압축 | -| (최신 main) | `8ff5a1f`+ | 잔존 최종 정리 + 세션 인계서 | +| 잔존 정리 | `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 :` 역사 조회 가능. +**현재 main HEAD**: `5a161fc` (본 인계서 갱신 기준) + ## 2. 다른 PC에서 이어 작업하는 절차 (필수 5단계) ### 2-1. BT 레포 clone·pull @@ -78,6 +84,32 @@ bash setup/setup_macos.sh - 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 + & "" --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` @@ -116,18 +148,24 @@ PD님 결정 6번에 따라 별도 세션·별도 Phase로 진입: | 로그 | 활성 | 완료 아카이브 | |------|------|-------------| -| 개발팀 | BT1·BT2 (Phase 2-C 완결 시 `완료` 전환) | 초기화 상태 (이전 조직 57건 삭제) | -| 기획팀 | BT1·BT2 (동일) | 초기화 상태 (이전 조직 40건 삭제) | +| 개발팀 | **없음** (BT1·BT2·BT3 전수 완료 이동) | BT1·BT2·BT3 | +| 기획팀 | **없음** (BT1·BT2 전수 완료 이동) | BT1·BT2 | + +**Phase 3 EerieVillage 착수 지시 수령 시 신규 항목 등록 예정.** ## 7. 세션 인계 체크리스트 (다른 PC PM 세션 시작 시) -- [ ] `git pull origin main` 실행 → `8ff5a1f` 이상 HEAD 확인 -- [ ] `paths.local.json` 생성 (template 복사 + 실값 입력) -- [ ] setup 스크립트 실행 + `verify_setup.ps1` 통과 +- [ ] `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 착수 시점 필수) -- [ ] PD 지시 로그 활성 항목 확인 (BT1·BT2 상태) +- [ ] `공유/조직공지/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 지시 로그 항목 등록 ---