chore(BT·인계서): BT3 Unity MCP·조직 자산 축적 반영 (최종 세션 공유)
PD님 "다른 PC 이어받기 세션 공유 검증" 요청 이행. ## 보강 내역 - tag 체계: 5a161fc까지 최신화 (잔존정리·인계서·BT3 셋업·권한·자산 축적 5 commit 추가) - §2-6 Unity MCP 환경 셋업 (uv·워밍업·Package·Configure·재시작·검증) 6단계 신설 - §6 PD 지시 로그 상태: BT3 완료 반영, 활성 0건 명시 - §7 체크리스트: HEAD5a161fc이상·Unity MCP §2-6·조직공지·feedback SOT Read 항목 추가 ## 검증 완료 - 원격 main HEAD = 로컬 HEAD =5a161fc일치 - 활성 매니페스트 0건 (post-commit hook 정상) - .live/ 깨끗 (marker·README만) ## 결과 다른 PC에서 git pull + 본 인계서 Read만으로 Unity MCP 환경까지 완전 복원 가능 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
5a161fc8b2
commit
b5786dfa76
|
|
@ -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 <tag>:<path>` 역사 조회 가능.
|
||||
|
||||
**현재 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
|
||||
& "<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`
|
||||
|
|
@ -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 지시 로그 항목 등록
|
||||
|
||||
---
|
||||
|
|
|
|||
Loading…
Reference in New Issue